Building an agent

The agent builder at /admin/agents/{slug}/edit is where you shape an agent's identity, instructions, and tools. It works the same way for catalog agents and custom agents, with one difference: catalog agents have a fixed identity — you can only edit Instructions and Tools. Custom agents are fully editable.

The editor shell

The editor contains three collapsible sections:

• Identity & model — display name, icon, color, description, and model. See Identity and model.
• Instructions — the prompt that defines the agent's role and behavior. See Instructions.
• Tools — what the agent can call: built-in, internal, Composio, and MCP. See Tools and integrations.

The test panel

A test panel slides in from the right edge of the editor. It runs prompts against the current draft without publishing. Conversations in the test panel don't appear in members' chat histories and don't affect analytics. Use it to validate behavior changes before you publish. Full details: Testing an agent.

Draft and publish

Every save creates or updates the draft. Members keep seeing the published version until you publish. Publish snapshots the draft into a new version; triggers and members switch to it immediately.

Version history opens a dialog that lists every published version. From there you can restore any earlier version as a draft or publish it directly. Full details: Versions and publishing.

The activity log

The activity log slides out from the top-right corner of the editor. It lists every draft save, publish, restore, reset, and — for custom agents — identity change. Each row shows the actor, timestamp, and what changed.

What's next?