Editing the System Prompt
Published:
Overview
This guide explains how to access and edit the main system prompt for an AI Voice Agent. The system prompt is the core instruction set that controls how the agent behaves, what it says, and when it executes actions such as transfers or API calls.
Steps to Edit the System Prompt
- Navigate to Call Flows and locate the agent you want to edit.
- Click into the agent to open the editor.
- The system prompt is displayed in the main editor panel.
- To expand the editor to full screen, click the expand icon.
- Make any required edits to the prompt.
- To preview the prompt structure visually, switch to the Visualiser view — this shows how each section of the call links together and when different parts of the prompt are triggered.
- Once edits are complete, click Save to Draft to test before going live, or Publish to Production to apply immediately.
Key Notes
| Item | Details |
|---|---|
| Prompt Language | System prompts are written in Markdown — be careful when editing formatting, hashes, or structural annotations |
| @goto Nodes | The prompt uses a node-based structure to control call flow — sections are linked using @goto references that dictate when the agent moves between steps |
| Executions | Transfers, API calls, and other actions are triggered from within the prompt based on the conditions defined |
| Visualiser | Use the Visualiser view to see how prompt sections connect — useful for understanding complex call flows |
| Version History | If you make a mistake, use the prompt history to review and revert to a previous version |
| Safe Editing | Always save to draft and test before publishing, especially if the agent is live with active phone numbers |
