Puede establecer el motor de diálogo en una ruta específica del flujo de diálogo estableciendo la propiedad de transiciones de un estado. Las transiciones describen cómo se ramifica el cuadro de diálogo cuando se definen valores de variables o no. Permiten trazar la ruta típica de la conversación (el flujo “feliz”) y definir rutas alternativas que den cabida a valores que faltan o a comportamientos impredecibles del usuario.

  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"

Utilice la transición next para especificar el siguiente estado por defecto. Si un estado combina transiciones error, actions y next, la transición next solo se dispara si el componente no puede devolver una cadena que cumpla las transiciones 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"

En ocasiones, es posible que quiera que los usuarios tengan la opción de dejar temporalmente la aptitud con la que están interactuando para realizar otra tarea en una segunda aptitud dentro del asistente digital. Por ejemplo, si el usuario está interactuando con una aptitud de compra y ya ha hecho alguna elección, usted podría motrar un botón que le permitiera pasar a una aptitud bancaria (para asegurarse de que tiene suficiente dinero para la compra) y, a continuación, volver a la aptitud de compra para finalizar la orden.

Para abordar esto en un flujo de diálogo de YAML, puede configurar una acción en una aptitud para iniciar la interacción con otra aptitud del mismo asistente digital y, a continuación, volver al flujo original.

Así es como funciona:

1. Utilice el componente System.CommonResponse para presentar al usuario un botón para realizar una tarea en otra aptitud.

   El botón se basa en una acción de devolución, en la que se configura la carga útil para proporcionar una expresión que se dirige a la aptitud de destino. Lo ideal es que la expresión contenga el nombre de llamada de la aptitud de destino (es decir, una llamada explícita), con el fin de maximizar la probabilidad de que se produzca el enrutamiento a dicha aptitud. Al hacer esto, básicamente se codifica una expresión para disparar la intención deseada.

   Este es el formato del 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"
                   ...

   Al utilizar una acción system.textReceived y especificar el texto en la variable system.text, se asegura de que la devolución sea tratada como un mensaje de usuario que el asistente digital puede encaminar correctamente.

   Nota
   
   Cuando utilice system.textReceived de esta manera, system.text es la única variable que puede definir de la carga útil de devolución. Se ignoran todas las demás variables de la carga útil.
2. Defina la transición textReceived en el estado que contiene el componente System.Intent.

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

   Es necesario hacerlo así para garantizar que el asistente digital proporcione una respuesta de reserva adecuada si el asistente digital no contiene la aptitud de destino.

   Para que esto funcione, el componente System.Intent de la aptitud debe tener la propiedad daIntercept definida en "always" (que es el valor por defecto).

Si la aptitud de destino está en el asistente digital, este reconoce la llamada explícita, toma el control de la solicitud (que normalmente sería gestionada por el componente) y encamina la solicitud al componente System.Intent de la aptitud de destino. Una vez finalizado el flujo en la aptitud de destino, el usuario vuelve a la aptitud de llamada.

Si la aptitud de destino no se encuentra en el asistente digital (o la aptitud de llamada se expone sin un asistente digital), se llama al componente System.Intent de la aptitud de llamada y la intención se resuelve en unresolvedIntent.

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

Por ejemplo, a continuación se muestra una intención para pedir una pizza (OrderPizza) que ofrece al usuario la opción de comprobar el saldo de su cuenta bancaria antes de completar el pedido. El saldo de la cuenta lo proporciona otra aptitud (CashBank). Si el usuario selecciona la opción Check Balance, el texto "consultar a CashBank mi saldo" se publica de nuevo en el asistente digital y el usuario se encamina a la intención adecuada en la aptitud 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
  ...

Siempre que la aptitud Pizza se encuentre en el mismo asistente digital que la aptitud CashBank, este es el aspecto que debería tener si se abre el asistente digital en el comprobador, se accede a la aptitud Pizza y, a continuación, se hace clic en Comprobar saldo de cuenta bancaria.

En el separador Enrutamiento del comprobador, puede ver que se ha reconocido la llamada explícita y que se le ha dado prioridad:

Descripción de la ilustración Skill-routing-explicit.png

Más abajo, puede ver que la intención Check Balance de la aptitud Cash Bank se ha pareado:

Descripción de la ilustración Skill-routing-intent.png

Defina la propiedad value de los siguientes componentes con expresiones como “${user.age.value}” para definir los valores de usuario almacenados.

Para los flujos de diálogo de YAML, puede definir la función de numeración automática en una escala global (lo que significa que afecta a todos los componentes especificados en la definición del flujo de diálogo) o a nivel de componente para los componentes que disparan acciones de devolución, es decir, los componentes System.List, System.CommonResponse, System.ResolveEntities, System.QnA, System.Webview, System.OAuthAccountLinkComponent y System.OAuth2AccountLinkComponent.