Edit an agent’s system prompt
Change the instructions that tell the agent who it is, how it talks and what it may say.
Where to find it
AI agents › All agents › System prompt
Open this screen
Steps
- Open AI agents › All agents and click the agent.
- Scroll to System prompt.
- Change the text in Instructions.
- Press Save. Press Cancel instead to drop your changes.
- Press Open playground at the top of the agent’s page to try the new instructions.
Settings on this screen
| Setting | What it does | Default |
|---|---|---|
| Instructions | The agent’s system prompt. Calls and the Playground read it together with the agent’s knowledge base. | — |
| Agent voice | Opens the Agent voice page, where the same prompt sits beside the persona, the agent library and Build with AI. | — |
Troubleshooting
“The system prompt is too long. It can be up to 200,000 characters.”
Shorten the instructions. Long reference material belongs in the agent’s sources (Files, Text snippets, Website, Q&A).
“Fill in every [[GAP]] before saving.”
The text still holds a [[GAP]] mark from a draft written by AI. Replace each one with the real value, then save.
Tips
- Facts can be in the instructions or in the sources; the agent never states a fact that neither of them contains.
- The Playground’s Instructions (System prompt) box edits the same text.
Good to know
- Only managers can edit; everyone else sees the instructions read-only.
- The instructions cannot switch off the built-in call rules, such as answering only from your material and staying in the caller’s language.
Related how-tos
- All agents See every AI agent in your organisation, which phone lines each one answers, and open one to change it.
- Start an agent from the agent library Fill an agent’s prompt and persona from a ready-made phone persona for your type of business.
- Write an agent’s prompt with Build with AI Describe the agent you need, by typing or by voice, and get a draft persona and system prompt to review.
- Edit and translate instructions in the Playground Change the agent’s instructions while testing, translate them into the agent’s language, and save.
- How an AI agent answers on a call Know what an agent reads before each reply, and the rules it always follows.