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:
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:
- Propagación del intent
- Usa una condición
truesencilla en una ruta que tenga una respuesta de entrega o un objetivo de transición a una página normal con entrega. - Eventos personalizados
Página de inicio de referencia en solicitudes a la API
Para hacer referencia a la página de inicio de un flujo en solicitudes a la API de entorno de ejecución, usa START_PAGE como ID de página.
Para realizar cambios durante el 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 |
| Rita | No disponible | No disponible |
Crea un flujo
Para crear un flujo, sigue estos pasos:
Console
- Abre la consola de Dialogflow CX.
- Elige tu proyecto de Google Cloud.
- Selecciona el agente.
- Haz clic en el botón Agregar add de la sección Flujos.
- Selecciona Crear flujo.
- Ingresa un nombre visible para el flujo.
- 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 |
| Rita | No disponible | No disponible |
Datos de flujo
Para acceder a los datos de un flujo, sigue estos pasos:
Console
- Abre la consola de Dialogflow CX.
- Elige el proyecto de Google Cloud para el agente.
- Busca el agente en la lista.
- Haz clic en el nombre visible del agente.
- Haz clic en el flujo en la sección Flujos.
- 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.
- Haz clic en el flujo del grafo.
- Aparecerá un panel de edición del flujo. Usa este panel para explorar y editar datos de flujo adicionales.
- 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 |
| Rita | No disponible | No disponible |
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 |
| Rita | No disponible | No disponible |
Los siguientes datos están asociados a los flujos:
- Páginas: La lista de páginas que conforman el flujo.
- Rutas: Se puede llamar a todas las rutas cuando la página de inicio del flujo está activa. Se pueden seguir las rutas con un requisito de intent cuando otras páginas del flujo están activas. Para obtener más detalles, consulta Alcance del controlador de estado y Rutas a nivel de flujo.
- Controladores de eventos: Se puede llamar a estos controladores cuando el flujo está activo. Para obtener detalles, consulta Controladores de eventos a nivel de flujo.
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:
- Nombre visible: Es un nombre legible para el flujo.
- Descripción: Es una descripción del flujo.
- Configuración del AA: También se accede y se describe la configuración del AA del flujo en la configuración del AA del agente.
- Detección automática de idioma: La detección automática de idioma te permite especificar los idiomas del usuario final que Dialogflow debería reconocer y responder automáticamente. Consulta la documentación sobre detección automática de idiomas para obtener más detalles.
- Configuración avanzada de voz: De manera opcional, esta configuración puede anular la misma configuración de voz del agente.
- Configuración de la adaptación de voz: Es la configuración de la adaptación de voz a nivel de flujo con instrucciones más detalladas en la adaptación de voz manual.
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
- Abre la consola de Dialogflow CX.
- Elige tu proyecto de Google Cloud.
- Selecciona el agente.
- Desplaza el mouse sobre el flujo en la sección Flujos.
- Haz clic en el botón de opciones more_vert.
- Selecciona la Configuración de flujo.
- 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 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 |
| Rita | No disponible | No disponible |
Borra un flujo
Para borrar un flujo, sigue estos pasos:
Console
- Abre la consola de Dialogflow CX.
- Elige tu proyecto de Google Cloud.
- Selecciona el agente.
- Desplaza el mouse sobre el flujo en la sección Flujos.
- Haz clic en el botón de configuración more_vert.
- 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 |
| Rita | No disponible | No disponible |
Entrena un flujo
Para entrenar un flujo, sigue estos pasos:
Console
- Abre la consola de Dialogflow CX.
- Elige tu proyecto de Google Cloud.
- Selecciona el agente.
- Haz clic en Configuración del agente.
- Abre la pestaña AA.
- Para entrenar un solo flujo, haz clic en Entrenar en la fila correspondiente.
- 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 |
| Rita | No disponible | No disponible |
Exporta un flujo
Puedes exportar un flujo de dos maneras:
Exportación de datos: Exporta tu flujo como datos sin procesar, por lo que puedes importarlos 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 a continuación, elige el formato de datos de datos sin procesar.
Exportación de diagramas (Vista previa): Se exporta el flujo como un diagrama visual. El formato de exportación es XML draw.io, por lo que puedes importar el diagrama en Lucidchart, diagrams.net o en cualquier otra herramienta de diagrama que pueda importar el formato 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 los flujos referenciados: Exporta el flujo de destino y todos los niveles de los flujos a los que se hace referencia. Los flujos referenciados incluyen aquellos a los que el flujo de destino hace referencia, además de aquellos a los que se hace referencia en los flujos a los que se hace referencia posteriormente, sin profundidad máxima. Durante la importación, se importarán todos los flujos exportados y se preservarán las transiciones entre estos flujos.
Para exportar un flujo, sigue estos pasos:
Console
- Abre la consola de Dialogflow CX.
- Elige tu proyecto de Google Cloud.
- Selecciona el agente.
- Desplaza el mouse sobre el flujo en la sección Flujos.
- Haz clic en el botón de opciones more_vert.
- Selecciona Exportar flujo.
- 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 |
| Rita | 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, 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, Dialogflow proporciona un resumen de estos recursos, junto con tres opciones para resolver los conflictos de estos recursos:
- Reemplazar 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.
- Conservar los recursos originales: Los recursos del agente de destino no se modificarán.
Para importar un flujo, sigue estos pasos:
Console
- Abre la consola de Dialogflow CX.
- Elige tu proyecto de Google Cloud.
- Selecciona el agente.
- Haz clic en el botón Agregar add de la sección Flujos.
- Selecciona Importar flujo.
- 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 |
| Rita | No disponible | No disponible |