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.
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:
Los detalles de este proceso son los siguientes:
- Si existe la entrega de entrada para la página, se llama. Cualquier respuesta que proporciona la entrega se agrega a la cola de respuestas.
Si la página tiene parámetros de formulario, puede completarse de forma previa:
- Cualquier parámetro de sesión establecido con el mismo nombre que un parámetro de formulario se copia en el parámetro de formulario.
- Si una ruta activó una transición a esta página y la ruta contiene un intent coincidente, se copia cualquier parámetro de intent con el mismo nombre que un parámetro de formulario en el parámetro de formulario.
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á. Cualquier respuesta que proporciona la entrega se agrega a la cola de respuestas.
- 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.
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.
Los mensajes de la cola de respuestas se envían al usuario final y el agente espera la entrada del usuario final.
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
- Abre la consola de Dialogflow CX.
- Elige tu proyecto de GCP.
- Selecciona el agente.
- Selecciona el flujo de la página en la sección Flujos.
- Haz clic en el botón Agregar add de la sección Páginas.
- Ingresa un nombre para tu página.
- Haz clic en el botón de configuración more_vert junto al nombre de la página.
- Selecciona Editar.
- Ingresa los campos en el panel de edición de la página que aparecerá.
- 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
- Abre la consola de Dialogflow CX.
- Elige el proyecto de GCP para el agente.
- Selecciona el agente.
- Haz clic en el flujo en la sección Flujos.
- Las páginas del flujo se propagan en la sección Páginas.
- Haz clic en el botón de configuración more_vert junto al nombre de la página.
- Selecciona Editar.
- Ingresa los campos en el panel de edición de la página que aparecerá.
- 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: Un nombre visible para el flujo.
- Entrega de entradas (también conocida como Diálogo de entrada): Esta es la entrega que se debe llamar cuando la página inicialmente se activa.
- 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:
- Configuración de voz avanzada: Opcionalmente, esta configuración de voz puede anular la misma configuración de voz del flujo y la configuración de voz del agente.
Sigue estos pasos para acceder a la configuración de la página:
Console
- Abre la consola de Dialogflow CX.
- Elige tu proyecto de GCP.
- Selecciona el agente.
- Desplaza el mouse sobre la página en la sección Páginas.
- Haz clic en el botón de opciones more_vert.
- Selecciona Configuración de la página.
- Explora o edita la configuración.
- 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
- Abre la consola de Dialogflow CX.
- Elige tu proyecto de GCP.
- Selecciona el agente.
- Selecciona el flujo de la página en la sección Flujos.
- Haz clic en el botón de configuración more_vert junto al nombre de la página en la sección Páginas.
- 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 |