Vous pouvez définir le moteur de dialogue sur un parcours spécifique du flux de dialogue en définissant la propriété des transitions d'un état. Les transitions décrivent comment le dialogue s'oriente selon que des valeurs de variable sont définies ou non. Elles permettent de tracer l'acheminement classique à travers la conversation (le flux idéal) et de définir d'autres acheminements qui prennent en charge les valeurs manquantes ou les comportements utilisateur imprévisibles.

  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"

Utilisez la transition next pour indiquer l'état suivant par défaut. Lorsqu'un état combine les transitions error, actions et next, la transition next est déclenchée uniquement lorsque le composant ne peut pas renvoyer de chaîne répondant à l'une des transitions error ou actions.

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"

Il est parfois utile de proposer aux utilisateurs une possibilité de quitter temporairement la brique afin de réaliser une tâche dans une autre brique du même assistant numérique. Par exemple, si les utilisateurs se trouvent dans une brique permettant de réaliser des achats et qu'ils ont sélectionné quelques articles, vous pouvez afficher un bouton qui leur permet de passer à une brique bancaire (pour s'assurer qu'ils disposent de suffisamment d'argent pour l'achat), puis revenir à la brique d'achat pour terminer leur commande.

Pour résoudre ce problème dans un flux de dialogue YAML, vous pouvez configurer une action dans une brique de façon à initier une interaction avec une autre brique dans le même assistant numérique, puis à revenir au flux initial.

Voici comment cela fonctionne :

1. Vous utilisez le composant System.CommonResponse pour présenter à l'utilisateur un bouton lui permettant d'effectuer une action dans une autre brique.

   Le bouton est basé sur une action de postback, dans laquelle vous configurez la charge utile afin de fournir une variation orientée vers la brique cible. Dans l'idéal, la variation doit contenir le nom d'appel de la brique cible (appel explicite) afin d'optimiser la probabilité de l'acheminement vers cette brique. Ainsi, vous pouvez coder en dur une variation de façon à déclencher l'intention voulue.

   Le format de ce code est le suivant :

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

   En utilisant une action system.textReceived et en spécifiant le texte dans la variable system.text, vous vous assurez que le postback est traité comme un message utilisateur pouvant être correctement acheminé par l'assistant numérique.

   Remarque
   
   Lorsque vous utilisez system.textReceived de cette manière, system.text est la seule variable que vous pouvez définir dans la charge utile de postback. Toutes les autres variables de la charge utile sont ignorées.
2. Vous définissez la transition textReceived sur l'état contenant le composant System.Intent.

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

   Cela est nécessaire pour veiller à ce que l'assistant numérique fournisse une réponse de secours appropriée si l'assistant numérique ne comporte pas la brique cible.

   Pour que cela fonctionne, dans le composant System.Intent, la propriété daIntercept de la brique doit être définie sur "always" (valeur par défaut).

Si la brique cible figure dans l'assistant numérique, celui-ci reconnaît l'appel explicite, prend le contrôle de la demande (qui serait normalement gérée par le composant) et achemine la demande vers le composant System.Intent de la brique cible. Une fois que le flux de la brique cible est terminé, l'utilisateur est renvoyé à la brique qui a émis l'appel.

Si la brique cible ne figure pas dans l'assistant numérique (ou si la brique qui émet l'appel est mise à disposition sans assistant numérique), le composant System.Intent de la brique qui émet l'appel est appelé et l'intention est résolue en unresolvedIntent.

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

Par exemple, voici une intention permettant de commander une pizza (OrderPizza) qui offre à l'utilisateur la possibilité de vérifier le solde de son compte bancaire avant de terminer sa commande. Le solde du compte est fourni par une autre brique (CashBank). Si l'utilisateur sélectionne l'option Check Balance, le texte "ask CashBank, what is my balance" est soumis à l'assistant numérique et l'utilisateur est acheminé vers l'intention appropriée de la brique CashBank.

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

Si la brique Pizza se trouve dans le même assistant numérique que la brique Cash Bank, voici ce que vous devriez voir si vous ouvrez l'assistant numérique dans le testeur, accédez à la brique Pizza et cliquez sur Check bank account balance.

Dans l'onglet Acheminement du testeur, vous pouvez voir que l'appel explicite a été reconnu et qu'une priorité lui a été accordée :

Description de l'illustration Skills-skill-routing-explicit.png

Plus bas, vous pouvez également voir que l'intention Check Balance de la brique Cash Bank est mise en correspondance :

Description de l'illustration Skills-skill-routing-intent.png

Définissez la propriété value des composants suivants avec des expressions telles que “${user.age.value}” pour définir les valeurs utilisateur stockées.

Pour les flux de dialogue YAML, vous pouvez définir la fonctionnalité de numérotation automatique à l'échelle globale (elle s'appliquera donc à tous les composants nommés dans la définition de flux de dialogue) ou au niveau des composants qui déclenchent des actions de postback, à savoir les composants System.List, System.CommonResponse, System.ResolveEntities, System.QnA, System.Webview, System.OAuthAccountLinkComponent et System.OAuth2AccountLinkComponent.