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

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

Voici comment utiliser la variable 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 indiqué pour la brique :

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

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

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

Pour les briques conçues en mode dialogue YAML, voici les étapes pour spécifier individuellement les composants à traduire :

1. Si vous ne l'avez pas encore fait, ajoutez un service de traduction à votre brique.
2. Assurez-vous que la variable de contexte autoTranslate n'est pas définie (ou est définie sur false).
3. Au-dessus de l'état du composant System.Intent, ajoutez le composant System.DetectLanguage :

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

   Remarque
   
   La propriété useExistingProfileLanguageTag est utilisée lorsqu'une brique fait partie d'un assistant numérique disposant d'un service de traduction. La brique peut ainsi utiliser immédiatement la langue détectée par l'assistant numérique. Sinon, la brique peut indiquer un message ou une invite en anglais avant que la langue ne soit (re)détectée. Si la brique ne figure pas dans un assistant numérique compatible avec la traduction, la propriété est ignorée.
4. Dans le composant System.Intent, définissez la propriété translate sur true.

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

5. Pour les autres composants d'entrée, définissez également la propriété translate sur true, ou définissez l'attribut input de la propriété translate sur 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 briques conçues en mode de dialogue YAML, voici les étapes à suivre pour utiliser la traduction automatique par défaut (et spécifier individuellement les composants à ne pas traduire) :

1. Si vous ne l'avez pas encore fait, ajoutez un service de traduction à votre brique.
2. Ajoutez autoTranslate: "map" en tant que variable au noeud context.

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

3. Dans le noeud states, au-dessus du composant System.Intent, ajoutez un composant System.SetVariable. Définissez ensuite la propriété variable de façon à utiliser la variable de contexte autoTranslate, et définissez l'attribut input (et éventuellement output) de la propriété value sur true.

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

   Remarque
   
   Si vous utilisez des groupes de ressources, vous devez définir la valeur output sur false.
4. Ajoutez le composant System.DetectLanguage pour l'état suivant :

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

   Remarque
   
   La propriété useExistingProfileLanguageTag est utilisée lorsqu'une brique fait partie d'un assistant numérique disposant d'un service de traduction. La brique peut ainsi utiliser immédiatement la langue détectée par l'assistant numérique. Sinon, la brique peut indiquer un message ou une invite en anglais avant que la langue ne soit (re)détectée. Si la brique ne figure pas dans un assistant numérique compatible avec la traduction, la propriété est ignorée.
5. Pour les composants à ne pas traduire automatiquement, assurez-vous de définir la propriété translate sur 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 (afin que le texte de sortie puisse être spécifié dans les groupes 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: 
      ...