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, haz lo siguiente:

  1. En el menú de la barra lateral izquierda, haz clic en el botón para agregar idiomas junto a los idiomas existentes.
    Esto te lleva a la pestaña Idiomas de la configuración del agente.
  2. Selecciona un idioma del menú desplegable Seleccionar idioma adicional.
  3. Para agregar una configuración regional, desplázate sobre un idioma raíz y haz clic en + Agregar configuración regional.
  4. Haz clic en Guardar.

Intent multilingüe y datos de la entidad

En los datos de la entidad y el intent, algunos datos son comunes para todos los idiomas de un agente multilingüe y algunos son específicos de un idioma.

Datos de la entidad y el intent genéricos para los idiomas

Los datos de la entidad y el intent genéricos para los idiomas y son comunes a todos los idiomas compatibles con un agente. Aunque se puede seleccionar un idioma específico en la consola o se puede proporcionar a la API, estos datos se comparten para todos los idiomas. Por ejemplo, los siguientes datos son genéricos para los idiomas:

Intents específicos para un idioma y datos de la entidad

Los datos de la entidad y el intent específicos para un idioma son únicos para cada idioma que admite un agente. Debes proporcionar estos datos de forma individual para cada idioma. Cuando seleccionas un idioma de la consola o proporcionas un idioma a la API, puedes acceder a estos datos del idioma en cuestión. La siguiente es una lista completa de los datos específicos de un idioma:

Para acceder a los datos específicos de un idioma con la consola, haz clic en el botón de idioma debajo del nombre del agente.

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.

Para acceder a los datos específicos de un idioma con la API, proporciona el parámetro language_code cuando obtengas, crees o actualices los tipos EntityType o Intent. 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 lenguaje mediante la API

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

Solicitudes que no proporcionan un idioma admitido

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 maneja la solicitud mediante 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 de puertas de enlace de teléfono y basadas en texto solo usan el idioma predeterminado del agente.