Vous pouvez diriger le moteur de dialogue sur un chemin spécifique dans le flux de dialogue en définissant la propriété "transitions" pour un état. Les transitions décrivent les branchements possibles dans le dialogue selon les valeurs de variable. Elles vous permettent de définir le cheminement type de la conversation (cas nominal) et de définir d'autres chemins prenant en compte les valeurs manquantes ou un comportement imprévisible de l'utilisateur.

  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"

Vous utilisez la transition next pour spécifier l'état suivant par défaut. Lorsqu'un état combine des transitions error, actions et next, la transition next n'est déclenchée que lorsque le composant ne peut pas retourner de chaîne satisfaisant les 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"

Vous pouvez être amené à fournir aux utilisateurs une option explicite pour quitter temporairement la compétence avec laquelle ils communiquent afin d'effectuer une action dans une deuxième compétence de l'assistant numérique. Par exemple, s'ils sont dans une compétence d'achat et qu'ils ont déjà fait des sélections, vous pouvez afficher un bouton leur permettant de passer à une compétence bancaire (pour s'assurer qu'ils disposent d'assez argent pour l'achat), puis de retourner à la première compétence pour terminer la commande.

Pour ce faire dans un flux de dialogue YAML, vous pouvez configurer une action dans une compétence pour lancer une interaction avec une autre compétence du même assistant numérique, puis retourner au flux initial.

Fonctionnement :

1. Le composant System.CommonResponse permet de proposer à l'utilisateur un bouton pour accéder à une autre compétence.

   Ce bouton est basé sur une action de republication, dans laquelle vous configurez les données utiles afin qu'elles fournissent un énoncé pertinent destinée à la compétence cible. Idéalement, cet énoncé doit contenir le nom d'appel de la compétence cible (pour un appel explicite) afin d'optimiser les chances d'acheminement vers cette compétence. En procédant ainsi, vous codez de façon permanente un énoncé pour déclencher l'intention souhaitée.

   Voici le format de ce code :

   
     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 assurez que la republication est traitée comme un message utilisateur pouvant être acheminé correctement par l'assistant numérique.

   Note
   
   Lorsque vous utilisez system.textReceived de cette façon,system.text est la seule variable que vous pouvez définir dans les données utiles de republication. Toutes les autres variables des données utiles sont ignorées.
2. Vous réglez la transition textReceived à l'état contenant le composant System.Intent.

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

   Cela est nécessaire pour assurer que l'assistant numérique fournisse une réponse de secours appropriée si l'assistant numérique ne contient pas la compétence cible.

   Pour que cela fonctionne, la propriété daIntercept du composant System.Intent de la compétence doit être réglée à "always" (qui est la valeur par défaut).

Si la compétence cible se trouve dans l'assistant numérique, ce dernier reconnaît l'appel explicite, prend le contrôle de la demande (qui devrait normalement être traitée par le composant) et achemine la demande vers le composant System.Intent de la compétence cible. Une fois le flux de la compétence cible terminé, l'utilisateur est ramené à la compétence d'appel.

Si la compétence cible n'est pas dans l'assistant numérique (ou si la compétence d'appel est présentée sans assistant numérique), le composant System.Intent de la compétence d'appel est appelé et l'intention devrait être résolue en unresolvedIntent.

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

Par exemple, voici une intention de commande de pizza (OrderPizza) qui donne à l'utilisateur l'option de vérifier le solde de son compte bancaire avant de passer la commande. Le solde du compte est fourni par une autre compétence (CashBank). Si l'utilisateur sélectionne l'option Check Balance, le texte "Demander à CashBank quel est mon solde" est publié dans l'assistant numérique et l'utilisateur est dirigé vers l'intention appropriée dans la compétence 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
  ...

En supposant que votre compétence de commande de pizza se trouve dans le même assistant numérique que la compétence bancaire, voici ce qui se passe si vous ouvrez l'assistant numérique dans le testeur, accédez à la compétence de commande de pizza, puis cliquez sur Check bank account balance (Vérifier le solde du compte bancaire).

Dans l'onglet Routing (Acheminement) du testeur, vous pouvez voir que l'appel explicite a été reconnu et qu'il passe en priorité :

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

Plus bas, vous pouvez voir que l'intention de vérification du solde de la compétence Cash Bank est mise en correspondance :

Description de l'illustration skill-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 fonction de numérotation automatique à l'échelle globale (ce qui signifie qu'elle affecte tous les composants nommés dans votre définition de flux de dialogue) ou au niveau du composant pour les composants qui déclenchent des actions de republication, à savoir les composants System.List, System.CommonResponse, System.ResolveEntities, System.QnA, System.Webview, System.OAuthAccountLinkComponent et System.OAuth2AccountLinkComponent.