Flujos

Los diálogos complejos suelen incluir varios temas de conversación. Por ejemplo, un agente de entrega de pizzas puede tener el pedido de comida, la información del cliente y la confirmación como temas diferentes. 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.

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:

Página de inicio de referencia en las solicitudes a la API

Para hacer referencia a la página de inicio de un flujo en las solicitudes de la API del entorno de ejecución, usa START_PAGE como ID de página.

Para realizar cambios en el tiempo de diseño en una página de inicio a través de la API, usa los métodos de la API 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++ FlowsClient No disponible
C# FlowsClient No disponible
Go FlowsClient No disponible
Java FlowsClient FlowsClient
Node.js FlowsClient FlowsClient
PHP No disponible No disponible
Python FlowsClient FlowsClient
Ruby No disponible No disponible

Crea un flujo

Para crear un flujo, sigue estos pasos:

Console

  1. Abre la consola de Dialogflow CX.
  2. Elige tu proyecto de Google Cloud.
  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++ FlowsClient No disponible
C# FlowsClient No disponible
Go FlowsClient 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 Google Cloud 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++ FlowsClient No disponible
C# FlowsClient No disponible
Go FlowsClient 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++ PagesClient No disponible
C# PagesClient No disponible
Go PagesClient 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:

Para obtener más información sobre cómo se aplican los datos en diferentes niveles, consulta los niveles de aplicación de datos.

Configuración del flujo

La siguiente configuración está disponible para los flujos:

Para obtener más información sobre cómo se aplican los datos en diferentes niveles, consulta los niveles de aplicación de datos.

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

Console

  1. Abre la consola de Dialogflow CX.
  2. Elige tu proyecto de Google Cloud.
  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++ FlowsClient No disponible
C# FlowsClient No disponible
Go FlowsClient 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 Google Cloud.
  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++ FlowsClient No disponible
C# FlowsClient No disponible
Go FlowsClient 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 Google Cloud.
  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++ FlowsClient No disponible
C# FlowsClient No disponible
Go FlowsClient 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

Puedes exportar un flujo de dos maneras:

  • Exportación de datos: Esta opción exporta tu flujo como datos sin procesar para que se pueda importar a cualquier agente. Cuando exportas un flujo, también se exportan los recursos a los que hace referencia el flujo (intents, entidades y webhooks). Cuando sigas los pasos que se indican a continuación, elige el formato de datos sin procesar.

  • Exportación de diagrama (Versión preliminar): Esta opción exporta tu flujo como un diagrama visual. El formato de exportación es XML de draw.io, así que puedes importar el diagrama en Lucidchart, diagrams.net o cualquier otra herramienta de diagramas que pueda importar el formato de draw.io. Cuando sigas los pasos que se indican a continuación, elige el formato de datos XML.

Puedes exportar un flujo con las siguientes opciones:

  • Incluir flujos a los que se hace referencia: Exporta el flujo de destino y todos los niveles de los flujos a los que se hace referencia. Los flujos a los que se hace referencia incluyen los flujos a los que hace referencia el flujo de destino, además de los flujos a los que hacen referencia los flujos posteriores, sin profundidad máxima. Durante la importación, se importarán todos los flujos exportados y se conservarán las transiciones entre estos flujos.

Para exportar un flujo, sigue estos pasos:

Console

  1. Abre la consola de Dialogflow CX.
  2. Elige tu proyecto de Google Cloud.
  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++ FlowsClient No disponible
C# FlowsClient No disponible
Go FlowsClient No disponible
Java FlowsClient FlowsClient
Node.js FlowsClient FlowsClient
PHP No disponible No disponible
Python FlowsClient FlowsClient
Ruby No disponible No disponible

Importa un flujo

Cuando importas un flujo de un agente de origen a un agente de destino, los recursos globales a los que hace referencia el flujo (intents, entidades y webhooks) se importan junto con los datos específicos del flujo. Si el agente de destino tiene recursos globales con los mismos nombres visibles que se encuentran en el agente de origen, los agentes conversacionales (Dialogflow CX) proporcionan un resumen de estos recursos, junto con tres opciones para resolver los conflictos de estos recursos:

  • Reemplaza los recursos existentes: Los recursos del agente de origen reemplazarán los recursos del agente de destino.
  • Importar como recursos nuevos: Los recursos del agente de origen se agregarán con un sufijo distintivo en el nombre.
  • Keep original resources: Los recursos del agente de destino no se modificarán.

Para importar un flujo, sigue estos pasos:

Console

  1. Abre la consola de Dialogflow CX.
  2. Elige tu proyecto de Google Cloud.
  3. Selecciona el agente.
  4. Haz clic en el botón Agregar  de la sección Flujos.
  5. Selecciona Importar flujo.
  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++ FlowsClient No disponible
C# FlowsClient No disponible
Go FlowsClient No disponible
Java FlowsClient FlowsClient
Node.js FlowsClient FlowsClient
PHP No disponible No disponible
Python FlowsClient FlowsClient
Ruby No disponible No disponible