È possibile impostare il motore della finestra di dialogo su un percorso specifico all'interno del flusso della finestra di dialogo impostando la proprietà Transitions per uno stato. Le transizioni descrivono la modalità di fork della finestra di dialogo quando i valori delle variabili sono impostati o non impostati. Permettono di tracciare il percorso tipico attraverso la conversazione (il flusso "felice") e impostare percorsi alternativi che soddisfano i valori mancanti o il comportamento imprevedibile dell'utente.

  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"

La transizione next viene utilizzata per specificare lo stato successivo predefinito. Quando uno stato combina le transizioni error, actions e next, la transizione next viene attivata solo quando il componente non può restituire una stringa che soddisfa una delle transizioni error o 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"

Ci possono essere momenti in cui si desidera fornire agli utenti un'opzione esplicita per lasciare temporaneamente l'abilità con cui sono impegnati per fare qualcosa in una seconda abilità all'interno dello stesso assistente digitale. Ad esempio, se si trovano in un'abilità di acquisto e hanno effettuato alcune selezioni, è possibile visualizzare un pulsante che consente loro di passare a un'abilità bancaria (per assicurarsi di avere abbastanza denaro per l'acquisto) e quindi tornare alla capacità di acquisto per completare il loro ordine.

Per risolvere questo problema in un flusso di dialogo YAML, è possibile configurare un'azione in uno skill per avviare l'interazione con uno skill diverso nello stesso assistente digitale e quindi tornare al flusso originale.

Funzionamento:

1. Il componente System.CommonResponse consente di presentare all'utente un pulsante per eseguire operazioni in un'altra skill.

   Il pulsante si basa su un'azione di postback, in cui si configura il payload per fornire un'espressione diretta verso lo skill di destinazione. Idealmente, quell'espressione dovrebbe contenere il nome di invocazione dell'abilità di destinazione (cioè essere un'invocazione esplicita) al fine di massimizzare la probabilità che si verifichi l'instradamento a tale abilità. In questo modo, è essenzialmente difficile codificare un enunciato per innescare l'intento desiderato.

   Ecco il formato di quel codice:

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

   Utilizzando un'azione system.textReceived e specificando il testo nella variabile system.text, si garantisce che il postback venga considerato come un messaggio utente che può essere instradato correttamente dall'assistente digitale.

   Nota
   
   Quando si utilizza system.textReceived in questo modo, system.text è l'unica variabile che è possibile definire nel payload di postback. Tutte le altre variabili nel payload vengono ignorate.
2. La transizione textReceived viene impostata sullo stato che contiene il componente System.Intent.

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

   Ciò è necessario per garantire che l'assistente digitale fornisca una risposta di fallback appropriata se l'assistente digitale non contiene la competenza di destinazione.

   A tale scopo, è necessario che la proprietà daIntercept del componente System.Intent dello skill sia impostata su "always" (impostazione predefinita).

Se lo skill di destinazione si trova nell'assistente digitale, l'assistente digitale riconosce il richiamo esplicito, assume il controllo della richiesta (che normalmente verrebbe gestita dal componente) e instrada la richiesta al componente System.Intent dello skill di destinazione. Al termine del flusso nello skill di destinazione, l'utente viene riportato allo skill chiamante.

Se lo skill di destinazione non si trova nell'assistente digitale (o lo skill chiamante viene esposto senza un assistente digitale), viene richiamato il componente System.Intent dello skill chiamante e l'intento deve essere risolto in unresolvedIntent.

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

Ad esempio, ecco un intento per ordinare la pizza (OrderPizza) che offre all'utente la possibilità di controllare il saldo del proprio conto bancario prima di completare l'ordine. Il saldo del conto è fornito da una competenza diversa (CashBank). Se l'utente seleziona l'opzione Check Balance, il testo "chiedi a CashBank, qual è il mio saldo" viene inviato all'assistente digitale e l'utente viene indirizzato all'intento appropriato all'interno della competenza 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
  ...

Supponendo che l'abilità pizza si trovi nello stesso assistente digitale dell'abilità Cash Bank, ecco come dovrebbe apparire se si apre l'assistente digitale nel tester, si accede all'abilità pizza e quindi si fa clic su Verifica il saldo del conto bancario.

Nella scheda Instradamento del tester è possibile vedere che il richiamo esplicito è stato riconosciuto e viene data la preferenza:

Descrizione dell'immagine skill-to-skill-routing-explicit.png

Più in basso, è possibile vedere che l'intento Saldo assegno dello skill Cash Bank è abbinato:

Descrizione dell'immagine skill-to-skill-routing-intent.png

Definire la proprietà value dei seguenti componenti con espressioni quali “${user.age.value}” per impostare i valori utente memorizzati.

Per i flussi di dialogo YAML, è possibile impostare la funzione di numerazione automatica su una scala globale (ovvero che influisce su tutti i componenti denominati nella definizione del flusso della finestra di dialogo) o a livello di componente per i componenti che attivano le azioni di postback, ovvero i componenti System.List, System.CommonResponse, System.ResolveEntities, System.QnA, System.Webview, System.OAuthAccountLinkComponent e System.OAuth2AccountLinkComponent.