VoiceAgent Expert Mode | CloudTalk Help Center

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	`agentName`	The VoiceAgent's display name
Direction	`direction`	Whether the agent handles inbound or outbound calls. Accepted values: `"inbound"` or `"outbound"`.
Language	`language`	The language the VoiceAgent speaks
Additional languages	`secondaryLanguages`	Additional languages the VoiceAgent can detect and switch to during a call. Optional.
Voice	`voice`	The voice used by the VoiceAgent
Greeting	`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	`knowledgeBaseIds`	Knowledge bases the VoiceAgent can draw on when answering questions

Behavior

Form tab label	JSON field	What it sets
Goal prompt	`goalPrompt`	The core instructions that define the VoiceAgent's behavior during a call
Skills	`skills`	Structured capabilities: Transfer to Human, Take a Message, Extract Information, Answer Questions, Appointment Booking
Scenarios	`scenarios`	How the VoiceAgent responds to specific situations, including ending calls
Guardrails	`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.

AI model

Field	What it sets
`llmOverride`	Pins a specific AI model instead of using automatic selection. See the list of supported models below.
`providerOverride`	Forces a specific speech provider (`"elevenlabs"` or `"deepgram"`). In most cases this does not need to be set manually, as the language determines the provider automatically.
`temperature`	Controls how varied the VoiceAgent's responses are. Accepts values from `0.0` to `1.0`. For professional or structured agents, a value between `0.1` and `0.3` is recommended. Required.

Supported models for llmOverride

Model	Value
GPT-4o Mini	`openai - gpt-4o-mini`
GPT-4o	`openai - gpt-4o`
GPT-4.1	`openai - gpt-4.1`
GPT-4.1 Mini	`openai - gpt-4.1-mini`
GPT-4.1 Nano	`openai - gpt-4.1-nano`
GPT-5	`openai - gpt-5`
GPT-5 Mini	`openai - gpt-5-mini`
GPT-5 Nano	`openai - gpt-5-nano`
GPT-5.1	`openai - gpt-5.1`
Claude 3 Haiku	`anthropic - claude-3-haiku`
Claude Haiku 4.5	`anthropic - claude-haiku-4-5`
Claude 3.7 Sonnet	`anthropic - claude-3-7-sonnet`
Gemini 2.0 Flash Lite	`google - gemini-2.0-flash-lite`
Gemini 1.5 Pro	`google - gemini-1.5-pro`

Voice tuning

Field	What it sets	Values
`stability`	Controls how consistent the VoiceAgent's voice sounds throughout the call. Higher values produce a more stable voice.	`0.0`–`1.0`. Required.
`similarity`	Controls how closely the voice matches the original voice model.	`0.0`–`1.0`. Required.
`optimizeStreamingLatency`	Trades voice quality for lower response latency. Higher values reduce latency but may affect quality. Do not set this to `4` as it disables text normalisation, causing numbers and dates to be mispronounced.	`0`–`4`. Required.

Call behavior

Field	What it sets	Values
`maxCallDuration`	Sets a hard limit on call length in minutes.	Recommended: 3–5 for outbound, 15–30 for inbound. Required.
`dialTime`	How long the VoiceAgent waits for an answer on outbound calls before giving up.	`5`–`120` seconds. Optional.

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
`speculativeTurn`	The VoiceAgent begins composing its reply before the caller has finished speaking, reducing perceived response latency.	`true` / `false`
`turnEagerness`	Controls how readily the VoiceAgent takes its turn when the caller pauses.	`"patient"` / `"normal"` / `"eager"`
`turnModel`	Sets the version of the turn-detection model used.	`"turn_v2"` / `"turn_v3"`
`vad`	Filters out background noise so it does not trigger an unintended response.	`true` / `false`
`asrKeywords`	Words or phrases to prioritize in speech recognition. Useful for product names or technical terminology.	List of strings

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.

Need help or have a question? Just reach out through our Support portal — we’re here for you.