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
Model and provider
Click the model name above the message box to change it. The picker has three sections.- Free
- Subscription
- API key
Rerun runs a hosted model paid from the model credit included in your plan. No setup, no key.
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 withcreate_agent and update_agent, which is the fastest way to version an agent setup or repeat it across workspaces.