> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt.

# Idioma

## Descripción general

Esta guía te muestra cómo configurar tu agente para que hable varios idiomas. Aprenderás a:

* Configurar el idioma principal de tu agente
* Añadir compatibilidad con varios idiomas
* Establecer voces y primeros mensajes específicos para cada idioma
* Optimizar la selección de voz para lograr una pronunciación natural
* Activar el cambio automático de idioma

Los ajustes de idioma también se aplican a los agentes que usan un [modelo Realtime](/docs/es/eleven-agents/customization/realtime-models), pero el ajuste del modelo de Texto a Voz del agente no se aplica en ningún idioma.

> **Gestiona agentes desde tu asistente de IA**
>
> También puedes hacer estos cambios de forma conversacional. El [servidor MCP alojado](/docs/es/eleven-agents/operate/hosted-mcp) permite a Claude y otros clientes MCP crear,
> configurar y gestionar tus agentes mediante lenguaje natural.

## Guía

#### Idioma predeterminado del agente

Cuando creas un agente nuevo, se configura con:

* Inglés como idioma principal
* Modelo Flash v2 para respuestas rápidas solo en inglés
* Un primer mensaje predeterminado.

![](/docs/_fern-files/_img/c533094b96146b19a31fd712a02a4b0b6d63790aa2168698e7dc682291c04e0b.webp)

> **Note**
>
> Los idiomas adicionales hacen que el agente use el modelo Multilingüe v2.5. El inglés siempre usará
> el modelo v2.

#### Añadir idiomas adicionales

#### Actualizar desde el panel

Ve a la página de configuración de tu agente y localiza la pestaña **Agente**.

1. En **Idiomas adicionales**, añade un idioma adicional (por ejemplo, francés)
2. Revisa el primer mensaje, que se traduce automáticamente mediante un modelo de lenguaje extenso (LLM). Personalízalo según sea necesario para cada idioma adicional, para garantizar la precisión y la relevancia cultural.

![](/docs/_fern-files/_img/a5db1d23c7c1cc22b41f9093839cd76b078e6cbef69230714f8c0e58f3609b2f.webp)

#### Actualizar mediante la CLI

#### Descargar la configuración del agente

```bash
elevenlabs agents pull --agent "<agent-name>"
```

#### Editar \`agent_configs/\<agent-name>.json\`

Establece `conversation_config.agent.language` para el idioma principal y añade entradas a `conversation_config.language_presets` para cada idioma adicional. Cada ajuste predefinido puede sobrescribir el primer mensaje y otros campos de configuración de la conversación por idioma:

```json
{
  "conversation_config": {
    "agent": {
      "language": "en"
    },
    "language_presets": {
      "fr": {
        "overrides": {
          "agent": {
            "first_message": "Bonjour, comment puis-je vous aider ?"
          }
        }
      }
    }
  }
}
```

#### Enviar tus cambios

```bash
elevenlabs agents push --agent "<agent-name>"
```

#### Actualizar mediante la API

```python
from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

elevenlabs.conversational_ai.agents.update(
    agent_id="agent_7101k5zvyjhmfg983brhmhkd98n6",
    conversation_config={
        "agent": {"language": "en"},
        "language_presets": {
            "fr": {
                "overrides": {
                    "agent": {"first_message": "Bonjour, comment puis-je vous aider ?"},
                },
            },
        },
    },
)
```

```typescript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient();

await elevenlabs.conversationalAi.agents.update("agent_7101k5zvyjhmfg983brhmhkd98n6", {
  conversationConfig: {
    agent: { language: "en" },
    languagePresets: {
      fr: {
        overrides: {
          agent: { firstMessage: "Bonjour, comment puis-je vous aider ?" },
        },
      },
    },
  },
});
```

> **Note**
>
> Al seleccionar la opción **Todos** en el menú desplegable **Idiomas adicionales**, el agente se configurará para
> admitir 31 idiomas. En conjunto, estos idiomas los habla aproximadamente el 90 % de la población
> mundial.

#### Configurar voces específicas para cada idioma

Para obtener una pronunciación óptima, configura cada idioma adicional con una voz específica para ese idioma de nuestra [Biblioteca de voces](https://elevenlabs.io/app/voice-library).

> **Note**
>
> Para encontrar voces excelentes para cada idioma, seleccionadas por el equipo de ElevenLabs, visita las [mejores selecciones por idioma](https://elevenlabs.io/app/voice-library/collections).

#### Ajustes de voz específicos para cada idioma

![](/docs/_fern-files/_img/e1335d0fc8fe77691f00b928c9aeb5e050226a0d766dbab325ded52e97ed4399.webp)

#### Biblioteca de voces

![](/docs/_fern-files/_img/975e3c0207d86c06d4d68db0ef600ec6a716596062eabfec395b0356265f3583.webp)

#### Activar la detección de idioma

Añade la [herramienta de detección de idioma](/docs/es/eleven-agents/customization/tools/system-tools/language-detection) a tu agente para que pueda cambiar automáticamente al idioma preferido del usuario.

#### Iniciar una llamada

Ahora que el agente está configurado para admitir idiomas adicionales, el widget pedirá al usuario su idioma preferido antes de que comience la conversación.

Si usas el SDK, puedes establecer el idioma mediante programación con anulaciones de conversación. Consulta la guía de
[anulaciones](/docs/es/eleven-agents/customization/personalization/overrides) para conocer los detalles de implementación.

![](/docs/_fern-files/_img/4252ccb78e8c03f864b3389ec641a296ec99b9e89ae7d7efe2de36ef6132a152.webp)

> **Note**
>
> La selección de idioma se mantiene fija durante toda la llamada: los usuarios no pueden cambiar de idioma
> a mitad de la conversación.

### Internacionalización

Puedes integrar el widget con tu framework de internacionalización estableciendo dinámicamente los atributos de idioma y texto de la interfaz.

**`Widget`**

```html title="Widget"
<elevenlabs-convai
  language="es"
  action-text={i18n["es"]["actionText"]}
  start-call-text={i18n["es"]["startCall"]}
  end-call-text={i18n["es"]["endCall"]}
  expand-text={i18n["es"]["expand"]}
  listening-text={i18n["es"]["listening"]}
  speaking-text={i18n["es"]["speaking"]}
></elevenlabs-convai>
```

> **Note**
>
> Asegúrate de que los códigos de idioma coincidan entre tu framework de i18n y los idiomas compatibles del agente.

## Buenas prácticas

#### Selección de voz

Selecciona voces entrenadas específicamente en tus idiomas objetivo. Esto garantiza:

* Pronunciación natural
* Acentos regionales adecuados
* Mejor gestión de los matices específicos de cada idioma

#### Personalización del primer mensaje

Aunque se proporcionan traducciones automáticas, considera:

* Revisar la precisión de las traducciones
* Adaptar los saludos al contexto cultural
* Ajustar el tono formal o informal según sea necesario