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

# Langues

> Configuration monolingue, assistants multilingues et changement de langue automatique

## Définir la langue principale

Chaque assistant dispose d'une **langue STT** qui indique au modèle de transcription à quoi s'attendre. Réglez-la sur la langue que vos appelants parlent réellement : cela améliore nettement la reconnaissance des noms, des numéros et des adresses.

Pour la langue de *sortie* de l'assistant, soyez explicite dans le prompt système :

```text theme={null}
Always answer in German, regardless of the language the caller uses.
```

La détection de tour de parole prend en charge un **modèle sémantique multilingue** (par défaut), capable de repérer les limites de phrases dans toutes les langues, ainsi qu'une variante optimisée pour l'anglais et un VAD simple.

## Assistants multilingues

Pour les marchés où les appelants changent de langue (fréquent dans la zone DACH : allemand, turc, anglais), configurez le **changement de langue automatique** :

1. Choisissez un **modèle STT multilingue** (par exemple Deepgram nova-3 multilingual) pour que la transcription suive l'appelant.
2. Ajoutez au moins une **langue secondaire**. Le changement automatique s'active dès qu'une langue secondaire est présente et se désactive lorsque la dernière est supprimée.
3. Associez éventuellement une **voix par langue** — par exemple une voix allemande pour `de`, une voix anglaise pour `en`. Quand l'appelant change de langue, l'assistant répond dans la nouvelle langue *avec la voix correspondante*.

L'assistant reçoit également une indication dans le prompt pour répondre dans la langue détectée, si bien que le LLM s'adapte sans prompt engineering supplémentaire.

Les surcharges de voix par langue sont disponibles pour les moteurs **Pipeline** et **Half-cascade**, car ces modes disposent d'un composant TTS distinct. Elles sont masquées pour un moteur **Realtime** pur (speech-to-speech). Les intégrations TTS actuelles de Cartesia, ElevenLabs, OpenAI, Google et Azure prennent en charge la mise à jour de la voix en direct ; le worker convertit chaque surcharge dans l'option native du fournisseur.

Half-cascade utilise le modèle realtime pour la compréhension de la parole, mais les transcriptions renvoyées par le fournisseur peuvent arriver en retard et sans langue détectée. Lorsque des langues secondaires sont configurées, la plateforme ajoute donc automatiquement un flux de transcription multilingue distinct. Cela fournit des métadonnées de langue fiables sans modifier la gestion des tours de parole du modèle realtime.

<Note>
  Basculer l'affichage de l'éditeur sur **Voix par langue** ne stocke rien en soi. Une entrée `language_voices` n'est créée qu'après avoir choisi une voix pour une langue. Les langues sans entrée conservent la voix principale de l'assistant.
</Note>

<Tip>
  Rédigez le prompt système dans une seule langue (idéalement l'anglais — c'est la langue que les LLM suivent le plus fidèlement) et énoncez explicitement la règle de réponse : « Répondez dans la langue parlée par l'appelant ».
</Tip>

## API

La configuration des langues est entièrement scriptable : `primary_language`, `secondary_languages[]`, `auto_language_switch` et la carte de voix par langue `language_voices` sont des champs d'assistant classiques — définissez-les via `PATCH /api/v1/assistants/{id}` ou l'outil MCP `update_assistant`. Dans le tableau de bord, `auto_language_switch` est simplement déduit du fait que `secondary_languages` est vide ou non. Les codes de langue pris en charge (ISO 639-1) sont consultables via `GET /api/v1/languages`.

## Prononciation dans toutes les langues

Le [dictionnaire de prononciation](/assistants/models-and-voices#speaking-style) s'applique dans toutes les langues — utile pour les noms de marque que les voix TTS déforment différemment selon la langue. Les administrateurs de locataire peuvent définir une carte par défaut à l'échelle du locataire, qui se combine avec les entrées propres à chaque assistant.

## Langue du résumé post-appel

Le **Conversation Summary** dans le détail d'un appel est toujours rédigé dans la **langue principale** de l'assistant — et non dans la langue dans laquelle l'appel s'est déroulé. Un assistant en allemand qui a pris un appel en anglais obtient donc toujours un résumé en allemand, ce qui garde la liste de l'historique lisible dans une seule langue. La réévaluation d'un appel (Historique → Re-evaluate) suit la même règle.

Tout le reste reste dans la langue d'origine : la transcription, les enregistrements et les champs d'analyse extraits ne sont jamais traduits.

<Note>
  Si vous modifiez `primary_language`, seuls les **nouveaux** résumés suivent la nouvelle langue — les résumés déjà enregistrés sur d'anciens appels ne sont pas réécrits. Utilisez **Re-evaluate** sur un appel pour régénérer son résumé dans la nouvelle langue.
</Note>

## Langue de la documentation et langue d'appel

La langue de l'interface de la plateforme et la langue d'appel de l'assistant sont indépendantes : votre équipe peut très bien exploiter un tableau de bord en anglais pendant que les assistants parlent allemand à leurs clients, et inversement.