Create an Agent

Creating an agent takes ten steps covering both halves of an agent: the configuration that shapes its behavior, and the deployment that runs it as a service.

Create your context first. Policies, routines, glossaries, and prompts are built on their own pages and attached here by reference, so anything that does not exist yet will not appear in the pickers. The system prompt is the exception, since you can write it inline.

1

Identity

Names the agent, picks the runtime version its configuration targets, and sets the language it replies in. Leave Agent version at the default unless you have a reason to pin an older one.

2

System Prompt

Defines the agent's role and behavior. Write it here and the platform saves it as a reusable project prompt, or bind to an existing prompt at the exact version you pick.

3

Context

Attaches the policies, glossaries, and routines the agent follows, and sets how they resolve against each other. Priorities decides which item wins when two disagree, and Re-evaluate routines after handles the case where a routine's activation depends on a tool result.

4

Extra Rules

Sets how the agent opens a conversation and what it says while tools are running. Optional as a whole, and the greeting is approximated and adapted to the user's language rather than repeated word for word.

5

Connections

Wires the agent to its model and to everything outside it: the primary and fallback models, a separate model for the engine's internal retry loop, a grounding source for retrieval, a session store, and its MCP servers. With no session store attached, state lives in memory and is lost when the agent restarts.

6

Advanced

Tunes the engine, tags this agent's traces for Observability, and registers inbound webhooks. The defaults are sound. Webhooks are verified with HMAC and dispatch only to autonomous routines attached to this agent.

7

Endpoint

Controls whether the agent is reachable from the internet or stays internal to the platform.

8

Runtime

Passes environment variables and project secrets to the running agent. Every key inside an attached secret arrives as an environment variable, and the Router API key the agent uses to bill model calls is generated when you deploy.

9

Schedule

Limits when the agent runs. Outside the uptime window it scales to zero.

10

Review & Deploy

Confirms everything before going live. Save draft keeps a pending version without touching anything deployed, and Deploy stays unavailable until every required field is filled.

Agents can also be created and managed from the command line. See the CLI documentation for iai agents.