Para utilizar la API Translation de Google, debe 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.

Si desea utilizar Microsoft Translator como servicio de traducción en Oracle Digital Assistant, debe suscribirse a Translator o al servicio múltiple de Cognitive Services y obtener una clave secreta. Consulte https://docs.microsoft.com/en-gb/azure/cognitive-services/translator/reference/v3-0-reference.

Estos son los puntos más importante que debe saber:

• Debe utilizar la región Global y su URL correspondiente (https://api.cognitive.microsofttranslator.com/).
• Debe obtener una clave secreta para la autenticación. Puede obtenerla en la sección Keys and Endpoints de Azure Portal.

1. Haga clic en para abrir el menú lateral y seleccione Configuración > Servicio de traducción.

2. Haga clic en Agregar servicio.

3. En el cuadro de diálogo Servicios de traducción, introduzca la URL y la clave de autorización (para el servicio Microsoft Translator) o el token de autorización (para la API de Google Translation).

   1. URL
   2. Clave de autorización (para el servicio Microsoft Translator) o token de autorización (para la API de Google Translation).

1. Si todavía no lo ha hecho, registre un servicio de traducción en Oracle Digital Assistant.
2. Haga clic en para abrir el menú lateral, seleccione Desarrollo > Aptitudes y elija la aptitud.
3. En la barra de navegación izquierda de la aptitud, haga clic en el icono Configuración () y seleccione el separador General.
4. Vaya al menú desplegable Servicio de traducción y seleccione el servicio de traducción.

Si ha configurado un servicio de traducción para una aptitud, Oracle Digital Assistant asigna de modo automático un idioma predominante para dicha aptitud, en función del idioma de las expresiones de ejemplo de la aptitud.

Para ver qué idioma predominante se ha asignado a una aptitud, pulse el icono Configuración() en la barra de navegación izquierda de la aptitud, seleccione el separador General y compruebe el valor de la propiedad Idioma predominante.

Asegúrese de que todas las expresiones de ejemplo de las intenciones, las entidades y el texto de respuesta del diálogo estén en el idioma predominante.

Si está diseñando la aptitud para que admita varios idiomas, el idioma predominante debe ser el inglés.

El idioma predominante del asistente digital lo determina el idioma predominante de la primera aptitud que se agrega al asistente digital. Cualquier otra aptitud que se agregue al asistente digital deberá tener el mismo idioma predominante.

Si la primera aptitud que se agrega no tiene un idioma predominante (porque no se ha especificado ningún servicio de traducción en la aptitud), el idioma predominante del asistente digital se establecerá en inglés. En este caso, puede agregar aptitudes que tengan el inglés como idioma predominante (o que no tengan ningún idioma predominante establecido).

Estos son los pasos que debe seguir si quiere especificar individualmente qué componentes traducir:

1. Si aún no lo ha hecho, agregue un servicio de traducción a la aptitud.
2. Asegúrese de que la variable de contexto autoTranslate no esté definida (o esté definida en false).
3. Encima del estado del componente System.Intent, agregue el componente System.DetectLanguage:

     detect:
       component: "System.DetectLanguage"
       properties:
         useExistingProfileLanguageTag: true
       transitions: {}

   Nota
   
   La propiedad useExistingProfileLanguageTag se utiliza cuando una aptitud forma parte de un asistente digital que tiene un servicio de traducción. Esto permite a la aptitud utilizar el idioma detectado por el asistente digital inmediatamente. De lo contrario, la aptitud puede proporcionar un mensaje o una petición de datos en inglés antes de que se detecte (o se vuelva a detectar) el idioma. Si la aptitud no está en un asistente digital con la función de traducción activada, se ignora la propiedad.
4. En el componente System.Intent, defina la propiedad translate en true.

     intent:
       component: "System.Intent"
       properties:
         variable: "iResult"
         translate: true

5. Para el resto de componentes de entrada, establezca también la propiedad translate en true.

Estos son los pasos que debe seguir si quiere utilizar la traducción automática por defecto (y especificar individualmente los componentes que no se van a traducir) :

1. Si aún no lo ha hecho, agregue un servicio de traducción a la aptitud.
2. Agregue autoTranslate: "boolean" como variable al nodo context.

   context:
     variables:
       ...
       autoTranslate: "boolean"

3. En el nodo states, encima del componente System.Intent, agregue un componente System.SetVariable. A continuación, defina la propiedad variable para utilizar la variable de contexto autoTranslate y establezca la propiedad value en true.

     setAutoTranslate:
       component: "System.SetVariable"
       properties:
         variable: "autoTranslate"
         value: true
       transitions: {}

4. Para el siguiente estado, agregue el componente System.DetectLanguage:

     detect:
       component: "System.DetectLanguage"
       properties:
         useExistingProfileLanguageTag: true
       transitions: {}

   Nota
   
   La propiedad useExistingProfileLanguageTag se utiliza cuando una aptitud forma parte de un asistente digital que tiene un servicio de traducción. Esto permite a la aptitud utilizar el idioma detectado por el asistente digital inmediatamente. De lo contrario, la aptitud puede proporcionar un mensaje o una petición de datos en inglés antes de que se detecte (o se vuelva a detectar) el idioma. Si la aptitud no está en un asistente digital con la función de traducción activada, se ignora la propiedad.
5. Para los componentes que no quiera traducir de forma automática, defina la propiedad translate en false. Por ejemplo:

     done:
       component: "System.Output"
       properties:
         text: "${rb('OnTheWay','${size.value}','${type.value}')}"
         translate: false
       transitions:
         return: "done"

Si quiere manipular el texto de entrada antes de enviarlo al servicio de traducción, puede utilizar el componente System.TranslateInput. Por ejemplo, puede que quiera procesar la entrada de usuario para eliminar datos personales antes de enviarla al servicio de traducción.

context:
  variables:
    autoTranslate: "boolean" 
    translatedString: "string"
    sourceString: "string"    
   ...
states:
   ...
  translateInputString:
    component: "System.TranslateInput"
    properties:
      source: "sourceString"
      variable: "translatedString"
    transitions: {}

Para cada aptitud, puede definir claves de grupos de recursos que identifican el texto de salida que se debe traducir y, a continuación, proporcionar valores para esas claves en uno o más idiomas. Las claves se definen automáticamente para el nombre de conversación de cualquier intención que haya creado, así como para las respuestas de cualquier intención de respuesta. Sin embargo, usted debe crear claves para otro texto de salida que desee traducir, como texto del flujo de diálogo.

En algunos puntos de una conversación, como cuando la aptitud intenta determinar qué flujo quiere seguir el usuario, la aptitud puede presentar un cuadro de diálogo que hace referencia a una o varias intenciones. En estos casos, la aptitud hace referencia a las intenciones por sus nombres de conversación, para los que se generan claves y entradas por defecto en el grupo de recursos.

Para proporcionar una traducción para un nombre de conversación:

1. Haga clic en Grupo de recursos en la barra de navegación izquierda ().

2. Haga clic en el separador Intenciones de la página Grupos de recursos.

   
   
   
   
   
   

3. Seleccione la intención.

4. Haga clic en Agregar idioma.

5. Complete el cuadro de diálogo Crear entrada:

   • Idioma: agregue una etiqueta de idioma IETF BCP 47 como, por ejemplo, fr para francés, de para alemán o en-US para inglés estadounidense.

   • Texto: cadena de salida. Por ejemplo, para una traducción al francés (fr) de la clave HowOld, debe agregar una cadena como quel âge avez-vous?

Nota

Si la intención cuyo nombre de conversación quiere cambiar no aparece en la lista, haga clic en para volver a la página Intenciones, seleccione la intención y edite el campo Nombre de conversación. Al volver a la página Grupos de recursos, debería aparecer bajo el separador Intenciones.

Al crear una intención de respuesta, se crea automáticamente una clave de grupo de recursos para la respuesta.

Para proporcionar una traducción de una respuesta en una intención de respuesta:

1. Haga clic en Grupo de recursos en la barra de navegación izquierda ().

2. Haga clic en el separador Preguntas y respuestas de la página Grupos de recursos.

3. Seleccione la clave para la respuesta que desea traducir.

4. Haga clic en Agregar idioma.

5. Complete el cuadro de diálogo Crear entrada:

   • Idioma: agregue una etiqueta de idioma IETF BCP 47 como, por ejemplo, fr para francés, de para alemán o en-US para inglés estadounidense.

   • Texto: cadena de salida.

Para definir la salida de un componente incorporado, haga referencia a la clave del mensaje y a la variable de contexto del grupo de recursos.

context:
  variables:
    rb: "resourcebundle"
...

pizzaType:
  component: "System.Output"
  properties:
    text: "${rb('WhatType')}" # rb refers to the variable, WhatType is the key to the message in the resource bundle.
  transitions: {}
...

done:
  component: "System.Output"
  properties:
    text: "${rb('OnTheWay','${size.value}','${type.value}')}" # size.value and type.value are the arguments for the 'OnTheWay' message key.
  transitions:
    return: "done"

Aunque se utilicen grupos de recursos, se sigue utilizando un servicio de traducción para que los usuarios puedan proporcionar entradas en su idioma nativo. Sin embargo, no querrá que los componentes que utilicen los grupos de recursos se traduzcan automáticamente.

Estos son los pasos generales para configurar una aptitud para usar un servicio de traducción para entradas del usuario cuando se utilizan grupos de recursos para las respuestas de la aptitud:

1. Si aún no lo ha hecho, agregue un servicio de traducción a la aptitud.
2. Utilice el componente System.DetectLanguage para determinar el idioma de la entrada del usuario.
3. Aplique los grupos de recursos para manejar las respuestas de la aptitud al usuario.
4. En el caso de componentes que hagan referencia a grupos de recursos, asegúrese de que la traducción automática esté desactivada. Para ello, puede:
   • Utilizar el método inclusivo:
     1. Establezca la variable de contexto autoTranslate en false (o no la establezca).
     2. Defina la propiedad translate en true para System.Intent, System.Text y otros componentes de entrada.
   • Utilizar el método exclusivo:
     1. Establezca la variable de contexto autoTranslate en true.
     2. Sustituya autoTranslate para los componentes que utilicen grupos de recursos (como los componentes System.Output y System.CommonResponse) estableciendo la propiedad translate para esos componentes en false.

     Una desventaja de este método es que puede resultar más difícil observar dónde se ha configurado involuntariamente la traducción automática de un componente que debería utilizar, en su lugar, grupos de recursos.

Si la aptitud usa grupos de recursos para algunos componentes, pero se basa en la traducción automática para otros componentes, puede:

• Establezca la variable de contexto autoTranslate en true.
• Defina la propiedad translate en false para cada componente que utilice un grupo de recursos.

El grupo de recursos que se aplica depende del valor almacenado para las dos variables de contexto de usuario específicas de la ubicación, profile.languageTag y profile.locale. Si se establecen ambas variables, profile.languageTag tiene prioridad.

profile.languageTag se define en el idioma de la entrada del usuario mediante el componente System.DetectLanguage, si se dispone de dicho componente en el flujo de diálogo. El valor de profile.languageTag tiene el formato de un código de idioma de dos caracteres (por ejemplo, en para inglés).

El cliente de mensajería define profile.locale. El valor de profile.locale puede tener el formato idioma-país-variante (por ejemplo, en-AU-sydney), idioma-país (por ejemplo, en-AU) o idioma (por ejemplo, en).

Para resolver el idioma que utilizar, Oracle Digital Assistant busca en primer lugar una coincidencia exacta. Si no la encuentra, amplía incrementalmente la búsqueda hasta que lo consigue. Si sigue sin encontrar ninguna coincidencia, devuelve el idioma por defecto, que es el inglés (en).

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 .

En este enfoque, puede transferir al componente personalizado el nombre de la variable de contexto que contiene la respuesta del componente como parámetro de entrada. Así, se garantiza que los componentes personalizados no dependan de un código de implantación de OBotML específico y que se puedan seguir reutilizando.

initializeReceipt:
  component: "sample.receipt.dataresponse"
  properties:
    dataVariable: "receipt"
    purchaseid: "${purchaseId.value}

printReceipt:
  component: "System.Output"
  properties:
    text:"${receipt.value}"
    translate: true
 ...

...
invoke: (conversation, done) => {
  var responseVariable = conversation.properties().dataVariable;
  var purchaseId = conversation.properties().purchaseId;
  ...
  var message = queryRemoteServiceForReceipt(purchaseId);
  ...
  conversation.variable(responseVariable, message);
  conversation.transition(); 
  done();
}

translateMessage:
  component: "System.TranslateInput"
  properties:
    source: "variable_populated_by_custom_component"
    variable: "translationStringVar"
getIntent:
  component: "System.Intent"
  properties:
    variable: "iResult"
    sourceVariable: "translationStringVar"
...