This article explains how to use Expert Mode to view, edit, and import your VoiceAgent's full configuration through the Advanced tab.
User level: Admin
Expert Mode gives you direct access to your VoiceAgent's full configuration as a JSON file. It unlocks the Advanced tab in VoiceAgent settings, where you can view, edit, and import configurations with access to fields and fine-tuning options that are not available in the Form tab.
What you can do with Expert Mode
Expert Mode is useful when you need to update a setting that is not available in the Form tab, such as switching to a specific AI model, adjusting voice behavior, or fine-tuning call handling. You open the Advanced tab, locate the relevant field, update the value, and save.
How Expert Mode relates to the Form tab
The Form tab and the Advanced tab display the same configuration in two different ways. Any setting you configure in the Form tab is also present in the JSON, and changes made in one tab are reflected in the other.
Expert Mode extends what the Form tab offers. The Advanced tab exposes additional fields for fine-tuning AI model behavior, voice quality, and call handling that do not appear in the Form tab.
Fields available in both tabs
The following fields can be configured in either the Form tab or the Advanced tab.
Personality
Form tab label | JSON field | What it sets |
Name |
| The VoiceAgent's display name |
Direction |
| Whether the agent handles inbound or outbound calls. Accepted values: |
Language |
| The language the VoiceAgent speaks |
Additional languages |
| Additional languages the VoiceAgent can detect and switch to during a call. Optional. |
Voice |
| The voice used by the VoiceAgent |
Greeting |
| The exact opening line the VoiceAgent says at the start of a call. If left empty, inbound agents fall back to a generic default; outbound agents open with silence. |
Knowledge Sources
Form tab label | JSON field | What it sets |
Knowledge bases |
| Knowledge bases the VoiceAgent can draw on when answering questions |
Behavior
Form tab label | JSON field | What it sets |
Goal prompt |
| The core instructions that define the VoiceAgent's behavior during a call |
Skills |
| Structured capabilities: Transfer to Human, Take a Message, Extract Information, Answer Questions, Appointment Booking |
Scenarios |
| How the VoiceAgent responds to specific situations, including ending calls |
Guardrails |
| Fixed responses for situations that require a consistent answer regardless of context |
Expert-only fields
The following fields are only accessible through the Advanced tab.
Conversation style
These two fields control how the VoiceAgent speaks. They are optional: if you don't set them, CloudTalk applies defaults that match the VoiceAgent's existing behavior. After your next save, both fields appear in the JSON automatically with their default values. This is expected.
Field | What it sets | Values |
| How the VoiceAgent sounds. A list of style presets; they can be combined, but one or two work best (each additional preset dilutes the others). Order doesn't matter, duplicates are removed automatically, free-text values are not accepted. |
Optional; default |
| How much the VoiceAgent says per reply. |
|
Tone preset guide:
Preset | Effect |
| Measured, precise, and respectful |
| Warm and personable |
| Relaxed and informal, like a helpful colleague |
| Steady, unhurried, and patient |
| Acknowledges the caller's feelings before moving to solutions |
| Leads with the answer and keeps pleasantries to a minimum |
Regardless of tone and verbosity, the VoiceAgent always stays brief during operational moments: confirmations, read-backs, farewells, and transfer or booking steps.
Setting an unsupported value shows a validation message listing the allowed values and the configuration isn't saved.
AI model
Field | What it sets |
| Pins a specific AI model instead of using automatic selection. See the list of supported models below. |
| Forces a specific speech provider ( |
| Controls how varied the VoiceAgent's responses are. Accepts values from |
Supported models for llmOverride
Model | Value |
GPT-4o Mini |
|
GPT-4o |
|
GPT-4.1 |
|
GPT-4.1 Mini |
|
GPT-4.1 Nano |
|
GPT-5 |
|
GPT-5 Mini |
|
GPT-5 Nano |
|
GPT-5.1 |
|
Claude 3 Haiku |
|
Claude Haiku 4.5 |
|
Claude 3.7 Sonnet |
|
Gemini 2.0 Flash Lite |
|
Gemini 1.5 Pro |
|
Voice tuning
Field | What it sets | Values |
| Controls how consistent the VoiceAgent's voice sounds throughout the call. Higher values produce a more stable voice. |
|
| Controls how closely the voice matches the original voice model. |
|
| Trades voice quality for lower response latency. Higher values reduce latency but may affect quality. Do not set this to |
|
Call behavior
Field | What it sets | Values |
| Sets a hard limit on call length in minutes. | Recommended: 3–5 for outbound, 15–30 for inbound. Required. |
| How long the VoiceAgent waits for an answer on outbound calls before giving up. |
|
Advanced ElevenLabs tuning
These settings apply only when your VoiceAgent uses ElevenLabs, which is the default for most language configurations.
Field | What it sets | Values |
| The VoiceAgent begins composing its reply before the caller has finished speaking, reducing perceived response latency. |
|
| Controls how readily the VoiceAgent takes its turn when the caller pauses. |
|
| Sets the version of the turn-detection model used. |
|
| Filters out background noise so it does not trigger an unintended response. |
|
| Words or phrases to prioritize in speech recognition. Useful for product names or technical terminology. | List of strings |
| Short caller acknowledgements (e.g. agreement sounds) that should not count as an interruption, so the VoiceAgent keeps talking through them. Written in the caller's language. | List of strings. Optional. |
| The languages the ignore terms are matched in. | List of language codes. Optional. |
| Plays an ambient sound bed under the VoiceAgent's speech. | Object: |
In the Advanced tab, these fields must be placed inside an elevenLabsSettings object. They do not go at the root level of the configuration. Here is an example showing how to nest them:
{
"agentName": "Clinic Reception",
"direction": "inbound",
"language": "es",
"temperature": 0.2,
"elevenLabsSettings": {
"speculativeTurn": true,
"turnEagerness": "patient",
"turnModel": "turn_v3",
"vad": true,
"asrKeywords": ["Capil Clinic", "injerto capilar", "Barcelona"],
"interruptionIgnoreTerms": ["vale", "sí", "ajá"],
"interruptionIgnoreTermLanguages": ["es"],
"backgroundSound": {
"preset": "office",
"volume": 0.3,
"crossfadeLoop": true
}
}
}
When a saved configuration includes elevenLabsSettings, the sent object replaces the stored one. To clear a single sub-field, omit it from the sent object. Omitting elevenLabsSettings entirely keeps the stored settings.
These fields must be placed inside elevenLabsSettings; at the root level they are not recognized and the save fails with a validation error.
Importing and exporting configurations
You can export a configuration from the Advanced tab and import it into a different VoiceAgent, or share it with another user to import into their account.
Most configurations import immediately with no additional setup required. The exception is when a configuration references resources specific to your account, such as a knowledge base, a custom tool, a phone number, or a calendar integration. These connections need to be set up manually after importing.
After any successful import, save the VoiceAgent twice. A known set of edge cases only appears after the second save.
Exported configurations now include tone and verbosity. If an imported configuration contains an unsupported value for these (or any other) fields, the import is rejected with a message naming the field and the allowed values.
Need help or have a question? Just reach out through our Support portal — we’re here for you.