Você pode definir o mecanismo de caixa de diálogo em um caminho específico no fluxo de caixas de diálogo, definindo a propriedade de transições para um estado. As transições descrevem como a caixa de diálogo é bifurcada quando valores de variáveis são definidos ou não. Elas permitem traçar a rota típica por meio da conversa (o fluxo “feliz”) e definir rotas alternativas que acomodem valores ausentes ou comportamento imprevisível do usuário.

  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"

Use a transição next para especificar o próximo estado padrão. Quando um estado combina as transições error, actions e next, a transição next só é acionada quando o componente não consegue retornar uma string que satisfaz a uma das transições 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"

Pode acontecer de você desejar fornecer aos usuários a opção explícita de deixar temporariamente a habilidade com a qual eles estão envolvidos para fazer algo em uma segunda habilidade no assistente digital. Por exemplo, se eles estiverem em uma habilidade de compra e tiverem feito algumas seleções, você poderá exibir um botão que permita a eles passar para uma habilidade de banco (para verificar se eles têm dinheiro suficiente para a compra) e, em seguida, retornar à habilidade de compra para concluir um pedido.

Para tratar isso em um fluxo de caixas de diálogo YAML, você pode configurar uma ação em uma habilidade para iniciar a interação com outra habilidade no mesmo assistente digital e depois retornar ao fluxo original.

Veja como funciona:

1. Use o componente System.CommonResponse para apresentar ao usuário um botão para fazer algo em outra habilidade.

   O botão se baseia em uma ação de postback, na qual você configura o payload para fornecer uma declaração direcionada para a habilidade de destino. O ideal é que a declaração contenha o nome de chamada da habilidade de destino (isto é, ser uma chamada explícita) para maximizar a probabilidade de que o roteamento para essa habilidade ocorrerá. Ao fazer isso, você essencialmente codifica uma declaração para acionar a intenção desejada.

   Veja o formato desse código:

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

   Usando uma ação system.textReceived e especificando o texto na variável system.text, você garante que o postback seja tratado como mensagem do usuário que pode ser roteada corretamente pelo assistente digital.

   Observação
   
   Quando você usa system.textReceived dessa forma,system.text é a única variável que você pode definir no payload de postback. Todas as outras variáveis no payload são ignoradas.
2. Você define a transição textReceived para o estado que contém o componente System.Intent.

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

   Isso é necessário para garantir que o assistente digital forneça uma resposta de fallback apropriada se o assistente digital não contiver a habilidade de destino.

   Para que isso funcione, o componente System.Intent da habilidade deve ter sua propriedade daIntercept definida como "always" (que é o padrão).

Se a habilidade de destino estiver no assistente digital, ele reconhecerá a chamada explícita, assumirá o controle da solicitação (que normalmente seria tratada pelo componente) e roteará a solicitação para o componente System.Intent da habilidade de destino. Quando o fluxo na habilidade de destino for finalizado, o usuário será retornado para a habilidade de chamada.

Se a habilidade de destino não estiver no assistente digital (ou a habilidade de chamada for exposta sem um assistente digital), o componente System.Intent da habilidade de chamada será chamado e a intenção deverá ser resolvida como unresolvedIntent.

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

Por exemplo, aqui está uma intenção para pedir uma pizza (OrderPizza) que dá ao usuário a opção de verificar o saldo da conta bancária antes de fechar o pedido. O saldo da conta é fornecido por outra habilidade (CashBank). Se o usuário selecionar a opção Check Balance, o texto "ask CashBank, what is my balance" será postado novamente no assistente digital e o usuário será roteado para a intenção apropriada na habilidade 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
  ...

Supondo que sua habilidade de pizza esteja no mesmo assistente digital da habilidade Cash Bank, veja o que aconteceria se você abrisse o assistente digital no testador, acessasse a habilidade de pizza e, em seguida, clicasse em Verificar saldo da conta bancária.

Na guia Roteamento do testador, você pode ver que a chamada explícita foi reconhecida e tem a preferência:

Descrição da ilustração hábil-habilidade-roteamento-explicit.png

Posteriormente, você poderá ver que a intenção Verificar Saldo da habilidade Cash Bank tem correspondência:

Descrição da ilustração hábil-habilidade-roteamento-intent.png

Defina a propriedade value dos componentes a seguir com expressões como “${user.age.value}” para definir valores de usuário armazenados.

Para fluxos de caixas de diálogo YAML, você pode definir a funcionalidade de numeração automática em escala global (o que significa que ela afeta todos os componentes nomeados em sua definição de fluxo de caixas de diálogo) ou no nível do componente para os componentes que disparam ações de postback, ou seja, os componentes System.List, System.CommonResponse, System.ResolveEntities, System.QnA, System.Webview, System.OAuthAccountLinkComponent e System.OAuth2AccountLinkComponent.