handbook_config is provided.How It Works
The Agent Handbook organizes presets into three categories:- Personality & Tone — Shape how the agent sounds and feels in conversation
- Accuracy & Format — Improve how the agent handles names, numbers, and data (voice agents only)
- Trust & Safety — Control transparency and scope of responses

In a conversation flow, the Agent Handbook button sits below the model selector.

Conversational Tone and Customer Support Tone each have their own switch.
Presets
Personality & Tone
Conversational Tone and Customer Support Tone are independent toggles, not a single either/or choice. Turn on whichever fits your agent, or neither.Conversational Tone (~1,000 tokens)
Conversational Tone (~1,000 tokens)
Customer Support Tone (~480 tokens)
Customer Support Tone (~480 tokens)
Natural Filler Words (~170 tokens)
Natural Filler Words (~170 tokens)
High Empathy (~70 tokens)
High Empathy (~70 tokens)
Accuracy & Format
Echo Verification (~125 tokens)
Echo Verification (~125 tokens)
NATO Phonetic Alphabet (~190 tokens)
NATO Phonetic Alphabet (~190 tokens)
Speech Normalization (~660 tokens)
Speech Normalization (~660 tokens)
Smart Matching (~110 tokens)
Smart Matching (~110 tokens)
Trust & Safety
AI Disclosure When Asked (~30 tokens)
AI Disclosure When Asked (~30 tokens)
Scope Boundaries (~70 tokens)
Scope Boundaries (~70 tokens)
Customize a preset’s prompt
Every preset ships with a Retell-written prompt, and you can replace it with your own wording from the dashboard. Expand View prompt on any enabled preset to see its text, edit it in place, and save with the panel’s Save button. A Customized tag marks each preset you’ve edited, and the count of customized presets appears next to the Agent Handbook button.- A custom prompt can be up to 10,000 characters. The character count shows under the text box, and Save is blocked until you’re within the limit.
- Select Reset to default to drop your wording and go back to the Retell default text.
- A preset must be on before you can edit its prompt. Turning a preset off keeps your saved wording for the next time you turn it on.
Token Cost Summary
FAQ
Can I customize the content of a preset?
Can I customize the content of a preset?
custom_prompt on any preset inside an agent’s handbook_config to replace its built-in text with your own, up to 10,000 characters:custom_prompt both enables the preset and uses your wording. Omit it or pass null to use the Retell-provided prompt. An empty string enables the handbook but intentionally injects no prompt text.You can retrieve the Retell-provided prompts through the handbook presets API to use as a starting point. For instructions unrelated to a preset, write them directly in your agent’s prompt. See the general prompting principles.Can I enable both tone presets?
Can I enable both tone presets?
Do handbook presets conflict with my custom prompt?
Do handbook presets conflict with my custom prompt?
Why aren't some presets available for my chat agent?
Why aren't some presets available for my chat agent?

