Beispiel für die Verwendung von autotranslate zum Aktivieren der automatischen Übersetzung für Eingabe und Ausgabe:

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

So können Sie die Eingabe mit autotranslate standardmäßig übersetzen, die Ausgabe aber nicht übersetzen.

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

        output: false

Beispiel für das Festlegen der Eigenschaft translate, sodass sowohl die Eingabe als auch die Ausgabe der Komponente an den für den Skill angegebenen Übersetzungsservice gesendet werden:

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

Beispiel, um nur die Eingabe der Komponente an den Übersetzungsservice zu senden:

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

Für Skills, die im YAML-Dialogmodus entwickelt wurden, gehen Sie wie folgt vor, wenn Sie die zu übersetzenden Komponenten einzeln angeben möchten:

1. Falls noch nicht geschehen, fügen Sie Ihrem Skill einen Übersetzungsservice hinzu.
2. Stellen Sie sicher, dass die Kontextvariable autoTranslate nicht festgelegt (oder auf false gesetzt) ist.
3. Fügen Sie über dem Status der Komponente System.Intent die Komponente System. DetectLanguage hinzu:

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

   Hinweis
   
   Die Eigenschaft useExistingProfileLanguageTag wird verwendet, wenn ein Skill Teil eines digitalen Assistenten ist, der einen Übersetzungsservice hat. Dadurch kann der Skill umgehend die Sprache verwenden, die vom digitalen Assistenten erkannt wird. Andernfalls kann der Skill eine Nachricht oder Eingabeaufforderung auf Englisch bereitstellen, bevor die Sprache (neu) erkannt wird. Wenn sich der Skill nicht in einem übersetzungsfähigen digitalen Assistenten befindet, wird die Eigenschaft ignoriert.
4. Setzen Sie in der Komponente System.Intent die Eigenschaft "translate" auf true.

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

5. Setzen Sie bei anderen Eingabekomponenten auch die Eigenschaft translate auf true, oder setzen Sie das Attribut input der Eigenschaft translate auf true. Beispiel:

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

Bei Skills, die im YAML-Dialogmodus entwickelt wurden, sind die folgenden Schritte zur Verwendung der automatischen Übersetzung standardmäßig (und zur individuellen Angabe von Komponenten, die nicht übersetzt werden sollen) aufgeführt:

1. Falls noch nicht geschehen, fügen Sie Ihrem Skill einen Übersetzungsservice hinzu.
2. Fügen Sie autoTranslate: "map" als Variable zum Knoten context hinzu.

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

3. Fügen Sie im Knoten states oberhalb der Komponente System.Intent eine Komponente System.SetVariable hinzu. Setzen Sie dann die Eigenschaft variable auf die Kontextvariable autoTranslate, und setzen Sie das Attribut input (und optional output) der Eigenschaft value auf true.

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

   Hinweis
   
   Wenn Sie Resource Bundles verwenden, setzen Sie den output-Wert auf false.
4. Fügen Sie für den nächsten Status die Komponente System.DetectLanguage hinzu:

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

   Hinweis
   
   Die Eigenschaft useExistingProfileLanguageTag wird verwendet, wenn ein Skill Teil eines digitalen Assistenten ist, der einen Übersetzungsservice hat. Dadurch kann der Skill umgehend die Sprache verwenden, die vom digitalen Assistenten erkannt wird. Andernfalls kann der Skill eine Nachricht oder Eingabeaufforderung auf Englisch bereitstellen, bevor die Sprache (neu) erkannt wird. Wenn sich der Skill nicht in einem übersetzungsfähigen digitalen Assistenten befindet, wird die Eigenschaft ignoriert.
5. Setzen Sie für alle Komponenten, die nicht automatisch übersetzt werden sollen, die Eigenschaft "translate" auf false. Beispiel:

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

In diesem Beispiel wird die automatische Übersetzung für die Eingabe eingerichtet, aber für die Ausgabe deaktiviert (damit der Ausgabetext in Resource Bundles angegeben werden kann).

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