> For the complete documentation index, see [llms.txt](https://dataqueue.gitbook.io/voicehub-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dataqueue.gitbook.io/voicehub-docs/agent-design-and-usage/dictionary.md).

# Dictionary

The Dictionary allows you to define word-level pronunciation overrides for Arabic responses. When the agent receives a response from the LLM, words matching entries in the dictionary are automatically replaced with their gendered form based on the detected gender of the caller.

#### When to use:

* When your agent speaks Arabic and needs to address callers using gender-appropriate language.
* When specific words, names, or terms need different pronunciation for male and female callers.
* When you want consistent gendered phrasing across all agent responses without modifying prompts.
* A simple replacer in other languages with the `neutralVersion` .

#### **How It Works**

* If gender has been detected, each word is matched against the dictionary, If a match is found and a gendered version exists, the word is replaced before being sent to TTS.
* The neutral version is applied before gender is detected or if gender is unknown.
* Matching is exact and full-word only — partial matches and substring matches are never applied.

**Dictionary Entry Format:**

if a version is not defined for the detected gender, the original word is left unchanged.

| Field            | Required |
| ---------------- | -------- |
| `word`           | ✓        |
| `maleVersion`    | ✗        |
| `femaleVersion`  | ✗        |
| `neutralVersion` | ✗        |

**Example:**

<figure><img src="/files/XmFQ985CBokF0V5qWJ10" alt=""><figcaption></figcaption></figure>

<br>