Dialogflow admite muchos idiomas. Para ver la lista completa, consulta la página de referencia de idiomas. El idioma que elijas al crear un agente se establecerá como idioma predeterminado, y podrás añadir otros idiomas.
Ámbito de la selección de idioma en la consola y la API
Cuando se selecciona un idioma en la consola o en la API, esta selección solo afecta a los flujos del agente. Para seleccionar el idioma de las guías, consulta la compatibilidad de idiomas de las guías.
Idiomas raíz y específicos de la configuración regional
Hay dos categorías de idiomas:
- Idiomas raíz: son idiomas como el inglés (en) que no especifican una configuración regional.
- Idiomas específicos de una configuración regional: son idiomas como Inglés (EE. UU.) (en-US) que especifican una configuración regional como una región o un país concretos.
Algunos idiomas actúan como raíz y como específicos de una configuración regional. Hay diferencias significativas entre las configuraciones regionales de estos idiomas, por lo que no pueden compartir un idioma raíz común. Ejemplos:
- Chino cantonés (zh-HK)
- Chino (simplificado) (zh-CN)
- Chino tradicional (zh-TW)
- Portugués de Brasil (pt-BR)
- Portugués (Portugal) (pt)
Debes diseñar tu agente principalmente para los idiomas raíz y personalizarlo para los idiomas específicos de una configuración regional solo cuando sea necesario.
Añadir un idioma
Para añadir un idioma o una configuración regional con la consola de Dialogflow CX, sigue estos pasos:
- Abre la consola de Dialogflow CX.
- Elige el Google Cloud proyecto del agente.
- Busca el agente en la lista.
- Haz clic en el nombre visible del agente.
- Haz clic en Configuración del agente.
- Haga clic en la pestaña Idiomas.
- Añade o elimina idiomas según sea necesario.
- Haz clic en Guardar.
Datos específicos de un idioma
La mayoría de los datos de los agentes son comunes a todos los idiomas de un agente multilingüe. Sin embargo, el texto que se usa para interactuar con un usuario final depende del idioma. Al crear un agente multilingüe, debes proporcionar estos datos específicos de cada idioma. Cuando selecciona un idioma en la consola o proporciona un idioma a la API, puede acceder a los datos específicos de ese idioma. A continuación, se incluye una lista completa de datos específicos de cada idioma:
Para acceder a datos específicos de un idioma con la consola, haz clic en el botón de idioma situado en la parte superior de la consola.
Por ejemplo, el tipo de entidad size que se muestra a continuación se usa para pedir camisetas. El agente se configuró originalmente en inglés, por lo que la entidad tiene entradas como "S" con el sinónimo "small". Cuando se añade el español como idioma, Dialogflow crea la entidad para el nuevo idioma, pero debes proporcionar entradas de entidad en español.
| Entidad | Sinónimos |
|---|---|
| XS | XS (extrapequeña) |
| S | S, pequeño |
| M | M, medio |
| L | L, grande |
| XL | XL, extra grande |
Generar datos específicos de un idioma con IA
Agentes conversacionales (Dialogflow CX) te ofrece la opción de acelerar el proceso de añadir datos específicos de un idioma. Para ello, puedes usar la generación por IA para que te proporcione los datos en lugar de introducirlos manualmente. Puede hacerlo a nivel de intención, entidad y respuesta como función de vista previa.
Si decides no usar la generación por IA, puedes introducir manualmente los datos de los idiomas que no sean el predeterminado.
Generación de IA de intención
Generar automáticamente frases de entrenamiento en un idioma que no sea el predeterminado:
- Ve a Ajustes del agente > Idiomas y asegúrate de que tienes uno o varios idiomas distintos del predeterminado habilitados en tu agente.
- Ve al menú desplegable de idiomas situado en la parte superior de la consola y selecciona el idioma que quieras usar (que no sea el predeterminado).
- Vaya a la pestaña Gestionar, haga clic en Intenciones y elija una de sus intenciones. Asegúrate de que el campo Descripción incluya una descripción del propósito de la intención. La descripción puede estar en tu idioma predeterminado o en el idioma en el que estés viendo el contenido.
- Cuando habilitas un idioma que no es el predeterminado, Conversational Agents (Dialogflow CX) no traduce ninguna frase de entrenamiento al nuevo idioma. Para crear nuevas frases de entrenamiento en el nuevo idioma, haz clic en el botón radial __ frases recién generadas por LLM. El valor predeterminado es 3. Para copiar y traducir automáticamente las frases de entrenamiento que ya tengas, selecciona Todas las frases de entrenamiento de tu idioma predeterminado traducidas mediante generación por IA.
- Haz clic en + Añadir. Se genera el número de frases de entrenamiento que has especificado y se rellena la tabla con ellas en el idioma que has seleccionado. Asegúrate de revisar todas las frases de entrenamiento generadas para comprobar que son precisas.
(Vista previa) Generación de IA de entidades
Generar y traducir automáticamente valores de referencia y sinónimos en un idioma que no sea el predeterminado:
- Ve a Ajustes del agente > Idiomas y asegúrate de que tienes uno o varios idiomas distintos del predeterminado habilitados en tu agente.
- Ve al menú desplegable de idiomas situado en la parte superior de la consola y selecciona el idioma que quieras usar.
- Vaya a la pestaña Gestionar, haga clic en Tipos de entidades y elija uno de sus tipos de entidades.
- Cuando habilitas un idioma que no es el predeterminado, Conversational Agents (Dialogflow CX) no traduce automáticamente los valores de referencia ni los sinónimos. Para traducir automáticamente estos valores al nuevo idioma, haz clic en + Copiar del idioma predeterminado. Todos los datos originales del tipo de entidad del idioma predeterminado se traducirán al nuevo idioma y se incluirán en la tabla. Ten en cuenta que traducir más de 50 elementos a la vez puede provocar errores. Cada referencia y valor de sinónimo se considera un elemento.
- También puede añadir nuevos valores de referencia haciendo clic en + Añadir nueva entrada. Puede escribir un valor de referencia en su idioma predeterminado y tanto el valor de referencia como sus sinónimos se traducirán automáticamente al nuevo idioma.
(Vista previa) Generación de IA de cumplimiento
La generación con IA está disponible para los tipos de rutas, grupos de rutas y cumplimiento de controladores de eventos. Para obtener más información sobre estos tipos de rutas, consulta la documentación de rutas y gestores de eventos.
Esta función solo aparecerá si estás viendo el agente en un idioma que no sea el predeterminado y en uno de los tipos de ruta especificados. Ve a la sección Cumplimiento de la ruta. Para copiar y traducir automáticamente las respuestas del agente de tu idioma predeterminado al idioma en el que estás viendo la conversación, haz clic en Copiar y traducir. Ten en cuenta que traducir más de 50 respuestas a la vez puede provocar errores.
Datos específicos de un idioma al usar la API
Para acceder a datos específicos de un idioma con la API, proporcione el parámetro languageCode al obtener, crear o actualizar los tipos EntityType, Intent o Page.
Selecciona un protocolo y una versión para la referencia EntityType:
| Protocolo | V3 | V3beta1 |
|---|---|---|
| REST | Recurso EntityType | Recurso EntityType |
| RPC | Interfaz EntityType | Interfaz EntityType |
| C++ | EntityTypesClient | No disponible |
| C# | EntityTypesClient | No disponible |
| Go | EntityTypesClient | No disponible |
| Java | EntityTypesClient | EntityTypesClient |
| Node.js | EntityTypesClient | EntityTypesClient |
| PHP | No disponible | No disponible |
| Python | EntityTypesClient | EntityTypesClient |
| Ruby | No disponible | No disponible |
Selecciona un protocolo y una versión para la referencia de Intent:
| Protocolo | V3 | V3beta1 |
|---|---|---|
| REST | Recurso de intención | Recurso de intención |
| RPC | Interfaz de intents | Interfaz de intents |
| C++ | IntentsClient | No disponible |
| C# | IntentsClient | No disponible |
| Go | IntentsClient | No disponible |
| Java | IntentsClient | IntentsClient |
| Node.js | IntentsClient | IntentsClient |
| PHP | No disponible | No disponible |
| Python | IntentsClient | IntentsClient |
| Ruby | No disponible | No disponible |
Selecciona un protocolo y una versión para la referencia de la página:
| Protocolo | V3 | V3beta1 |
|---|---|---|
| REST | Recurso de página | Recurso de página |
| RPC | Interfaz de la página | Interfaz de la página |
| C++ | PagesClient | No disponible |
| C# | PagesClient | No disponible |
| Go | PagesClient | No disponible |
| Java | PagesClient | PagesClient |
| Node.js | PagesClient | PagesClient |
| PHP | No disponible | No disponible |
| Python | PagesClient | PagesClient |
| Ruby | No disponible | No disponible |
Debe hacer llamadas a la API independientes para cada idioma si quiere acceder a todos los datos específicos de cada idioma. Si sus llamadas a la API actualizan datos genéricos de idioma, esos datos se actualizan en todos los idiomas.
Hacer pruebas en el simulador
Cuando uses el simulador, elige el idioma que quieras usar seleccionándolo debajo del nombre del agente.
Proporcionar un idioma mediante la API
Cuando envíes solicitudes a través de la API, define el campo
queryInput.languageCode
del método detectIntent.
Para obtener más información, consulta el tipo Sessions.
Seleccione un protocolo y una versión para la referencia de la sesión:
| Protocolo | V3 | V3beta1 |
|---|---|---|
| REST | Recurso de sesión | Recurso de sesión |
| RPC | Interfaz de sesión | Interfaz de sesión |
| C++ | SessionsClient | No disponible |
| C# | SessionsClient | No disponible |
| Go | SessionsClient | No disponible |
| Java | SessionsClient | SessionsClient |
| Node.js | SessionsClient | SessionsClient |
| PHP | No disponible | No disponible |
| Python | SessionsClient | SessionsClient |
| Ruby | No disponible | No disponible |
Detección automática de idioma
Si el idioma de la consulta del usuario final es diferente 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 ver una lista de los idiomas disponibles para esta función. El campo LanguageInfo de un
WebhookRequest
identifica el idioma de entrada, el idioma resuelto y la puntuación de confianza cuando
la detección de idioma está habilitada.
Habilitar la detección automática de idioma
Debes habilitar la detección automática de idioma tanto en el agente como en el flujo.
Ve a Configuración del agente y selecciona la pestaña Idiomas.
Marca la casilla situada junto a Habilitar la detección y el cambio automáticos de idioma para habilitar esta función en el agente. Haz clic en Guardar para guardar los cambios.
Selecciona un flujo y ve a Configuración del flujo. En el panel de configuración del flujo, marca la casilla situada junto a Habilitar la detección y el cambio automáticos de idioma.
En el menú desplegable Idiomas, selecciona los idiomas en los que quieres que Dialogflow pueda responder. Asegúrate de seleccionar solo los idiomas que admite la función de detección automática de idiomas.
Haz clic en Guardar para guardar los cambios.
Solicitudes que no indican el idioma del agente
Cuando Dialogflow recibe una solicitud que no proporciona un idioma compatible con 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 gestiona la solicitud con el idioma predeterminado.
- Cuando una solicitud proporciona un idioma específico de una configuración regional que no es compatible con el agente, pero el idioma raíz asociado sí lo es, Dialogflow gestiona la solicitud con el idioma raíz.
- La extracción de entidades del sistema es una excepción a la regla anterior. La extracción de entidades del sistema usa el idioma específico de la configuración regional proporcionado, aunque el agente no admita ese idioma.
Integraciones
Las interacciones con los agentes a través de integraciones basadas en texto solo usan el idioma predeterminado del agente.