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:

Flujo de inicio predeterminado

El Flujo de inicio predeterminado se crea automáticamente cuando inicializas un agente. Puede servir como el único flujo para agentes simples o como el punto de entrada inicial para agentes más complejos que incorporan varios flujos.

Note: No se puede borrar el Flujo de inicio predeterminado.

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 incluye una página Inicio, que se representa como un nodo en el gráfico de la consola cuando se selecciona el flujo. Esta página se convierte en la página activa cuando se activa el flujo.

A diferencia de las páginas estándar, una página de inicio no tiene parámetros ni mensajes de respuesta. Aun así, puedes enviar un mensaje con uno de los siguientes métodos:

• Propagación del intent
• Usa una condición true sencilla en una ruta que tenga una respuesta de entrega o un objetivo de transición a una página normal con entrega.
• Eventos personalizados

Cómo hacer referencia a una página de inicio en las solicitudes a la API

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

Para realizar cambios en tiempo de diseño en una página de inicio a través de la API, usa los métodos de la API de get y patch/update para el tipo Flow.

Ir a la referencia de la API de flujo

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

Cerrar

Crea un flujo

Para crear un flujo, sigue estos pasos:

Console

1. Abre la consola de Dialogflow CX.
2. Elige tu proyecto.
3. Busca el agente en la lista.
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. Ir a la referencia de la API de flujo

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

Cerrar

Datos de flujo

Para acceder a los datos del flujo, sigue estos pasos:

Console

1. Abre la consola de Dialogflow CX.
2. Elige tu proyecto.
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. Para obtener información sobre cómo editar una página, consulta la guía de 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. Ir a la referencia de la API de flujo

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

Cerrar

Para las páginas, consulta los métodos get y patch/update para el tipo de Page. Ir a la referencia de la API de la página

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

Cerrar

Los siguientes datos están asociados a los flujos:

• Páginas: Son las páginas que componen el flujo.
• Rutas: Rutas disponibles cuando la página de inicio del flujo está activa. Las rutas basadas en intents también se pueden activar mientras 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: Son controladores a los que se puede llamar cuando el flujo está activo. Para obtener más información, 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 del 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 en los que Dialogflow CX debería reconocer y responder automáticamente. Para obtener más detalles, consulta Agentes multilingües.

• Bloqueo de flujo: No se puede editar un flujo bloqueado, incluidos los siguientes cambios en sus recursos secundarios:

  1. No se pueden crear, editar ni borrar páginas.
  2. Las versiones no se pueden crear, editar ni borrar.
  3. Los grupos de rutas a nivel del flujo no se pueden crear, editar ni borrar.
  4. No se pueden borrar los grupos de rutas a nivel del agente a los que hace referencia un flujo bloqueado o cualquier página de un flujo bloqueado, pero sí se pueden editar.
  Nota: Este parámetro de configuración no se puede cambiar si el bloqueo está habilitado a nivel del agente.

• Configuración avanzada de voz: Esta configuración avanzada de voz puede anular de forma opcional la misma configuración de voz del agente.

• Configuración de adaptación de voz: Es la configuración de adaptación de voz a nivel del flujo. Para obtener más información, consulta Adaptación de voz manual.

• Parámetros de entrada: Son parámetros del manual de estrategias de la tarea que están disponibles para el flujo.

• Parámetros de devolución: Son los parámetros que el flujo devuelve a un manual de estrategias de tareas.

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.
3. Busca el agente en la lista.
4. Mantén el puntero 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. Ir a la referencia de la API de flujo

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

Cerrar

Borra un flujo

Para borrar un flujo, sigue estos pasos:

Console

1. Abre la consola de Dialogflow CX.
2. Elige tu proyecto.
3. Busca el agente en la lista.
4. Mantén el puntero 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. Ir a la referencia de la API de flujo

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

Cerrar

Entrena un flujo

Para entrenar un flujo, sigue estos pasos:

Console

1. Abre la consola de Dialogflow CX.
2. Elige tu proyecto.
3. Busca el agente en la lista.
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. Ir a la referencia de la API de flujo

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

Cerrar

Exporta un flujo

Puedes exportar un flujo de dos maneras:

• Exportación de datos: Exporta tu flujo como datos sin procesar para importarlos a cualquier agente. Los recursos a los que hace referencia el flujo (intents, entidades y webhooks) se incluyen en la exportación. Selecciona el formato de datos sin procesar cuando sigas los pasos que se indican a continuación.

• Exportación de diagramas (versión preliminar): Exporta tu flujo como un diagrama visual en formato XML de draw.io, que se puede importar a herramientas como Lucidchart o diagrams.net. Selecciona el formato de datos XML cuando sigas los pasos que se indican a continuación.

  Nota: La exportación de diagramas no está disponible para los agentes que usan la CMEK.

Puedes exportar un flujo con las siguientes opciones:

• Incluir flujos a los que se hace referencia: Exporta el flujo de destino y todos los flujos a los que se hace referencia de forma recursiva sin profundidad máxima. Todos los flujos exportados y sus transiciones se conservan durante la importación.

Para exportar un flujo, sigue estos pasos:

Console

1. Abre la consola de Dialogflow CX.
2. Elige tu proyecto.
3. Busca el agente en la lista.
4. Mantén el puntero 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. Ir a la referencia de la API de flujo

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

Cerrar

Importa un flujo

Cuando importas un flujo de un agente fuente a un agente de destino, también se importan sus recursos globales a los que se hace referencia, como intents, entidades y webhooks. Si el agente de destino tiene recursos con los mismos nombres visibles, Dialogflow CX muestra un resumen y ofrece tres opciones para resolver los conflictos:

• Reemplazar recursos existentes: Los recursos del agente de origen reemplazarán los recursos del agente de destino.
• Importar como recursos nuevos: Los recursos del agente fuente se agregarán con un sufijo distintivo en el nombre.
• Conservar recursos originales: 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.
3. Busca el agente en la lista.
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. Ir a la referencia de la API de flujo

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

Cerrar