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

# Build multilingual agents

A multilingual agent needs a language policy, reviewed translations, compatible voice settings, and tests in each language. Translating a few prompts doesn't make the full experience multilingual.

Decide which languages and channels you support, who owns each translation, and what happens when a language is unavailable. Keep the policy and operational facts in one authoritative source. Mark unreviewed or missing text clearly: the platform doesn't translate missing locale entries automatically.

| Capability | How to approach it |
| - | - |
| **Choose the interaction language** | Use the interaction context the channel supplies, or ask the person and set it with `SET_INTERACTION_LANGUAGE`. `CONVERSATION.speaking.language_policy` can follow the interaction context, use the agent default, or stay fixed. |
| **Translate stable text** | Keep translated strings in locale assets under `locales/<locale>/<agent>.json` or `locales/<locale>/_shared.json`. Manage them in **Project** → **Settings** → **Localization**. Reference text with `{{locale.KEY}}`; supported flow and gather messages can also use `MESSAGE_KEY`. |
| **Answer from knowledge** | Use documents written for the language, name their language in the knowledge source description, and test questions that mix languages. |
| **Speak and listen** | Configure a compatible recognizer and voice for each supported language. Test names, numbers, dates, negation, and corrections in that language. |

## Keep the language choice explicit

For a text interaction, a channel can supply language and locale in its interaction context. In Studio's test panel, set **Language**, **Locale**, and **Timezone** so the test matches the intended user. A flow can set a language after a person chooses one, or clear that choice to return to the default. Don't depend on text-language detection, which isn't supported.

```yaml ABL: language configuration theme={null}
CONVERSATION:
  speaking:
    language_policy: interaction_context

# A localized authored response
RESPOND: "{{locale.CANCEL_CONFIRM}}"
```

Locale files follow the configured fallback chain; for example, a regional locale can fall back to its base language. A missing key isn't translated silently. Use the fallback text on purpose, and review what the person will hear or read.

Templates are channel-specific, not language-specific. Keep the language choice in the interaction context and the localized strings, instead of creating a template variant for every language.

See [General settings](https://koreai.mintlify.site/agent-platform/administration/general-settings.md) for localization assets.

## Test the whole conversation in each language

* Translate and review every fixed prompt, error response, button label, and confirmation.
* Write personas and opening messages in each supported language. Text eval personas and scenarios have no separate language field, so make the language clear in their content.
* Set the Studio test interaction context to the language and locale you are checking.
* Add a scenario where the person changes language mid-conversation. Check that the next response and any later tool-facing prompt use the selected language.
* For voice, verify the configured ASR and TTS profile. Then test natural speech, local names, digits, negation, and mid-sentence correction.
* Have a fluent reviewer read or listen to samples. A passing exact check can't judge translation quality by itself.

For example, to add Spanish to Voyager: translate the cancellation read-back, choose Spanish in the test interaction context, and add a scenario that switches from English to Spanish.

Language support spans the agent, locale assets, knowledge sources, channel, and eval set. Track it as one release capability, with an owner for each layer.


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