Sie können die Dialog-Engine auf einen bestimmten Pfad im Dialogablauf setzen, indem Sie die Übergangseigenschaft für einen Status festlegen. Übergänge beschreiben, wie sich der Dialog verzweigt, wenn Variablenwerte festgelegt sind oder nicht. Mit ihnen können Sie die typische Route der Unterhaltung (den "Happy Flow") darstellen und alternative Routen festlegen, die fehlende Werte oder unvorhersehbares Benutzerverhalten aufgreifen.

  unresolved:
    component: "System.Output"
    properties:
      text: "Sorry! I don't understand that question!"
    transitions:
      return: "unresolved"

transitions:
    error: "handleMe"

transitions:
  actions:
    error: "handleMe"

state_name:
  component: "component name"
  properties:
    component_property: "value"
    component_proprety: "value"
  transitions:
    next: "go_to_state"
    error: "go_to_error_handler"
    actions:
      action_string1: "go_to_state1"
      action_string2: "go_to_state2"

Mit dem Übergang next geben Sie den nächsten Standardstatus an. Wenn ein Status die Übergänge error, actions und next kombiniert, wird der Übergang next nur ausgelöst, wenn die Komponente keine Zeichenfolge zurückgeben kann, die den Übergang error oder actions erfüllt.

context:
  variables:
    name: "string"
defaultTransitions:
  next: "nextRules"
states: 
  getName:
    component: "System.Text"
    properties:
      prompt: "What's your name please?"
      variable: "name"
    transitions: 
      next: "printName"
  printName:
    component: "System.Output"
    properties:
      text: "Hello ${name.value}." 
    transitions:
      return: "done"
  nextRules:
    component: "System.Output"
    properties:
      text: "Hello ${name.value}. I told you! Next transitions rule the game!" 
    transitions:
      return: "done"

In bestimmten Situationen möchten Sie Benutzern unter Umständen die Möglichkeit geben, den Skill vorübergehend zu verlassen, mit dem sie gerade interagieren, um einen Vorgang in einem zweiten Skill innerhalb desselben digitalen Assistenten auszuführen. Beispiel: Wenn Benutzer einen Shoppingskill verwenden, in dem sie bereits Artikel ausgewählt haben, könnten Sie eine Schaltfläche anzeigen, mit dem Benutzer zu einem Bankingskill wechseln (um sicherzustellen, dass sie genügend Geld für den Einkauf haben) und dann zum Shoppingskill zurückkehren können, um die Bestellung abzuschließen.

Dazu können Sie in einem YAML-Dialogablauf eine Aktion in einem Skill konfigurieren, um die Interaktion mit einem anderen Skill in demselben digitalen Assistenten zu initiieren und dann zum ursprünglichen Ablauf zurückzukehren.

Funktionsweise:

1. Mit der Komponente System.CommonResponse stellen Sie dem Benutzer eine Schaltfläche zur Verfügung, um Aufgaben in einem anderen Skill auszuführen.

   Die Schaltfläche basiert auf einer Postback-Aktion, in der Sie die Payload so konfigurieren, dass sie eine Äußerung tätigt, die an den Zielskill geleitet wird. Idealerweise sollte diese Äußerung den Aufrufnamen des Zielskills (d.h. einen expliziten Aufruf) enthalten, um die Wahrscheinlichkeit zu erhöhen, dass ein Routing an diesen Skill erfolgt. Dadurch können Sie im Wesentlichen eine Äußerung hartcodieren, um das gewünschte Intent auszulösen.

   Format dieses Codes:

   
     component: "System.CommonResponse"
     properties:
       metadata:
       ...
         responseItems:
           - type: "cards"
             ...
             actions:
                 ...
               - label: "Press me to switch to different skill"
                 type: "postback"
                 payload:
                   action: "system.textReceived"
                   variables:
                     system.text: "utterance with invocation name that you want passed to the digital assistant"
                   ...

   Wenn Sie die system.textReceived-Aktion verwenden und den Text in der Variable system.text angeben, stellen Sie sicher, dass der Postback wie eine Benutzernachricht behandelt wird, die vom digitalen Assistenten ordnungsgemäß weitergeleitet werden kann.

   Hinweis
   
   Wenn Sie system.textReceived auf diese Weise verwenden, ist system.text die einzige Variable, die Sie in der Postback Payload definieren können. Alle anderen Variablen in der Payload werden ignoriert.
2. Setzen Sie den textReceived-Übergang auf den Status mit der Komponente System.Intent.

   
     transitions:
       actions:
         ....
         textReceived: "Name of the state for the System.Intent component"

   So wird sichergestellt, dass der digitale Assistent eine geeignete Fallback-Antwort ausgibt, wenn der digitale Assistent den Zielskill nicht enthält.

   Dazu muss die Eigenschaft daIntercept der Komponente System.Intent des Skills auf "always" (der Standardwert) gesetzt sein.

Wenn der Zielskill im digitalen Assistenten enthalten ist, erkennt der digitale Assistent den expliziten Aufruf, übernimmt die Kontrolle über die Anforderung (die normalerweise von der Komponente verarbeitet wird) und leitet die Anforderung an die System.Intent-Komponente des Zielskills weiter. Sobald der Ablauf des Zielskills abgeschlossen ist, wird der Benutzer an den aufrufenden Skill zurückgeleitet.

Wenn der Zielskill nicht im digitalen Assistenten enthalten ist (oder der aufrufende Skill ohne einen digitalen Assistenten bereitgestellt wird), wird die Komponente System.Intent des aufrufenden Skills aufgerufen, und das Intent sollte als unresolvedIntent aufgelöst werden.

system.text: "ask  ${system.config.daCrcPizzaFinSkillInvocationName}, what is my balance"

Beispiel: Nachfolgend ist ein Intent zum Bestellen von Pizza (OrderPizza) dargestellt, mit dem der Benutzer sein Bankkontensaldo prüfen kann, bevor er seine Bestellung abschließt. Der Kontensaldo wird durch einen anderen Skill bereitgestellt (CashBank). Wenn der Benutzer die Option Saldo prüfen auswählt, wird der Text "Frage CashBank nach meinem Saldo" per Postback an den digitalen Assistenten übertragen, und der Benutzer wird zum entsprechenden Intent im CashBank-Skill weitergeleitet.

OrderPizza:
  component: "System.CommonResponse"
  properties:
    metadata:
    ...
      responseItems:
        - type: "cards"
          headerText: "Our pizzas:"
          cardLayout: "vertical"
          name: "PizzaCards"
          actions:
            - label: "More Pizzas"
              ...
            - label: "Check bank account balance"
              type: "postback"
              payload:
                action: "system.textReceived"
                variables:
                  system.text: "ask CashBank, do I have enough money?"
                ...
    processUserMessage: true
  transitions:
    actions:
      order: "AskPizzaSize"
      more: "OrderPizza"
      textReceived: "Intent" # where the value of textReceived is the name CashBank's System.Intent state
  ...

Angenommen, Ihr Pizzaskill befindet sich in demselben digitalen Assistenten wie der CashBank-Skill. Im folgenden Beispiel wird gezeigt, wie Sie den digitalen Assistenten im Tester öffnen, den Pizzaskill aufrufen und dann auf Bankkontensaldo prüfen klicken.

Auf der Registerkarte "Routing" des Testers können Sie sehen, dass der explizite Aufruf erkannt wurde und vorrangig behandelt wird:

Beschreibung der Abbildung skill-skill-routing-explicit.png

Unten können Sie sehen, dass für das Intent "Saldo prüfen" des CashBank-Skills eine Übereinstimmung vorliegt:

Beschreibung der Abbildung skill-skill-routing-intent.png

Definieren Sie die value-Eigenschaft der folgenden Komponenten mit Ausdrücken wie "${user.age.value}", um gespeicherte Benutzerwerte festzulegen.

Bei YAML-Dialogabläufen können Sie das Feature für die automatische Nummerierung auf globaler Ebene festlegen (d.h. es wirkt sich auf alle Komponenten aus, die in der Dialogablaufdefinition benannt sind) oder auf Komponentenebene für die Komponenten, die Postback-Aktionen auslösen, nämlich die Komponenten System.List, System.CommonResponse, System.ResolveEntities, System.QnA, System.Webview, System.OAuthAccountLinkComponent und System.OAuth2AccountLinkComponent.