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

# Idiomas

> Configuración de un solo idioma, asistentes multilingües y cambio automático de idioma

Configura el idioma que escucha el asistente, añade idiomas secundarios para que cambie de forma automática según el idioma de quien llama, y elige una voz adecuada para cada uno.

## Configurar el idioma principal

Cada asistente tiene un **idioma STT** que le indica al modelo de transcripción qué esperar. Configúralo con el idioma que realmente hablan quienes llaman: mejora notablemente el reconocimiento de nombres, números y direcciones.

Para el idioma de *salida* del asistente, sé explícito en el prompt del sistema:

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

La detección de turnos admite un **modelo semántico multilingüe** (predeterminado) que reconoce los límites de las oraciones en distintos idiomas, además de una variante optimizada para inglés y un VAD simple.

## Asistentes multilingües

Para mercados donde quienes llaman cambian de idioma (algo habitual en la región DACH: alemán, turco, inglés), configura el **cambio automático de idioma**:

1. Elige un **modelo de reconocimiento de voz multilingüe** para que la transcripción siga a quien llama.
2. Agrega al menos un **idioma secundario**. El cambio automático se activa en cuanto hay un idioma secundario configurado y se desactiva cuando se elimina el último.
3. Opcionalmente, asigna una **voz por idioma**: por ejemplo, una voz en alemán para `de` y una voz en inglés para `en`. Cuando quien llama cambia de idioma, el asistente responde en el nuevo idioma *con la voz correspondiente*.

El asistente también recibe una pista en el prompt para responder en el idioma detectado, de modo que el LLM lo siga sin necesidad de ingeniería de prompts adicional.

Las voces por idioma están disponibles en **Pipeline** y **Half-cascade**, porque esos [modos](/es/assistants/engine-modes) usan una voz de salida separada. Se ocultan en un motor **Realtime** puro.

<Note>
  Cambiar la vista a **Voice per language** no modifica nada por sí solo. Elige una voz para un idioma para guardar la sustitución; los demás idiomas conservan la voz principal.
</Note>

<Tip>
  Mantén el prompt del sistema en un solo idioma (idealmente en inglés, ya que los LLM siguen las instrucciones en inglés de forma más confiable) e indica explícitamente la regla de respuesta: "Responde en el idioma que hable quien llama".
</Tip>

## API y MCP

Los mismos ajustes de idioma y voz están disponibles mediante `PATCH /api/v1/assistants/{id}` y la herramienta MCP `update_assistant`. `GET /api/v1/languages` muestra los códigos ISO 639-1 admitidos; consulta la referencia de la API para ver los campos de la solicitud.

## Pronunciación en todos los idiomas

El [diccionario de pronunciación](/es/assistants/models-and-voices#estilo-de-habla) se aplica en todos los idiomas: es útil para nombres de marca que las voces TTS pronuncian mal de forma distinta según el idioma. Los administradores del tenant pueden definir un mapa predeterminado para todo el tenant, que se combina con las entradas de cada asistente.

## Idioma del resumen posterior a la llamada

El **Conversation Summary** en el detalle de una llamada siempre se redacta en el **idioma principal** del asistente, no en el idioma en el que se mantuvo la llamada. Un asistente en alemán que atendió una llamada en inglés sigue recibiendo un resumen en alemán, de modo que el listado del historial se mantiene legible en un solo idioma. Al reevaluar una llamada (Historial → Re-evaluate) se aplica la misma regla.

Todo lo demás permanece en el idioma original: la transcripción, las grabaciones y los campos de análisis extraídos nunca se traducen.

<Note>
  Cuando cambias el idioma principal, solo los resúmenes **nuevos** usan el nuevo idioma. Usa **Re-evaluate** para volver a generar el resumen de una llamada anterior.
</Note>

## Documentación frente al idioma de la llamada

Ten en cuenta que el idioma de la interfaz de la plataforma y el idioma de llamada del asistente son independientes: tu equipo puede usar un panel en inglés mientras los asistentes hablan en alemán con los clientes, y viceversa.
