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:
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 las solicitudes a la API del entorno de ejecución, usa START_PAGE como
el ID de la página.
Para realizar cambios durante el diseño en una página de inicio a través de la API, usa get y
Métodos patch/update de la API 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
- 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 |
| Ruby | 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 |
| Ruby | 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 |
| Ruby | 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 en qué idiomas de usuario final los agentes de conversación (Dialogflow CX) deberían reconocer y responder automáticamente. Consulta la documentación sobre la detección automática de idiomas para conocer los detalles.
Bloqueo de flujo: No se puede editar un flujo bloqueado, incluidos los siguientes cambios en sus recursos secundarios:
- No se pueden crear, editar ni borrar páginas.
- No se pueden crear, editar ni borrar versiones.
- Grupos de rutas de nivel de flujo no se pueden crear, editar ni borrar.
- Grupos de rutas a nivel de agente a las que haga referencia un flujo bloqueado o cualquier página de un flujo bloqueado pero aún se pueden editar.
Configuración de voz avanzada: Estos parámetros de configuración de voz avanzada opcionalmente puede anular el mismo configuración de voz del agente.
Configuración de adaptación de voz: Configuración de adaptación de voz a nivel del flujo con instrucciones más detalladas en 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 |
| Ruby | 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 |
| Ruby | 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 |
| 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 dibujo.io por lo que puedes importar el diagrama en Lucidchart, diagrams.net, o cualquier otra herramienta de diagrama que pueda importar el formatodraw.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 referenciados incluyen aquellos a los que hace referencia el flujo de destino, además de aquellos a los que hacen referencia los flujos posteriores, sin profundidad máxima. Durante la importación, se importarán todos los flujos exportados y 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 |
| Ruby | No disponible | No disponible |
Importa un flujo
Cuando importas un flujo de un agente de origen a un agente de destino, se importan los recursos globales a los que hace referencia el flujo (intents, entidades y webhooks) 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
- 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 |
| Ruby | No disponible | No disponible |