A continuación, se muestran los pasos iniciales para configurar un asistente digital en modo de idioma con soporte nativo:

1. Haga clic en para abrir el menú lateral, seleccione Desarrollo > Asistentes digitales y haga clic en Nuevo asistente digital.

2. Complete el cuadro de diálogo, prestando especial atención a estos campos:
   • Versión de la plataforma: la versión de la plataforma afecta al comportamiento de los asistentes digitales, como la forma en que el motor de comprensión del lenguaje natural (NLU) resuelve las intenciones y los idiomas soportados de forma nativa.

     Para el modo de idioma de soporte nativo, debe definirlo en 20.12 o superior.

     Consulte Versión de la plataforma.

   • Idioma principal: determina tanto el idioma por defecto del asistente digital como si el asistente digital utilizará soporte nativo para ese idioma o se basará en un servicio de traducción.

     En este campo, debe seleccionar uno de los idiomas en la sección Con soporte nativo de la lista desplegable.

3. Si necesita agregar idiomas adicionales al asistente digital:
   1. En la navegación izquierda del asistente digital recién creado, haga clic en.
   2. Haga clic en Agregar idioma y seleccione el idioma que desea agregar.

En asistentes digitales basados en el soporte del idioma nativo de Oracle Digital Assistant, los idiomas que configure para el asistente digital deben coincidir con los idiomas configurados para las aptitudes.

Para ayudarle a supervisar si los idiomas configurados para sus aptitudes y el asistente digital son coincidentes, se ejecuta una comprobación cada vez que agrega un idioma o una aptitud al asistente digital y cada idioma se marca como Finalizado o En curso:

• Los idiomas completos son aquellos en los que se configuran las aptitudes del asistente digital para ese idioma.
• Los idiomas en curso son aquellos idiomas para los que no se han configurado una o más aptitudes.

Puede encontrar la lista de idiomas finalizados y en curso en el separador General de la página Configuración del asistente digital ().

Si desea aprovechar el soporte de idioma nativo de Oracle Digital Assistant en un asistente digital que ya se ha configurado para utilizar un servicio de traducción, siga estos pasos generales:

1. Para todas las aptitudes del asistente digital, cree versiones que utilicen el soporte de idioma nativo.

   Consulte Creación de una aptitud con idiomas con soporte nativo.

   Para obtener la lista de idiomas con soporte nativo, consulte Idiomas con soporte nativo. (Si alguno de los idiomas que desea soportar no está en esa lista, debe continuar utilizando el modo de servicio de traducción).

2. Cree una nueva versión o clonación del asistente digital.

   1. Haga clic en para abrir el menú lateral y seleccione Desarrollo > Asistentes digitales.

   2. En el mosaico del asistente digital que desea versionar o clonar, haga clic en y seleccione Versión o Clonación.

   3. Rellene los campos necesarios y haga clic en Crear.

3. Elimine todas las aptitudes de la nueva versión o clonación que acaba de crear.

   Esto es necesario porque no puede cambiar el asistente digital para que utilice el soporte de idioma nativo si contiene aptitudes en modo de servicio de traducción.

4. Cree una nueva versión o clonación de ese asistente digital modificado, seleccione la versión de plataforma 20.12 o superior y elija el modo de idioma Con soporte nativo.

   Con este paso, puede conservar la configuración que ha realizado para el asistente digital, aunque tenga que manejar las aptitudes por separado.

5. Agregue las versiones de soporte en idioma nativo de las aptitudes al asistente digital.

En asistentes digitales (o aptitudes independientes) que utilizan varios idiomas con soporte nativo, el asistente digital puede detectar automáticamente el idioma del usuario al comienzo de la sesión. Así es como funciona:

• El idioma se detecta automáticamente en asistentes digitales y aptitudes que se hayan configurado con varios idiomas soportados originalmente.
  • Si solo hay un idioma (con soporte nativo) en el asistente digital, la detección de idioma se desactiva.
  • Si el asistente digital utiliza un servicio de traducción, el servicio de traducción gestiona la detección de idioma, no el asistente digital.
• El idioma no se detecta automáticamente si se accede al asistente digital a través de un canal en el que se ha definido la variable profile.languageTag o profile.locale.
• El idioma se detecta en la primera expresión de la conversación y no se actualiza en la sesión, incluso si el usuario cambia de idioma.
• Por defecto, la sesión de canal dura 7 días antes de que caduque.

A continuación, se muestran los pasos iniciales para configurar un asistente digital en un solo idioma que no sea inglés en el modo de idioma del servicio de traducción:

1. Haga clic en para abrir el menú lateral, seleccione Desarrollo > Asistentes digitales y haga clic en Nuevo asistente digital.

2. Complete el cuadro de diálogo, prestando especial atención a estos campos:
   • Versión de la plataforma: la versión de la plataforma afecta al comportamiento de los asistentes digitales, como la forma en que el motor de comprensión del lenguaje natural (NLU) resuelve las intenciones y los idiomas soportados de forma nativa.

     Si comienza con un nuevo asistente digital, debe seleccionar la versión más reciente disponible, ya que el soporte para esa versión durará más tiempo.

     Consulte Versión de la plataforma.

   • Idioma principal: este campo solo aparece si ha seleccionado la versión 20.12 o posterior de la plataforma.

     En este campo, debe seleccionar el idioma de destino en la sección Servicio de traducción de la lista desplegable.

     Atención:

     Asegúrese de haber realizado la selección en la sección Servicio de traducción. Si selecciona en la sección Soportado originalmente, el asistente digital solo aceptará aptitudes que utilicen el modo Soportado originalmente.

     Si este campo no aparece, el idioma del asistente digital lo determina el idioma de la primera aptitud que se le agrega. En este caso, este idioma se denomina idioma predominante en lugar del idioma principal.

Estos son los pasos iniciales para configurar un asistente digital multilingüe en modo de idioma del servicio de traducción:

1. Haga clic en para abrir el menú lateral, seleccione Desarrollo > Asistentes digitales y haga clic en Nuevo asistente digital.

2. Complete el cuadro de diálogo, prestando especial atención a estos campos:
   • Versión de la plataforma: la versión de la plataforma afecta al comportamiento de los asistentes digitales, como la forma en que el motor de comprensión del lenguaje natural (NLU) resuelve las intenciones y los idiomas soportados de forma nativa.

     Si comienza con un nuevo asistente digital, debe seleccionar la versión más reciente disponible, ya que el soporte para esa versión durará más tiempo.

     Consulte Versión de la plataforma.

   • Idioma principal: este campo solo aparece si ha seleccionado la versión 20.12 o posterior de la plataforma.

     En este campo, debe seleccionar Inglés en la sección Servicio de traducción de la lista desplegable.

     Atención:

     Asegúrese de haber realizado la selección en la sección Servicio de traducción. Si selecciona en la sección Soportado originalmente, el asistente digital solo aceptará aptitudes que utilicen el modo Soportado originalmente.

     Si este campo no aparece, el idioma del asistente digital lo determina el idioma de la primera aptitud que se le agrega. En este caso, este idioma se denomina idioma predominante en lugar del idioma principal.

1. Si no lo ha hecho aún, siga estos pasos para configurar un servicio de traducción para su instancia del asistente digital:
   1. Haga clic en para abrir el menú lateral y seleccione Configuración > Servicio de traducción.
   2. Haga clic en Agregar servicio.
   3. Selección del servicio e introducción de la información de configuración necesaria.

      Si selecciona OCI (para el servicio OCI Language), no introduce información directamente en este cuadro de diálogo, pero debe configurar políticas de OCI para utilizar el servicio.

      Consulte Servicios de traducción admitidos para obtener información sobre lo que debe hacer para configurar cada servicio.

   Consulte la documentación de Microsoft Translator y de la API Translation de Google para averiguar cómo obtener el URL y el token de acceso.

   Nota
   
   Para utilizar la API Translation de Google, tiene que generar la clave de API. Esta clave se crea desde la consola de GCP (API y servicios > Credenciales). Para obtener más información, consulte la documentación de Google Cloud Platform.
2. Para definir el servicio de traducción en el asistente digital, siga estos pasos:
   1. Haga clic en para abrir el menú lateral, seleccione Desarrollo > Asistentes digitales y, a continuación, seleccione el asistente digital.
   2. En la barra de navegación izquierda del asistente digital, haga clic en el icono Configuración () y seleccione el separador General.
   3. Vaya al menú desplegable Servicio de traducción y seleccione el servicio de traducción.

Por defecto, si se configura un asistente digital con un servicio en traducción, el asistente digital detectará el idioma del usuario al igual que el que hace una aptitud con el componente Detectar idioma.

Sin embargo, también debe asegurarse de que las aptitudes del asistente digital utilicen el idioma que detecta el asistente digital. Cuando una aptitud forma parte de un asistente digital, este traduce la entrada del usuario al inglés y transfiere el texto traducido al inglés a la aptitud. Por lo tanto, por defecto, el componente Detectaría el inglés como idioma y definiría la variable profile.LanguageTag en el idioma Inglés, aunque el usuario introdujera texto distinto del idioma.

Para evitar que este cambio a inglés en una aptitud con un flujo de diálogo desarrollado en modo visual, debe definir la propiedad Etiqueta de idioma de perfil existente del componente Detectar idioma en True en cada aptitud.

Esto garantiza que la aptitud respetará el valor de la variable profile.LanguageTag definida por el asistente digital.

Para evitar que este cambio al inglés en una aptitud basada en YAML, debe agregar la siguiente propiedad al componente System.DetectLanguage en cada aptitud:

      useExistingProfileLanguageTag: true

A continuación, se muestra un ejemplo del componente System.DetectLanguage de una habilidad basada en YAML con useExistingProfileLanguageTag definido:

  detectLang:
    component: "System.DetectLanguage"
    properties:
      useExistingProfileLanguageTag: true
    transitions:
      ...

En el caso de texto visible para el usuario en un asistente digital que utiliza un servicio en traducción, puede utilizar cualquiera de estos enfoques en traducción:

• Utilice el servicio de traducción configurado para el asistente digital.

  Si utiliza este enfoque, solo debe tener los mensajes de salida en inglés. No se necesita ninguna otra configuración. El servicio de traducción que haya configurado traducirá automáticamente todos los mensaje de salida al idioma del usuario.

• Utilice un grupo de recursos para traducir los mensajes de salida usted mismo.
  Nota
  
  En el caso de los mensaje de salida que no tengan una referencia a una clave de grupo de recursos, se utilizará automáticamente el servicio de traducción para traducirlos.

En asistentes digitales que usen un servicio de traducción, el asistente digital reconoce la llamada explícita de aptitudes tanto en el idioma detectado como en inglés.

Puede encontrar las cadenas traducibles en las dos ubicaciones siguientes:

• En la página Aptitudes () del asistente digital.

  En ella encontrará las cadenas que se utilizan principalmente para las tarjetas de ayuda que se muestran cuando un usuario pide ayuda en el asistente digital y cuando el asistente digital saluda por primera vez al usuario.

  Para cada aptitud, puede traducir

  • Los campos Descripción en una frase, Descripción y Llamada.
  • Las Expresiones de ejemplo.
• En la página Configuración (), en el separador Configuraciones, en la sección Parámetros de conversación. A partir de la versión 21.04 de la plataforma, las entradas del grupo de recursos se crean automáticamente para esta configuración.

Las claves de grupo de recursos se utilizan para identificar el texto de salida que se debe traducir y proporcionar valores en uno o más idiomas. Para los asistentes digitales que utilizan la versión 21.04 o posterior de la plataforma, las claves se generan automáticamente para los valores de configuración del asistente digital. Para otras cadenas (y para los valores de configuración en asistentes digitales de la versión 21.02 o anterior de la plataforma), debe crear claves manualmente.

Cuando un asistente digital da la bienvenida al usuario o presenta información de ayuda para las aptitudes que contiene, utiliza valores de la página Aptitudes del asistente digital para rellenar las tarjetas de bienvenida y de ayuda. Puede traducir la información que aparece en estas tarjetas de ayuda editando algunos de los campos en la página Aptitudes.

1. En la navegación izquierda del asistente digital, haga clic en
2. Seleccione una aptitud.
3. Actualice los campos Descripción en una frase, Descripción y Llamada con referencias a grupos de recursos en el formulario:

   ${rb.BundleKeyName}

   Por ejemplo, puede utilizar lo siguiente para hacer referencia a una clave para la descripción en una línea de una aptitud de pizza.

   ${rb.PizzaSkillShortDescription}

4. En la sección Ejemplos de la página, pase el cursor sobre un ejemplo, haga clic en su icono Editar y sustituya el texto por una referencia a una clave de grupo de recursos como se indica anteriormente.
5. Repita el paso anterior para las demás expresiones de ejemplo de la aptitud.
6. Repita los cuatro pasos anteriores para cada aptitud.

Los asistentes digitales tienen una serie de propiedades de configuración que se utilizan para mostrar diversas peticiones de datos y mensajes.

Para definir la salida de una propiedad de configuración, haga referencia a la variable de paquete de recursos y a las claves de mensaje. Por ejemplo: ${rb('WhatType')}. También puede utilizar la notación de puntos, por ejemplo: ${rb.WhatType}

1. En la barra de navegación izquierda del asistente digital, haga clic en el icono Configuración () y seleccione el separador Configuraciones.

2. Para las propiedades de la sección Parámetros de conversación de la página, introduzca las referencias a las claves de grupo de recursos definidas para cada una de ellas.

   Por ejemplo, si tiene una clave en el grupo de recursos denominada daAcknowledgementResponse para la propiedad Respuesta de acuse de recibo, introduzca lo siguiente en el campo Respuesta de acuse de recibo:

   ${rb('daAcknowledgementResponse')}

También puede utilizar parámetros en los valores de las claves de grupo, lo que le permite utilizar variables del sistema en la salida. Por ejemplo, el valor por defecto de la propiedad Confirmación de salida de flujo es:

Exited ${system.routingFromIntent} in ${system.routingFromSkill}.

Puede conservar las referencias a las variables del sistema (en este caso, system.routingFromIntent y system.routingFromSkill) en las respuestas traducidas realizando las siguientes acciones:

1. En el valor de la clave de grupo de recursos correspondiente, inserte {0}, {1}, etc. como códigos de sustitución para cada variable del sistema. Por ejemplo, en la entrada en inglés (o por defecto) que cree para la propiedad Confirmación de salida de flujo, puede utilizar el siguiente texto:

   Exited {0} in {1}.

2. A continuación, en el valor de la propiedad, introduzca la referencia a la clave de grupo con el siguiente formato:

   ${rb('bundleKey', '${systemVariableForParam0}', '${systemVariableForParam1}')}

   Por ejemplo, para la propiedad Confirmación de salida de flujo (donde daExitFlowConfirmation es la clave de grupo correspondiente) sería como se muestra a continuación:

   ${rb('daExitFlowConfirmation', '${system.routingFromIntent}', '${system.routingFromSkill}')}

Puede exportar e importar grupos de recursos como formato de archivo CSV, lo que permite trabajar con los grupos fuera de línea.

El archivo CSV debe tener las siguientes columnas:

• languageTag
• key
• message
• annotation

Para exportar un archivo CSV con el grupo de recursos existente:

• En la página Grupo de recursos de la aptitud o el asistente digital, haga clic en para exportar un archivo CSV con el grupo de recursos existente.

  Incluso si aún no ha agregado ninguna clave al grupo de recursos, se exportará un archivo con el formato necesario del CSV.

Para importar un archivo de grupo de recursos:

• En la página Grupo de recursos de la aptitud o el asistente digital, haga clic en .

A partir de la versión 21.04 de la plataforma, las entradas del grupo de recursos se crean automáticamente para los valores de configuración del asistente digital. Si el asistente digital se basa en la versión 21.02 o anterior de la plataforma, puede actualizar a la versión 21.04 o posterior para que se generen estas entradas.

A continuación, se muestra una lista de todas las entradas del grupo de recursos del sistema para asistentes digitales junto con sus valores por defecto.

Si desea utilizar entradas de grupos de recursos para la configuración sin actualizar la versión de la plataforma del asistente digital a la versión 21.04 o superior, a continuación se incluye una lista de las propiedades de personalización que puede traducir junto con los nombres sugeridos para las claves de grupo y las expresiones que usaría para hacer referencia a esas claves de grupo desde los campos para las propiedades.