Ecco un esempio di utilizzo di autotranslate per attivare la traduzione automatica sia per l'input che per l'output:

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

Ecco come è possibile utilizzare autotranslate per tradurre l'input per impostazione predefinita, ma non l'output:

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

        output: false

Di seguito è riportato un esempio di impostazione della proprietà translate per inviare sia l'input che l'output del componente al servizio di traduzione specificato per la competenza.

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

Ed ecco un esempio di invio solo dell'input del componente al servizio di traduzione:

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

Per le competenze progettate in modalità finestra di dialogo YAML, ecco i passaggi se si desidera specificare singolarmente i componenti da tradurre:

1. Se non lo si è già fatto, aggiungere un servizio di traduzione alle proprie competenze.
2. Assicurarsi che la variabile di contesto autoTranslate non sia impostata (o sia impostata su false).
3. Al di sopra dello stato del componente System.Intent, aggiungere il componente System.DetectLanguage:

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

   Nota
   
   La proprietà useExistingProfileLanguageTag viene utilizzata quando uno skill fa parte di un assistente digitale che dispone di un servizio di traduzione. Ciò consente di utilizzare immediatamente la lingua rilevata dall'assistente digitale. In caso contrario, l'abilità potrebbe fornire un messaggio o un prompt in inglese prima che la lingua venga (ri)rilevata. Se lo skill non si trova in un assistente digitale abilitato alla traduzione, la proprietà viene ignorata.
4. Nel componente System.Intent, impostare la proprietà di traduzione su true.

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

5. Per altri componenti di input, impostare anche la proprietà translate property su true oppure impostare l'attributo input della proprietà translate su true, ad esempio:

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

Per le competenze progettate in modalità finestra di dialogo YAML, ecco i passi per utilizzare la traduzione automatica per impostazione predefinita (e specificare singolarmente i componenti da non tradurre):

1. Se non lo si è già fatto, aggiungere un servizio di traduzione alle proprie competenze.
2. Aggiungere autoTranslate: "map" come variabile al nodo context.

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

3. All'interno del nodo states, sopra il componente System.Intent, aggiungere un componente System.SetVariable. Impostare quindi la proprietà variable in modo che utilizzi la variabile di contesto autoTranslate e impostare l'attributo input (e, facoltativamente, output) della proprietà value su true.

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

   Nota
   
   Se si utilizzano i bundle di risorse, impostare il valore output su false.
4. Per lo stato successivo, aggiungere il componente System.DetectLanguage:

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

   Nota
   
   La proprietà useExistingProfileLanguageTag viene utilizzata quando uno skill fa parte di un assistente digitale che dispone di un servizio di traduzione. Ciò consente di utilizzare immediatamente la lingua rilevata dall'assistente digitale. In caso contrario, l'abilità potrebbe fornire un messaggio o un prompt in inglese prima che la lingua venga (ri)rilevata. Se lo skill non si trova in un assistente digitale abilitato alla traduzione, la proprietà viene ignorata.
5. Per i componenti che non si desidera tradurre automaticamente, vedere la proprietà di traduzione in false, ad esempio:

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

In questo esempio, la traduzione automatica è impostata per l'input, ma è disattivata per l'output (in modo che il testo di output possa essere specificato nei bundle di risorse).

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