Change an AI agent's greeting or prompt
agent_updateChanges what a live AI voice agent says: its greeting (the first line it speaks), its system prompt (its instructions), or, on realtime agents, its welcome_instruction (how it opens the call). Tools, transfers, voice, language, webhooks and audio settings cannot be changed here; they are edited in the portal. The change applies from the next call. With dryRun: true it returns the exact before and after of every setting that would change, plus a baseVersion, and changes nothing. With dryRun: false and that baseVersion it applies the change; it is refused if the agent changed since the preview, or if anything other than the named fields would change.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"agent_id": "<agent_id>"
},
"name": "agent_update"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dryRun | No | If true, return the exact diff without changing the agent | |
| agent_id | Yes | The agent's id | |
| baseVersion | No | Required to apply: the baseVersion from this tool's dryRun preview | |
| system_prompt | No | The agent's full instructions. Replaces the current prompt in full | |
| greeting_message | No | The exact first line the agent speaks on every call | |
| welcome_instruction | No | Realtime agents only: an instruction for how to open the call |