> ## Documentation Index
> Fetch the complete documentation index at: https://docs.poly.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Use more than one voice

> Assign multiple voices to simulate a team of agents.

Use multi-voice when you want callers to hear different voices across interactions – simulating a team of agents or varying the experience for repeat callers. You can configure this through the UI or programmatically in Python.

![multi-voice-ui](https://mintcdn.com/polyai/Qu880HppNqT19Eyr/images/voice/multi-voice-ui.png?fit=max\&auto=format\&n=Qu880HppNqT19Eyr\&q=85\&s=5c03e358e04612d53626fe0f09fb30fa)

> [tab] Add voices
>
> Click **New voice** to add additional voices to your agent. You can select from the available languages, genders, and styles or [add a new voice](https://docs.poly.ai/voice-channel/add-a-new-voice.md).
>
> Once added, all voices will appear in the list and can be configured independently.
>
> ![multi-voice-add-voice](https://mintcdn.com/polyai/Qu880HppNqT19Eyr/images/voice/multi-voice-add-voice.png?fit=max\&auto=format\&n=Qu880HppNqT19Eyr\&q=85\&s=be50609237086e92d6cc822ccd7040f1)

> [tab] Adjust weights
>
> After adding multiple voices, use the weight sliders to define how frequently each voice is selected during conversations. All weights must add up to 100%.
>
> For example:
>
> * 80% main voice
> * 10% each for two alternates
>
>   ![multi-voice-configure](https://mintcdn.com/polyai/Qu880HppNqT19Eyr/images/voice/multi-voice-configure.png?fit=max\&auto=format\&n=Qu880HppNqT19Eyr\&q=85\&s=70e45a4d232b09b634f483f4267979c1)

> [tab] Configure settings
>
> For each voice, you can fine-tune the advanced settings:
>
> * **Stability (%):** Control how consistent the voice sounds across generations.
> * **Clarity and Similarity (%):** Balance naturalness and similarity to the target voice.
>
>   ![multi-voice-settings](https://mintcdn.com/polyai/Qu880HppNqT19Eyr/images/voice/multi-voice-configure.png?fit=max\&auto=format\&n=Qu880HppNqT19Eyr\&q=85\&s=70e45a4d232b09b634f483f4267979c1)

## Using Python in a code field

You can configure this in any function, though this guide assumes you're using the [start function](https://docs.poly.ai/tools/start-tool.md).

To use multiple voices, you need their voice IDs from your chosen TTS provider. Refer to the [function TTS provider configuration](https://docs.poly.ai/tools/classes.md) for full details on supported providers and their configuration options.

Here is an example of how to configure multiple voices, where the agent is randomly assigned a voice at the start of each interaction:

```python theme={"theme":{"light":"github-light","dark":"github-dark"}}
def start_function(conv: Conversation):
    conv.randomize_voice([
        VoiceWeighting(
            voice=ElevenLabsVoice(
                voice_id="LcfCDJNUPlGQjkzn1xUU",
                similarity_boost=0.2,
                stability=0.4
            ),
            weight=0.5
        ),
        VoiceWeighting(
            voice=RimeVoice(
                provider_voice_id="s3://path-to-manifest.json",
                style="neutral"
            ),
            weight=0.5
        )
    ])
```

* `conv.randomize_voice([...])`: Selects a voice at random based on the assigned weights.
* `VoiceWeighting`: Associates a voice with a probability of being selected.
* **Weights** define selection probability:
  * The sum of all weights must equal 1.0.

## Understanding voice weights

You can add a maximum of **ten voices** to an AI agent.

> [!NOTE]
>
> In the UI, weights are displayed as percentages (must total 100%). In code, weights are decimal values (must total 1.0).

The `weight` parameter determines how often each voice is selected. The sum of all weights must equal **1.0** (or 100% in the UI).

Examples:

* One voice at `1.0`: Always uses that voice.
* Two voices at `0.5` each: Each is selected 50% of the time.
* Four voices at `0.25` each.

## Personalizing repeat caller experiences

Assigning different voices to repeat callers can help create a sense of interacting with different team members, which may reduce escalation requests. Use the `conv.randomize_voice()` method in your [start function](https://docs.poly.ai/tools/start-tool.md) to vary voice selection across interactions.

## Related pages

> [card] [Voice library](https://docs.poly.ai/voice-channel/voice-library.md)
>
> Browse and select voices

> [card] [Choosing a good voice](https://docs.poly.ai/voice-channel/choosing-a-good-voice.md)
>
> Guidelines for voice selection and matching

> [card] [Add a voice](https://docs.poly.ai/voice-channel/add-a-new-voice.md)
>
> Configure custom voices programmatically

> [card] [Agent Voice](https://docs.poly.ai/voice-channel/agent.md)
>
> Configure voice settings and fine-tuning
