Se usó la API de Cloud Translation para traducir esta página.
Switch to English

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. Cualquier respuesta que proporciona la entrega se agrega a la cola 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á. 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.
  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.
  5. Los mensajes de la cola de respuestas 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 para tu página.
  7. Haz clic en el botón de configuración junto al nombre 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 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: 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:

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