Agentes multilingües

Dialogflow admite muchos idiomas. Para obtener la lista completa, consulta la página de referencia de idiomas. El idioma que eliges cuando creas un agente se establece como el idioma predeterminado, y también puedes agregar idiomas adicionales.

Idiomas raíz y específicos de la configuración regional

Existen dos categorías de idiomas:

• Idiomas raíz: Estos son idiomas como el inglés (en), que no especifican una configuración regional.
• Idiomas específicos de la configuración regional: Estos son idiomas como el inglés de EE.UU. (en-US), que especifican una configuración regional, como un área o un país específico.

Algunos idiomas pertenecen a ambas categorías: actúan como raíz y como específicos de la configuración regional. Existen diferencias significativas entre las configuraciones regionales para estos idiomas, por lo que las configuraciones regionales no pueden compartir un mismo idioma raíz. Ejemplos:

• Chino cantonés (zh-HK)
• Chino simplificado (zh-CN)
• Chino tradicional (zh-TW)
• Portugués de Brasil (pt-BR)
• Portugués de Portugal (pt)

En primer lugar, debes diseñar tu agente para los idiomas raíz y solo personalizarlo con idiomas específicos de la configuración regional según sea necesario.

Agrega un idioma

Para agregar un idioma o una configuración regional con la consola de Dialogflow CX, haz lo siguiente:

1. Abre la consola de Dialogflow CX.
2. Elige el proyecto de Google Cloud para el agente.
3. Busca el agente en la lista.
4. Haz clic en el nombre visible del agente.
5. Haz clic en Configuración del agente.
6. Haz clic en la pestaña Idiomas.
7. Agrega o quita idiomas según sea necesario.
8. Haz clic en Guardar.

Datos específicos del lenguaje

La mayoría de los datos de los agentes son comunes para todos los idiomas de un agente multilingüe. Sin embargo, el texto que se usa para interactuar con un usuario final es específico del idioma. Cuando compilas un agente multilingüe, debes proporcionar estos datos específicos de cada idioma. Cuando seleccionas un idioma de la consola o proporcionas un idioma a la API, puedes acceder a estos datos específicos del idioma en cuestión. La siguiente es una lista completa de los datos específicos de un idioma:

• Frases de entrenamiento de intents
• Respuestas de entrega
• Entradas de entidad

Para acceder a los datos específicos de un idioma con la consola, haz clic en el botón de idioma en la parte superior de la consola.

Por ejemplo, la entidad de tamaño a continuación se usa para ordenar camisetas. El agente se configuró originalmente en inglés, por lo que la entidad tiene entradas como "S" con el sinónimo "pequeño" (small). Cuando se agrega el español como idioma, Dialogflow crea la entidad para el idioma nuevo, pero debes proporcionar las entradas de entidad en español.

La IA genera datos específicos del lenguaje

Los agentes conversacionales (Dialogflow CX) te brindan la opción de acelerar el proceso de agregar datos específicos del idioma mediante la generación de IA para que te proporcione los datos, en lugar de ingresarlos de forma manual. Esto se puede hacer a nivel del intent, de la entidad y de la entrega como una función de versión preliminar.

Si decides no usar la generación de IA, puedes ingresar manualmente los datos de los idiomas que no sean predeterminados.

Generación de IA de intents (versión preliminar) { :#ai-intent}

Genera automáticamente frases de entrenamiento en un idioma que no sea el predeterminado:

1. Ve a Configuración del agente > Idiomas y asegúrate de tener uno o más idiomas que no sean predeterminados habilitados para tu agente.
2. Navega al menú desplegable de idioma en la parte superior de la consola y selecciona el idioma que elegiste que no sea el predeterminado.
3. Navega a la pestaña Administrar, haz clic en Intents y elige uno de tus intents. Asegúrate de que el campo Description se complete con una descripción del propósito del intent. La descripción puede estar en tu idioma predeterminado o en el idioma que estás viendo.
4. Cuando habilitas un idioma que no es predeterminado, los agentes conversacionales (Dialogflow CX) no traducen ninguna frase de entrenamiento existente al idioma nuevo. Para crear frases de entrenamiento nuevas en el idioma nuevo, haz clic en el botón radial __ frases generadas recientemente por el LLM. El valor predeterminado es 3. Para copiar y traducir automáticamente tus frases de entrenamiento existentes, selecciona Todas las frases de entrenamiento de tu idioma predeterminado traducidas por generación de IA.
5. Haz clic en + Agregar. Se generará la cantidad especificada de frases de entrenamiento y se propagarán en la tabla en el idioma que seleccionaste. Asegúrate de revisar todas las frases de entrenamiento generadas para verificar su exactitud.

Generación de IA de entidades (versión preliminar)

Genera y traduce automáticamente sinónimos y valores de referencia en un idioma que no sea predeterminado:

1. Ve a Configuración del agente > Idiomas y asegúrate de tener uno o más idiomas que no sean predeterminados habilitados para tu agente.
2. Navega al menú desplegable de idioma en la parte superior de la consola y selecciona el idioma que elegiste que no sea el predeterminado.
3. Navega a la pestaña Administrar, haz clic en Tipos de entidades y elige uno de tus tipos de entidades.
4. Cuando habilitas un idioma que no es el predeterminado, Agentes conversacionales (Dialogflow CX) no traduce automáticamente los valores de referencia ni los sinónimos existentes. Para traducir automáticamente estos valores al idioma nuevo, haz clic en + Copiar del idioma predeterminado. Todos los datos originales del tipo de entidad de idioma predeterminado se traducirán al idioma nuevo y se propagarán en la tabla. Ten en cuenta que traducir más de 50 elementos a la vez puede causar errores. Cada valor de referencia y sinónimo se cuenta como un elemento.
5. También puedes agregar valores de referencia nuevos haciendo clic en + Agregar entrada nueva. Puedes escribir un valor de referencia en tu idioma predeterminado, y tanto el valor de referencia como sus sinónimos se traducirán automáticamente al idioma nuevo.

Generación de IA de entrega (versión preliminar)

La generación de IA está disponible para los tipos de entrega de rutas, grupos de rutas y controladores de eventos. Para obtener más información sobre estos tipos de rutas, consulta la documentación sobre rutas y controladores de eventos.

Esta función solo aparecerá si ves al agente en un idioma que no sea el predeterminado y en uno de los tipos de ruta especificados. Navega a la sección Fulfillment de la ruta. Para copiar y traducir automáticamente las respuestas del agente de tu idioma predeterminado al idioma que estás viendo, haz clic en Copiar y traducir. Ten en cuenta que traducir más de 50 respuestas a la vez puede generar errores.

Datos específicos del idioma cuando se usa la API

Para acceder a los datos específicos de un idioma con la API, proporciona el parámetro languageCode cuando obtengas, crees o actualices los tipos EntityTypeEntityTypeIntent o PageIntent. Ir a la referencia de la API de EntityType

Ir a la referencia de la API de intent Ir a la referencia de la API de la página

Debes realizar llamadas individuales a la API para cada idioma a fin de acceder a todos los datos específicos de un idioma. Si la API llama a la actualización de los datos genéricos para los idiomas, estos se actualizan en todos los idiomas.

Prueba en el simulador

Cuando uses el simulador, elige el idioma que deseas usar; para hacerlo, selecciónalo debajo del nombre del agente.

Proporciona un idioma mediante la API

Cuando envíes solicitudes a través de la API, configura el campo queryInput.languageCode del método detectIntent. Para obtener más información, consulta el tipo Sessions. Ir a la referencia de la API de sesión

Detección automática de idioma

Si el idioma de la consulta del usuario final difiere del idioma especificado en la solicitud, Dialogflow puede detectarlo y cambiar automáticamente al idioma del usuario final. Consulta la página de referencia de idiomas para obtener una lista de los idiomas disponibles para esta función. El campo LanguageInfo en un WebhookRequest identifica el idioma de entrada, el idioma resuelto y la puntuación de confianza cuando se habilita la detección de idioma.

Habilita la detección automática de idioma

Debes habilitar la detección automática de idioma en el nivel del agente y del flujo.

1. Ve a Configuración del agente y selecciona la pestaña Idiomas.

2. Marca la casilla junto a Habilitar la detección y el cambio automático de idioma para habilitar esta función para el agente. Haz clic en Guardar para guardar los cambios.

3. Selecciona un flujo y navega a Configuración de flujo. En el panel de configuración del flujo, marca la casilla junto a Habilitar la detección y el cambio automático de idioma.

4. En el menú desplegable Idiomas, selecciona los idiomas en los que deseas que Dialogflow pueda responder. Asegúrate de seleccionar solo los idiomas que admite la función de detección automática de idiomas.

5. Haz clic en Guardar para guardar los cambios.

Solicitudes que no proporcionan el idioma de un agente

Cuando Dialogflow recibe una solicitud que no proporciona un idioma admitido por el agente, se aplican las siguientes reglas:

• Cuando una solicitud no proporciona un idioma, Dialogflow determina automáticamente el idioma de entrada y responde en ese idioma si la detección automática de idioma está habilitada. Si la detección automática de idioma está inhabilitada, Dialogflow maneja la solicitud con el idioma predeterminado.
• Cuando una solicitud proporciona un idioma específico de la configuración regional que no es admitido por el agente, pero el agente admite el idioma raíz asociado, Dialogflow maneja la solicitud mediante el idioma raíz.
• La extracción de la entidad del sistema es una excepción a la regla anterior. La extracción de la entidad del sistema usa el idioma específico de la configuración regional proporcionado, incluso si el agente no admite el idioma específico de la configuración regional.

Integraciones

Las interacciones de agentes mediante integraciones basadas en texto solo usan el idioma predeterminado del agente.