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

# Voice, language and dialect

> Choose the agent's voice and how it sounds, see how language and dialect follow the voice, pick the speech recognition model, and switch dialect mid-call.

The voice decides how your agent sounds, and also which language and dialect it speaks. This page covers the voice settings, the speech recognition model that hears the caller, and the switcher that lets the agent change dialect during a call.

## Where to find it

> [tab] Single prompt agent
>
> In the editor's **Configuration** panel, open **Voice settings**. The **Language/dialect switcher** is in **Call settings**.

> [tab] Flow agent
>
> In the flow builder, click **Global settings** and open **Voice settings**. The **Language/dialect switcher** is in **Call settings**. A [Change agent settings step](https://docs.tryhamsa.com/agents/flow/steps/change-settings.md) can change the voice settings from that step on.

You need permission to read voices to see this section.

## Choose the voice

**1. Open the voice picker**

In **Voice settings**, click **Change** on the voice row. **Select agent voice** opens.

![Voice settings in the Configuration panel: the Noura voice with Change, the Expressiveness slider, Voice dictionaries and the STT model](https://mintcdn.com/hamsa-452fa79a/IyoYQ-nNrFRmlJOT/images/agents/settings/voice-settings-light.webp?fit=max\&auto=format\&n=IyoYQ-nNrFRmlJOT\&q=85\&s=a81eff3340003ad372b64375556eecd7)

**2. Narrow the list**

Under **Show**, pick **All**, **Favorites**, **In your agents** or **Project voices**. Search by name, or filter by **Dialect** and **Gender**. **Clear** resets the filters.

**3. Listen and pick**

Press play on a row to hear a sample. Click the voice to use it. The picker closes and the voice is set.

New agents start with Carla, an Arabic voice. To add your own voice from a recording, see [Add a voice](https://docs.tryhamsa.com/agents/voices/add-a-voice.md). For more on browsing voices, see [Choose a voice](https://docs.tryhamsa.com/agents/voices/choose-a-voice.md).

![Select agent voice with All selected and the Dialect filter open, grouping dialects under Gulf Arabic and Levantine Arabic with a voice count for each](https://mintcdn.com/hamsa-452fa79a/IyoYQ-nNrFRmlJOT/images/agents/settings/voice-picker-dialect-light.webp?fit=max\&auto=format\&n=IyoYQ-nNrFRmlJOT\&q=85\&s=4f497a8a4ea979c3ee4233be46871b7c)

## Language and dialect come from the voice

There is no separate language or dialect setting. Each voice has a dialect, and the agent takes its language and dialect from it:

* An Arabic voice makes the agent speak Arabic in that voice's dialect, for example Jordanian, Saudi or Egyptian. A Fusha voice speaks Modern Standard Arabic.
* An English voice makes the agent speak English.
* With the prompt enhancer on, Hamsa adds an instruction to the prompt such as "Always speak in Jordanian dialect of Arabic", so the model writes in the same dialect the voice speaks.
* With the enhancer on, the voice's gender is passed to the model too ("You are a female agent"), so Arabic replies use the right forms for the agent.

To change the dialect, pick a voice in that dialect. The **Agents list** shows each agent's dialect.

> [!WARNING]
>
> With **Prompt enhancer** set to **Disabled**, no dialect instruction is added. Say in your prompt which language and dialect to speak, or the model may reply in a different one from the voice.

## Voice settings reference

| Field | What it does | Default |
| - | - | - |
| Voice | The voice the agent speaks with, and its language and dialect. | Carla (Arabic) |
| **Expressiveness** | From **Stable** (0, a consistent sound) to **Expressive** (2, more emotional range), in steps of 0.1. | 1 |
| **STT model** | The speech recognition model that turns the caller's speech into text. See below. | **Hamsa-STT-S4** |
| **Voice dictionaries** | Pronunciation dictionaries applied to everything the agent says. | None |

There is no voice speed setting.

### Speech recognition model

| Option | When to use it |
| - | - |
| **Hamsa-STT-S4** (Default) | Most agents. The newest model, for Arabic and English callers. |
| **Hamsa-STT-S3** | The previous model, for Arabic and English callers. |
| **Hamsa-STT-English** | Agents whose callers speak English only. |

Agents that used the retired **Hamsa-STT-S2** now run on **Hamsa-STT-S4**.

![The STT model list open, with Hamsa-STT-S3 (Default), Hamsa-STT-English and Hamsa-STT-S2 (Deprecated)](https://mintcdn.com/hamsa-452fa79a/IyoYQ-nNrFRmlJOT/images/agents/settings/stt-model-menu-light.webp?fit=max\&auto=format\&n=IyoYQ-nNrFRmlJOT\&q=85\&s=062f43c000edaca6cde28fb58d2f5193)

### Voice dictionaries

Dictionaries fix how the agent pronounces names, brands and terms. They belong to the project, so every agent can use them. Pick one or more in **Voice dictionaries**, or use **Manage library** and **Create a dictionary**. When two selected dictionaries have the same entry, the one later in the list wins. See [Pronunciation dictionaries](https://docs.tryhamsa.com/agents/voices/dictionaries.md).

## Let the agent switch dialect during a call

Turn on **Language/dialect switcher** in **Call settings** when callers may speak a different dialect, or ask to.

![Call settings scrolled to Smart call end and its prompt, with Language/dialect switcher, Interrupt, Ambient sound, Thinking voice and Speaker identification below](https://mintcdn.com/hamsa-452fa79a/IyoYQ-nNrFRmlJOT/images/agents/settings/call-settings-smart-call-end-light.webp?fit=max\&auto=format\&n=IyoYQ-nNrFRmlJOT\&q=85\&s=7343de6dfe25814b6daa72cf112e1367)

When the caller speaks or asks for another language or dialect, the model can switch to it. After a switch:

* The voice keeps its sound and speaks the new dialect.
* The dialect instruction in the prompt is rewritten for the new dialect.
* Speech recognition switches between Arabic and English if the language changed.
* `{{ agent_language }}` and `{{ agent_dialect }}` hold the new values.
* The agent replies in the new dialect right away.

The agent can switch to Saudi, Emirati, Omani, Bahraini, Lebanese, Palestinian, Jordanian, Egyptian, Qatari, Iraqi, Syrian and Kuwaiti Arabic, Modern Standard Arabic, and English.

## How it works on a call

* Everything the agent says goes through the voice, after the voice dictionaries are applied.
* Everything the caller says goes through the STT model before the model reads it. Recognition can mishear names and numbers, so ask the agent to confirm them (see [Write a prompt that works on calls](https://docs.tryhamsa.com/agents/build/write-a-prompt.md#write-for-the-ear)).
* `{{ agent_language }}` is `ar` or `en` and `{{ agent_dialect }}` is a code such as `jor`, `uae`, `msa` or `en`. You can use them in prompts and messages. See [System variables](https://docs.tryhamsa.com/agents/variables/system-variables.md).

## Good to know

* Changing the voice changes the agent's language and dialect at the same time. Check the prompt and greeting still fit.
* The dialect switcher is offered to the model as an option. It switches when the model decides the caller wants it, not on a keyword.
* For Arabic agents, **User gender detection** in **Call settings** helps the agent address the caller with the right forms. See [Call behavior settings](https://docs.tryhamsa.com/agents/settings/call-behavior.md#know-who-is-speaking).

## Related

> [card] [Choose a voice](https://docs.tryhamsa.com/agents/voices/choose-a-voice.md)
>
> Browse, preview and favorite voices.

> [card] [Pronunciation dictionaries](https://docs.tryhamsa.com/agents/voices/dictionaries.md)
>
> Fix how names and terms are said.

> [card] [Write a prompt that works on calls](https://docs.tryhamsa.com/agents/build/write-a-prompt.md)
>
> How the dialect instruction fits your prompt.

> [card] [Call behavior settings](https://docs.tryhamsa.com/agents/settings/call-behavior.md)
>
> Gender detection, turn taking and more.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.