Creating agents

Create a custom agent for your org — name, icon, model, then open the builder.

Admins only. Members can run and observe; only admins can edit.

Every org gets the 4 catalog agents out of the box. Admins can also create up to 20 custom agents tailored to roles the catalog doesn't cover.

Where it lives

The admin agents page is at /admin/agents. The table lists catalog agents (enable/disable only) and custom agents (full edit + delete). The footer shows N / 20 custom agents.

Create a custom agent

Open the admin agents page

Navigate to /admin/agents. Click + New agent.

Enter a display name (required, unique within your org), then choose an icon, color, short description, and model. The model picker lists every supported model — pick based on your cost and quality requirements. You can change all of these later.

Open the editor

Clicking Create drops you on /admin/agents/{slug}/edit with three sections: Identity & model, Instructions, and Tools.

Fill in Instructions

Write the prompt that defines the agent's role. See Instructions.

Add tools

Connect internal tools, Composio actions, MCP servers, or built-ins. See Tools and integrations (builder).

Test in the side panel

The agent test panel runs prompts against the current draft. See Testing an agent.

Publish

Make the agent available to your org. See Versions and publishing.

The 20-agent cap

Once your org hits 20 live or draft custom agents, + New agent is disabled. Delete or archive an existing custom agent to free a slot.

Deleting a custom agent

Deleting requires you to type the agent's display name to confirm. This removes the agent and its configuration permanently. Catalog agents cannot be deleted — only disabled.