Voici un exemple d'utilisation de autotranslate pour activer la traduction automatique pour l'entrée et la sortie :

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

Et voici comment vous pouvez utiliser autotranslate pour traduire l'entrée par défaut, mais pas la sortie :

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

        output: false

Voici un exemple de définition de la propriété translate pour envoyer l'entrée et la sortie du composant au service de traduction qui a été spécifié pour la compétence :

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

Voici un exemple envoyant uniquement l'entrée du composant au service de traduction :

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

Pour les compétences conçues en mode de dialogue YAML, voici les étapes permettant de spécifier individuellement les composants à traduire :

1. Le cas échéant, ajoutez un service de traduction à votre compétence.
2. Assurez-vous que la variable de contexte autoTranslate n'est pas définie (ou est réglée à false).
3. Au-dessus de l'état du composant System.Intent, ajoutez le composant System.DetectLanguage :

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

   Note
   
   La propriété useExistingProfileLanguageTag est utilisée lorsqu'une compétence fait partie d'un assistant numérique doté d'un service de traduction. Ceci permet à la compétence d'utiliser immédiatement la langue détectée par l'assistant numérique. Sinon, la compétence peut fournir un message ou une invite en anglais avant que la langue ne soit détectée (à nouveau). Si la compétence figure dans un assistant numérique ne permettant pas la traduction, la propriété est ignorée.
4. Dans le composant System.Intent, réglez la propriété translate à true.

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

5. Pour les autres composants d'entrée, réglez également la propriété translate à true, ou réglez l'attribut input de la propriété translate à true. Par exemple :

     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:"
            ...
  ...  

Pour les compétences conçues en mode de dialogue YAML, voici les étapes d'utilisation de la traduction automatique par défaut (et spécifiez individuellement les composants à ne pas traduire) :

1. Le cas échéant, ajoutez un service de traduction à votre compétence.
2. Ajoutez la variable autoTranslate: "map" au noeud context.

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

3. Dans le noeud states, au-dessus du composant System.Intent, ajoutez un composant System.SetVariable. Ensuite, définissez la propriété variable afin qu'elle utilise la variable de contexte autotranslate et réglez l'attribut input (et, facultativement, output) de la propriété value à true.

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

   Note
   
   Si vous utilisez des ensembles de ressources, réglez la valeur output à false.
4. Pour l'état suivant, ajoutez le composant System.DetectLanguage :

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

   Note
   
   La propriété useExistingProfileLanguageTag est utilisée lorsqu'une compétence fait partie d'un assistant numérique doté d'un service de traduction. Ceci permet à la compétence d'utiliser immédiatement la langue détectée par l'assistant numérique. Sinon, la compétence peut fournir un message ou une invite en anglais avant que la langue ne soit détectée (à nouveau). Si la compétence figure dans un assistant numérique ne permettant pas la traduction, la propriété est ignorée.
5. Pour tous les composants à ne pas traduire, réglez la propriété translate à false, par exemple :

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

Dans cet exemple, la traduction automatique est configurée pour l'entrée, mais elle est désactivée pour la sortie (le texte de sortie peut donc être spécifié dans les ensembles de ressources).

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: 
      ...