Skip to main content
Open an agent by clicking it on the board. The panel on the right is where everything about it lives. Most of what this page covers is in the Settings and Capabilities tabs. Some tabs only appear once you switch on Expert mode at the bottom of the panel rail. That is where Capabilities, MCP, Memories and Logs live.

The soul

The soul is the agent system prompt. It is the single most important field: it defines who the agent is, what it owns, how it works and what it must never do. Edit it in Settings, under Soul (system prompt). It is markdown, so headings and lists are fine. A soul that works usually says:
  • who the agent is and what job it holds
  • what it is responsible for, and what it must hand to someone else
  • how it should behave: tone, level of detail, when to ask before acting
  • the rules that are not negotiable
You do not have to write it yourself. An agent created from a description writes its own, and you can ask it to rewrite it later.

Model and provider

Click the model name above the message box to change it. The picker has three sections.
Rerun runs a hosted model paid from the model credit included in your plan. No setup, no key.
Each model shows a power rating and its context window, so you can trade cost against capability without knowing the model names by heart. Picking a model from the chat changes it for that conversation only. Click Set as default to change it for the agent.

Capabilities

An agent has families of tools, all switched on by default. Turn off what it has no business doing. See Human in the loop for the last four.

Self-improvement

Separate from the capability list, and worth a deliberate decision. All of these are on by default. An agent that must stay exactly as you wrote it needs allowSoulEdit and allowToolInstall off.

Other settings

Temperature controls how much the model varies its answers. Leave it alone unless you have a reason. Step limit caps how many tool-calling steps one run may take. It is the guard against an agent looping on a task it cannot finish. There is no wall-clock timeout on a run, so this is the limit that matters. Enabled switches the agent off without deleting it. A switched-off agent runs nothing and refuses calls from other agents.

Name and handle

The name is free text and only affects what you see. The handle is the key other agents use to call it with @handle. Renaming an agent does not move its handle, on purpose: a handle written into another agent prompt would silently stop resolving. Change the handle only when you mean to, and update whatever references it.

Doing it from the API

Everything on this page is reachable with create_agent and update_agent, which is the fastest way to version an agent setup or repeat it across workspaces.