Pages

Una conversación de Dialogflow CX (sesión) se puede describir y visualizar como una máquina de estado. Los estados de una sesión de CX se representan por páginas.

Para cada flujo, debes definir muchas páginas, en las que tus páginas combinadas pueden controlar una conversación completa sobre los temas para los que se diseñó el flujo. En un momento determinado, exactamente una página es la página actual, esta se considera activa y el flujo asociado a esa página se considera activa. Cada flujo tiene una página de inicio especial. Cuando un flujo se activa al principio, la página actual se convierte en la página de inicio. En cada turno de la conversación, la página actual se mantendrá igual o pasará a otra página.

Configura cada página a fin de recopilar información del usuario final que sea relevante para el estado de conversación que representa la página. Por ejemplo, puedes crear las páginas (en azul) en el siguiente diagrama para un flujo de pedido de comida de un agente de entrega de pizzas. El nodo de Inicio del diagrama representa la página de inicio del flujo del Pedido de comida. Cuando se completa el flujo, se transfiere al flujo de Confirmación.

Diagrama de varios flujos de ejemplo.

Ciclo de vida de una página

Una vez que se activa una página, el agente sigue varios pasos que pueden implicar la entrega de entradas, el llenado de formularios, la evaluación del controlador de estado, el mensaje del parámetro de formulario, el envío de mensajes de respuesta al usuario final y un cambio de página o un bucle de repetición:

Diagrama del ciclo de vida de la página.

Los detalles de este proceso son los siguientes:

  1. Si existe la entrega de entrada para la página, se llama. Todas las respuestas estáticas que proporciona la entrega se agregan a la lista de respuestas.

    Si la respuesta parcial está habilitada, Dialogflow limpia la cola de respuesta y envía todos los mensajes en cola como una respuesta parcial al emisor de la API de transmisión.

    Si la entrega tiene un webhook, se llama al webhook, lo que puede agregar respuestas adicionales a la cola. Estas respuestas adicionales no activan una limpieza inmediata de la lista de respuestas.

  2. Si la página tiene parámetros de formulario, puede completarse de forma previa:

  3. Si existen controladores de estado dentro del alcance, se evalúan según las reglas de orden de evaluación del controlador. Esto puede incluir rutas, controladores de eventos o controladores de solicitudes nuevas invocados desde la iteración del bucle anterior. Si se llama a un controlador de estado, puede ocurrir una de las siguientes situaciones, o ambas:

    • Si existe una entrega para el controlador, se llamará. Todas las respuestas estáticas que proporciona la entrega se agregan a la lista de respuestas. La respuesta parcial y el webhook también se ejecutan si están habilitados.
    • Si existe un flujo o una página de destino para el controlador, la sesión pasa al destino y la página se vuelve inactiva.
  4. Si todos los siguientes son verdaderos, se agrega un mensaje de parámetro de formulario a la cola de respuesta:

    • La página tiene un formulario.
    • Existen parámetros del formulario obligatorios para completar.
    • No se siguió un controlador de solicitud nueva en el paso 3.
    • La respuesta parcial y el webhook se ejecutan si están habilitados.
  5. Los mensajes de la cola de respuesta restantes se envían al usuario final y el agente espera la entrada del usuario final.

  6. Si la entrada del usuario final proporciona un parámetro de formulario solicitado, llena el parámetro. Continúa con el paso 3.

Crea una página

Para crear una página, sigue estos pasos:

Console

  1. Abre la consola de Dialogflow CX.
  2. Elige tu proyecto de GCP.
  3. Selecciona el agente.
  4. Selecciona el flujo de la página en la sección Flujos.
  5. Haz clic en el botón Agregar  de la sección Páginas.
  6. Ingresa un nombre visible para tu página.
  7. Haz clic en el botón de configuración junto al nombre visible de la página.
  8. Selecciona Editar.
  9. Ingresa los campos en el panel de edición de la página que aparecerá.
  10. Haga clic en Save.

API

Consulta el método create para el tipo Page.

Selecciona un protocolo y una versión para la Referencia de la página:

Protocolo V3 V3beta1
REST Recurso de la página Recurso de la página
RPC Interfaz de la página Interfaz de la página
C# No disponible No disponible
Go No disponible No disponible
Java PagesClient PagesClient
Node.js PagesClient PagesClient
PHP No disponible No disponible
Python PagesClient PagesClient
Ruby No disponible No disponible

Datos de la página

Para acceder a los datos de una página, sigue estos pasos:

Console

  1. Abre la consola de Dialogflow CX.
  2. Elige el proyecto de GCP para el agente.
  3. Selecciona el agente.
  4. Haz clic en el flujo en la sección Flujos.
  5. Las páginas del flujo se propagan en la sección Páginas.
  6. Haz clic en el botón de configuración junto al nombre visible de la página.
  7. Selecciona Editar.
  8. Ingresa los campos en el panel de edición de la página que aparecerá.
  9. Haz clic en Guardar a fin de guardar los cambios.

API

Consulta los métodos get y patch/update para el tipo Page.

Selecciona un protocolo y una versión para la Referencia de la página:

Protocolo V3 V3beta1
REST Recurso de la página Recurso de la página
RPC Interfaz de la página Interfaz de la página
C# No disponible No disponible
Go No disponible No disponible
Java PagesClient PagesClient
Node.js PagesClient PagesClient
PHP No disponible No disponible
Python PagesClient PagesClient
Ruby No disponible No disponible

Los siguientes datos están asociados con las páginas:

  • Nombre visible: Es un nombre legible de tu página.
  • Entrega de entrada (también conocida como división de entrada): Es la entrega que se debe llamar cuando la página se inicia inicialmente. se active.
  • Parámetros: Son los valores del parámetro en un formulario de página que capturan entradas estructuradas del usuario final.
  • Rutas: Se puede llamar a estos controladores de estado cuando está activa la página. Consulta Rutas de controladores a nivel de página para obtener detalles.
  • Grupos de rutas: Se puede llamar a las rutas dentro de estos grupos cuando está activa la página. Consulta Grupos de rutas para obtener detalles.
  • Controladores de eventos: Se puede llamar a estos controladores de eventos cuando está activa la página. Para obtener más información, consulta Controladores de eventos a nivel de página.

Configuración de la página

Las siguientes opciones de configuración están disponibles para las páginas:

Sigue estos pasos para acceder a la configuración de la página:

Console

  1. Abre la consola de Dialogflow CX.
  2. Elige tu proyecto de GCP.
  3. Selecciona el agente.
  4. Desplaza el mouse sobre la página en la sección Páginas.
  5. Haz clic en el botón de opciones .
  6. Selecciona Configuración de la página.
  7. Explora o edita la configuración.
  8. Haz clic en Guardar a fin de guardar los cambios.

API

Consulta los métodos get y patch/update para el tipo Page.

Selecciona un protocolo y una versión para la Referencia de la página:

Protocolo V3 V3beta1
REST Recurso de la página Recurso de la página
RPC Interfaz de la página Interfaz de la página
C# No disponible No disponible
Go No disponible No disponible
Java PagesClient PagesClient
Node.js PagesClient PagesClient
PHP No disponible No disponible
Python PagesClient PagesClient
Ruby No disponible No disponible

Borra una página

Para borrar una página, sigue estos pasos:

Console

  1. Abre la consola de Dialogflow CX.
  2. Elige tu proyecto de GCP.
  3. Selecciona el agente.
  4. Selecciona el flujo de la página en la sección Flujos.
  5. Haz clic en el botón de configuración junto al nombre visible de la página en la sección Páginas.
  6. Selecciona Borrar.

API

Consulta el método delete para el tipo Page.

Selecciona un protocolo y una versión para la Referencia de la página:

Protocolo V3 V3beta1
REST Recurso de la página Recurso de la página
RPC Interfaz de la página Interfaz de la página
C# No disponible No disponible
Go No disponible No disponible
Java PagesClient PagesClient
Node.js PagesClient PagesClient
PHP No disponible No disponible
Python PagesClient PagesClient
Ruby No disponible No disponible