Flows

Los diálogos complejos suelen incluir varios temas de conversación. Por ejemplo, un agente de entrega de pizza puede tener pedido de comida, información del cliente y confirmación como temas distintos. Cada tema necesita varios turnos de conversación para que un agente obtenga la información relevante del usuario final.

Los flujos se usan para definir estos temas y las rutas de conversación asociadas. Cada agente tiene un flujo llamado Flujo de inicio predeterminado. Este flujo único puede ser todo lo que necesitas para un agente simple. Los agentes más complicados pueden requerir flujos adicionales, y los diferentes miembros del equipo de desarrollo pueden ser responsables de compilar y mantener estos flujos. Por ejemplo, los flujos de un agente de entrega de pizzas podrían ser algo parecido a lo siguiente:

Diagrama de varios flujos de ejemplo.

Los flujos de Dialogflow CX tienen un propósito similar al de los agentes secundarios para los agentes combinados de Dialogflow ES. Los flujos proporcionan un mejor control de la conversación y no generan costos adicionales.

Flujo de inicio predeterminado

Cuando creas un agente, el Flujo de inicio predeterminado se crea automáticamente. Para un agente simple, puedes usar este flujo como tu único flujo. Para agentes más complejos, puedes agregar más flujos y el flujo de inicio predeterminado se puede usar como un punto de entrada simple para la conversación.

Cuando usas la API, puedes hacer referencia al flujo de inicio predeterminado con el siguiente ID de flujo:

00000000-0000-0000-0000-000000000000

Página de inicio del flujo

Cada flujo tiene una página especial llamada Inicio en la consola. Cuando se selecciona un flujo en la consola, la página de inicio se muestra como un nodo en el grafo. Al principio, cuando un flujo se activa, esta página se convierte en la página activa actual.

Una página de inicio no tiene parámetros ni mensajes de respuesta, como las páginas regulares. Sin embargo, puedes enviar un mensaje con uno de los siguientes enfoques:

Cuando usas la API, puedes hacer referencia a la página de inicio de un flujo con el siguiente ID de página:

START_PAGE

Crea un flujo

Para crear un flujo, sigue estos pasos:

Console

  1. Abre la consola de Dialogflow CX.
  2. Elige tu proyecto de GCP.
  3. Selecciona el agente.
  4. Haz clic en el botón Agregar  de la sección Flujos.
  5. Selecciona Crear flujo.
  6. Ingresa un nombre visible para el flujo.
  7. Haz clic en el flujo que acabas de crear.

API

Consulta el método create para el tipo Flow.

Selecciona un protocolo y una versión para la referencia de flujo:

Protocolo V3 V3beta1
REST Recurso de flujo Recurso de flujo
RPC Interfaz de flujo Interfaz de flujo
C# No disponible No disponible
Go No disponible No disponible
Java FlowsClient FlowsClient
Node.js FlowsClient FlowsClient
PHP No disponible No disponible
Python FlowsClient FlowsClient
Ruby No disponible No disponible

Datos de flujo

Para acceder a los datos de un flujo, sigue estos pasos:

Console

  1. Abre la consola de Dialogflow CX.
  2. Elige el proyecto de GCP para el agente.
  3. Busca el agente en la lista.
  4. Haz clic en el nombre visible del agente.
  5. Haz clic en el flujo en la sección Flujos.
  6. Las páginas del flujo se propagan en la sección Páginas. Consulta la guía de páginas para obtener información sobre cómo editar páginas.
  7. Haz clic en el flujo del grafo.
  8. Aparecerá un panel de edición del flujo. Usa este panel para explorar y editar datos de flujo adicionales.
  9. Haz clic en Guardar a fin de guardar los cambios.

API

Para flujos, consulta get y patch/update para el tipo de Flow.

Selecciona un protocolo y una versión para la referencia de flujo:

Protocolo V3 V3beta1
REST Recurso de flujo Recurso de flujo
RPC Interfaz de flujo Interfaz de flujo
C# No disponible No disponible
Go No disponible No disponible
Java FlowsClient FlowsClient
Node.js FlowsClient FlowsClient
PHP No disponible No disponible
Python FlowsClient FlowsClient
Ruby No disponible No disponible
Para las páginas, consulta los métodos get y patch/update para el tipo de 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 a los flujos:

Configuración del flujo

Las siguientes opciones de configuración están disponibles para los flujos:

  • Nombre visible: Un nombre legible para el flujo.
  • Descripción: Una descripción para el flujo.
  • Configuración del AA: También se accede a la configuración del AA de flujo y se describe en la configuración de AA del agente.
  • Configuración avanzada de voz: Esta configuración de voz puede anular la misma configuración de voz del agente.

Para acceder a la configuración del flujo, sigue estos pasos:

Console

  1. Abre la consola de Dialogflow CX.
  2. Elige tu proyecto de GCP.
  3. Selecciona el agente.
  4. Desplaza el mouse sobre el flujo en la sección Flujos.
  5. Haz clic en el botón de opciones .
  6. Selecciona la Configuración de flujo.
  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 Flow.

Selecciona un protocolo y una versión para la referencia de flujo:

Protocolo V3 V3beta1
REST Recurso de flujo Recurso de flujo
RPC Interfaz de flujo Interfaz de flujo
C# No disponible No disponible
Go No disponible No disponible
Java FlowsClient FlowsClient
Node.js FlowsClient FlowsClient
PHP No disponible No disponible
Python FlowsClient FlowsClient
Ruby No disponible No disponible

Borra un flujo

Para borrar un flujo, sigue estos pasos:

Console

  1. Abre la consola de Dialogflow CX.
  2. Elige tu proyecto de GCP.
  3. Selecciona el agente.
  4. Desplaza el mouse sobre el flujo en la sección Flujos.
  5. Haz clic en el botón de configuración .
  6. Selecciona Borrar.

API

Consulta el método delete para el tipo Flow.

Selecciona un protocolo y una versión para la referencia de flujo:

Protocolo V3 V3beta1
REST Recurso de flujo Recurso de flujo
RPC Interfaz de flujo Interfaz de flujo
C# No disponible No disponible
Go No disponible No disponible
Java FlowsClient FlowsClient
Node.js FlowsClient FlowsClient
PHP No disponible No disponible
Python FlowsClient FlowsClient
Ruby No disponible No disponible

Entrena un flujo

Para entrenar un flujo, sigue estos pasos:

Console

  1. Abre la consola de Dialogflow CX.
  2. Elige tu proyecto de GCP.
  3. Selecciona el agente.
  4. Haz clic en Configuración del agente.
  5. Abre la pestaña AA.
  6. Para entrenar un solo flujo, haz clic en Entrenar en la fila correspondiente.
  7. Para entrenar varios flujos, selecciónalos con las casillas de verificación y, luego, haz clic en Entrenar modelo de CLN de flujo seleccionado.

API

Consulta el método train para el tipo Flow.

Selecciona un protocolo y una versión para la referencia de flujo:

Protocolo V3 V3beta1
REST Recurso de flujo Recurso de flujo
RPC Interfaz de flujo Interfaz de flujo
C# No disponible No disponible
Go No disponible No disponible
Java FlowsClient FlowsClient
Node.js FlowsClient FlowsClient
PHP No disponible No disponible
Python FlowsClient FlowsClient
Ruby No disponible No disponible

Exporta un flujo

Para exportar un flujo, haz lo siguiente:

Console

  1. Abre la consola de Dialogflow CX.
  2. Elige tu proyecto de GCP.
  3. Selecciona el agente.
  4. Desplaza el mouse sobre el flujo en la sección Flujos.
  5. Haz clic en el botón de opciones .
  6. Selecciona Exportar flujo.
  7. Sigue las instrucciones para finalizar.

API

Consulta el método export para el tipo Flow.

Selecciona un protocolo y una versión para la referencia de flujo:

Protocolo V3 V3beta1
REST Recurso de flujo Recurso de flujo
RPC Interfaz de flujo Interfaz de flujo
C# No disponible No disponible
Go No disponible No disponible
Java FlowsClient FlowsClient
Node.js FlowsClient FlowsClient
PHP No disponible No disponible
Python FlowsClient FlowsClient
Ruby No disponible No disponible

Cómo importar un flujo

Para importar un flujo, haz lo siguiente:

Console

  1. Abre la consola de Dialogflow CX.
  2. Elige tu proyecto de GCP.
  3. Selecciona el agente.
  4. Haz clic en el botón Agregar  de la sección Flujos.
  5. Selecciona Import Flow.
  6. Sigue las instrucciones para finalizar.

API

Consulta el método import para el tipo Flow.

Selecciona un protocolo y una versión para la referencia de flujo:

Protocolo V3 V3beta1
REST Recurso de flujo Recurso de flujo
RPC Interfaz de flujo Interfaz de flujo
C# No disponible No disponible
Go No disponible No disponible
Java FlowsClient FlowsClient
Node.js FlowsClient FlowsClient
PHP No disponible No disponible
Python FlowsClient FlowsClient
Ruby No disponible No disponible