A continuación, se muestra un ejemplo del uso de autotranslate para activar la traducción automática tanto para la entrada como para la salida:

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

Y aquí se muestra cómo podría utilizar autotranslate para traducir la entrada por defecto, pero no la salida:

  setAutoTranslate:
    component: "System.SetVariable"
    properties:
      variable: "autoTranslate"
      value:
        input: true
        output: false

        output: false

A continuación, se muestra un ejemplo de definición de la propiedad translate para enviar tanto la entrada como la salida del componente al servicio de traducción que se ha especificado para la aptitud:

  askName:
    component: "System.Text"
    properties:   
      prompt: "${rb.askNamePrompt}"
      variable: "name"
      translate: true

A continuación se muestra un ejemplo de envío de la entrada del componente al servicio de traducción:

  askName:
    component: "System.Text"
    properties:   
      prompt: "${rb.askNamePrompt}"
      variable: "name"
      translate:       
        input: true
        output: false

Para las habilidades diseñadas en el modo de diálogo YAML, estos son los pasos si desea 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 otros componentes de entrada, defina también la propiedad translate en true o defina el atributo input de la propiedad translate en true, por ejemplo:

     askName:
       component: "System.Text"
       properties:   
         prompt: "${rb.askNamePrompt}"
         variable: "name"
         translate:       
           input: true
           output: false

metadata:
  platformVersion: "1.0"
main: true
name: "AutoTranslatePizzaJoe"
parameters:
  age: 18
context:
  variables:
    size: "PizzaSize"
    type: "PizzaType"
    crust: "PizzaCrust"
    iResult: "nlpresult" 
states:
  detect:
    component: "System.DetectLanguage"
    properties:
      useExistingProfileLanguageTag: true
    transitions:
      next: "intent"
  intent:
    component: "System.Intent"
    properties:
      variable: "iResult" 
      translate: true
  ShowMenu:
    component: "System.CommonResponse"
    properties:
      processUserMessage: true
      translate:       
        input: true
        output: false
      metadata:
        responseItems:
          - type: "text"
            text: "Hello ${profile.firstName}, this is our menu today:"
            ...
  ...  

Para las aptitudes diseñadas en el modo de diálogo YAML, estos son los pasos para utilizar la traducción automática por defecto (y especificar de forma individual 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: "map" como variable al nodo context.

   context:
     variables:
       ...
       autoTranslate: "map"

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 defina el atributo input (y, opcionalmente, output) de la propiedad value en true.

     setAutoTranslate:
       component: "System.SetVariable"
       properties:
         variable: "autoTranslate"
         value:
           input: true
           output: true
       transitions:
         ...

   Nota
   
   Si está utilizando grupos de recursos, debe definir el valor output en false.
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:       
           input: true
           output: false
       transitions:
         return: "done"

En este ejemplo, la traducción automática está configurada para la entrada, pero está desactivada para la salida (para que el texto de salida se pueda especificar en los grupos de recursos).

metadata:
  platformVersion: "1.0"
main: true
name: "AutoTranslatePizzaJoe"
parameters:
  age: 18
context:
  variables:
    size: "PizzaSize"
    type: "PizzaType"
    crust: "PizzaCrust"
    iResult: "nlpresult"
    autoTranslate: "map" 
states:
  setAutoTranslate:
    component: "System.SetVariable"
    properties:
      variable: "autoTranslate"
      value:
        input: true
        output: false
    transitions:
      next: "detect:
  detect:
    component: "System.DetectLanguage"
    properties:
      useExistingProfileLanguageTag: true
    transitions: 
      ...