Skip to main content
You can prepare a default voice and language-specific voice references in an agent draft. This is useful when different languages need different saved voices while retaining the same agent instructions.
The dashboard’s voice controls are unsaved previews, and voice publication is unavailable. Language-specific voice references do not establish multi-speaker output or voice switching during a live conversation.

Prepare voice references

You need a target branch and saved voices that your workspace can access. Start with List my voices and the current model catalog.
1

Choose the default pair

Set conversation_config.tts.model_id and conversation_config.tts.voice_id. Record the selected model, voice, and intended base language together.
2

Choose a voice for each additional language

In conversation_config.language_presets, use the language tag as the map key. A preset can set overrides.tts.voice_id to an accessible saved voice.The preset does not contain a replacement TTS model. Review each voice against the base TTS model and that language’s requirements.
3

Keep the wording consistent

Review each language’s first message and pronunciation requirements. A voice reference does not translate the prompt or establish that a voice supports every language.
4

Inspect the saved draft

Follow versions and drafts. Read the draft back to confirm the default voice and each language-specific reference. Do not use publication as a voice test while voice publication is gated.

Choose voices deliberately

Keep the selection small enough to review. For each voice, record the intended language, character of delivery, and a short sample script with names and numbers. These are preparation materials for later listening tests, not evidence that conversation switching is working. If a voice is inaccessible, check the active workspace and saved identifier before changing the rest of the configuration.

Frequently asked questions

This guide does not provide a released multi-speaker conversation feature. The documented settings are a default voice and language-specific voice references.
The language preset supports a voice ID override, not a model ID override. Choose voices compatible with the base model.