Edit an agent

Purpose

A few weeks in, Kian notices that the support assistant is wordier than a chat needs. Open the agent's editor to change its identity, instructions, model and every other setting, and check the result in the live preview before you save.

Before you start

You can edit custom agents belonging to your current workspace if you have permission to manage agents.

Steps

1. Open "Agents", find the agent under "My agents" and select it. In the window, open "Agent actions" (the three dots) and choose "Edit agent". The editor lists 15 sections under "Configure agent". Select one to open it, and use "Agent settings" at the top of a section to return to the list.
2. "Identity" and "Instructions": change the name, description, image, creator website, starters, capabilities, category, publishing and "Agent instructions". See "Create a custom agent" for the limits.
3. "Model": choose the "Primary model". "Reasoning effort" appears only for models that support it (the choices are "Model default" and the levels the model offers); choosing a model that does not support the current effort clears it. Set "Maximum output tokens" (64 to 32,768) and "Temperature" (0 to 2, in steps of 0.1). Retries, fallback models and the model call limit are also here, described in "Set agent execution limits".
4. "Voice" and "Vision": see "Choose voice and vision models for an agent".
5. "Memory", "Knowledge", "Structured output", "Guardrails", "Sub-agents", "Plugins", "Skills", "Channels", "Execution" and "Behavior" each have their own article.
6. Check the result in the live preview on the right, then select "Save". Your changes stay in the editor until you save. Leaving without saving discards them.

Expected result

The agent is updated and a chat with it opens. Later chats use the new settings. Existing chats are not rewritten.

The model's own limits still apply, so a high output setting does not guarantee a long answer.

Troubleshooting