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 solicitudes a la API

Para hacer referencia a la página de inicio de un flujo en las solicitudes de la API 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.

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:

  • 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 deben reconocer y responder automáticamente los agentes conversacionales (Dialogflow CX). Consulta la documentación sobre la detección automática de idiomas para obtener más detalles.
  • 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. No se pueden crear, editar ni borrar versiones.
    3. No se pueden crear, editar ni borrar grupos de rutas a nivel del flujo.
    4. Los grupos de rutas a nivel del agente a los que hace referencia un flujo bloqueado o cualquier página de un flujo bloqueado no se pueden borrar, pero sí se pueden editar.
  • Configuración avanzada de voz: De manera opcional, esta configuración avanzada de voz puede anular la misma 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 la adaptación de voz manual.

  • Parámetros de entrada: 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 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, por lo que se puede 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 de datos sin procesar.

  • Exportación de diagramas (versión preliminar): Esta opción exporta tu flujo como un diagrama visual. El formato de exportación es XML de draw.io, por lo 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:

  • Include referenced flows: 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 a los que se hace referencia posteriores, sin profundidad máxima. Durante la importación, se importarán todos los flujos exportados y se conservarán las transiciones entre ellos.

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 fuente 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, Conversational Agents (Dialogflow CX) proporciona un resumen de estos recursos, junto con tres opciones para resolver los conflictos relacionados con ellos:

  • 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 de origen 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 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