Configuring agents (operator)

For whoever runs the box. Casual users just talk to the agents that already exist — this page is about defining them.

A fresh box ships with exactly one agent — Claude (sample) — a deliberately plain starter on the Claude runtime. It’s there so the box works out of the gate, but it’s yours to rename, restyle, or replace. The character of a box comes from the roster you build — a quick one for fast answers, a careful one for real work, each with its own name and voice. This is where you build it.

Where this lives

Settings → Agents in the web app. The list on the left is every agent on the box; click one to edit it, or New to add one. Changes are staged in a draft — nothing takes effect until you hit Save, and saves apply to new turns, not ones already running. There’s a Reset next to Save if you want to throw the draft away.

What an agent is made of

• Name — what people call it in chat, and what they type after @.
• Avatar — upload an image (PNG, JPEG, or WebP), or use a one- or two-letter initial on a color you pick.
• Engine (runtime) — the AI provider it runs on: Claude, Codex, Gemini, or Grok. The status dot next to the picker tells you at a glance whether that provider is connected; if it reads missing, the agent can’t run until you wire the provider up in Settings → Providers (see /operator/providers/).
• Voice — two parts working together. The personality is free text describing how the agent should talk (“warm, brief, no emoji”). The translator is the provider that rewrites the raw engine output into that voice — leave it on System default, set it to Same as execution provider, or pick a specific one. A built-in Voice preview lets you paste a sample reply and see how this agent would phrase it before you save.

Personality shapes how an agent speaks, never what it can do — that comes from the engine and the tools the box already grants every agent.

The everyday tasks

• Add — New, then fill in name, avatar, engine, and a personality. Adding stages it; Save persists it.
• Edit — click an agent to change any of the above.
• Reorder — drag the grip handle, or use the up/down arrows, to set the order agents appear in the picker.
• Set the default — star an agent to make it the pre-selected one in new conversations.
• Delete — remove one you don’t want.

Staying in control

A box always keeps at least one working agent, so the UI guards a couple of things for you. You can’t delete your last agent, and you can’t delete the default without first starring a different agent to take its place. And because everything is a draft until you Save, you can experiment freely — reorder, retune a voice, preview it — then walk away with Reset if you don’t like it. Nothing reaches the people using the box until you commit.

What to read next

• Connecting the providers agents run on → /operator/providers/
• How people pick and address agents → ../talking-to-agents.md