次に、autotranslateを使用して入力と出力両方の自動翻訳を有効にする例を示します:

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

次に、autotranslateを使用して、入力はデフォルトで翻訳し、出力は翻訳しない方法を示します。

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

        output: false

コンポーネントの入力と出力の両方をスキルに指定されている翻訳サービスに送信するようにtranslateプロパティを設定する例を次に示します:

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

次に、コンポーネントの入力のみを翻訳サービスに送信する例を示します:

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

YAMLダイアログ・モードで設計されたスキルの場合、翻訳するコンポーネントを個別に指定する場合のステップを次に示します:

1. まだ実行していない場合は、翻訳サービスをスキルに追加します。
2. autoTranslateコンテキスト変数が設定されていない(またはfalseに設定されている)ことを確認します。
3. System.Intentコンポーネントの状態の上に、System.DetectLanguageコンポーネントを追加します:

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

   ノート
   
   useExistingProfileLanguageTagプロパティは、スキルが翻訳サービスを含むデジタル・アシスタントの一部である場合に使用されます。これにより、スキルはデジタル・アシスタントによって検出された言語をすぐに使用できます。そうでない場合は、言語が(再)検出される前に、スキルではメッセージやプロンプトが英語で提示される可能性があります。スキルが翻訳対応のデジタル・アシスタントにない場合、このプロパティは無視されます。
4. System.Intentコンポーネントで、translateプロパティをtrueに設定します。

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

5. その他の入力コンポーネントについても同様に、translateプロパティをtrueに設定するか、translateプロパティのinput属性をtrueに設定します。次に例を示します:

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

YAMLダイアログ・モードで設計されたスキルの場合、自動翻訳をデフォルトで使用するためのステップは次のとおりです(変換しないコンポーネントを個別に指定します)。

1. まだ実行していない場合は、翻訳サービスをスキルに追加します。
2. contextノードに変数としてautoTranslate: "map"を追加します。

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

3. statesノード内のSystem.Intentコンポーネントの上に、System.SetVariableコンポーネントを追加します。次に、autoTranslateコンテキスト変数を使用するようにvariableプロパティを設定し、valueプロパティのinput(およびオプションでoutput)属性をtrueに設定します。

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

   ノート
   
   リソース・バンドルを使用している場合は、output値をfalseに設定します。
4. 次の状態に対して、System.DetectLanguageコンポーネントを追加します:

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

   ノート
   
   useExistingProfileLanguageTagプロパティは、スキルが翻訳サービスを含むデジタル・アシスタントの一部である場合に使用されます。これにより、スキルはデジタル・アシスタントによって検出された言語をすぐに使用できます。そうでない場合は、言語が(再)検出される前に、スキルではメッセージやプロンプトが英語で提示される可能性があります。スキルが翻訳対応のデジタル・アシスタントにない場合、このプロパティは無視されます。
5. 自動翻訳が不要なコンポーネントについては、translateプロパティをfalseに設定します。例:

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

この例では、自動翻訳が入力に設定されていますが、出力に対してはオフになっています(出力テキストはリソース・バンドルに指定できます)。

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