Agentes basados en flujos

Si antes eras usuario de Dialogflow CX, es posible que desees reutilizar tus flujos existentes mientras creas agentes nuevos de forma gradual con CX Agent Studio.

Puedes crear un agente basado en flujo que entregue la conversación al flujo hasta que llegue a END_SESSION. En ese momento, la conversación se devuelve a tu agente de CX Agent Studio que inició el agente basado en flujo.

Las aplicaciones de agentes de CX Agent Studio envían la entrada del usuario a los flujos con el método de la API de DetectIntent. Para la entrada de voz, las aplicaciones de agentes de CX Agent Studio controlan la TTS y la STT para estas interacciones.

Con la consola, puedes definir cómo se envían los datos de ida y vuelta entre la aplicación de tu agente y los flujos.

Configura permisos

Para que la aplicación de tu agente tenga permisos para llamar a tu flujo de Dialogflow CX, debes proporcionar al agente de servicio de Paquete de interacción con los clientes el rol de cliente de la API de Dialogflow.

Crea un agente basado en flujo

Para crear un agente basado en flujo desde el compilador de agentes, haz lo siguiente:

  1. Haz clic en el botón más en la parte inferior del agente que debe iniciar el agente basado en flujo.
  2. Haz clic en Import flow-based agent. Se abrirá el panel de configuración.
  3. Selecciona el proyecto para tu flujo.
  4. Selecciona el agente para tu flujo.
  5. Proporciona un nombre visible.
  6. Proporciona una descripción para el agente superior de CX Agent Studio que describa cuándo transferir el control al flujo.
  7. Proporciona el recurso de inicio del flujo.
  8. Proporciona el entorno que se debe usar para el flujo. La opción predeterminada será borrador.
  9. Proporciona la asignación de variables de entrada. Las variables que proporciones aquí se enviarán al flujo como parámetros de sesión.
  10. Asignación de variables de salida. Los parámetros de sesión de flujo que proporciones aquí se enviarán a la aplicación de tu agente como variables.
  11. Haz clic en Importar.

Prácticas recomendadas de migración

Cuando uses tus flujos existentes, ten en cuenta las siguientes prácticas recomendadas.

Guías

Si bien los agentes de CX Agent Studio ofrecen una funcionalidad similar a las guías, es importante comprender que los agentes de CX Agent Studio no son un reemplazo directo. Los agentes de Dialogflow CX pueden tener un acoplamiento estrecho entre las guías y los flujos, lo que dificulta el reemplazo directo.

Tipos de agentes aislados versus integrados

Cuando realices la transición de agentes de Dialogflow CX con relaciones complejas entre flujos y guías a agentes de CX Agent Studio, primero debes considerar aislar los tipos de agentes.

Puedes crear agentes nuevos de CX Agent Studio para todos los casos de uso nuevos y seguir manteniendo tus agentes de Dialogflow CX para los casos de uso antiguos. Para ello, puedes usar una capa de enrutamiento para determinar qué tipo de agente se debe invocar.

Ten en cuenta que los agentes de dirección de CX Agent Studio no pueden realizar la transferencia entre agentes de Dialogflow CX hasta que se alcance END_SESSION y el control se devuelva al agente de dirección de CX Agent Studio.

Si este enfoque no es factible y debes usar tus flujos existentes, puedes usar agentes basados en flujo de CX Agent Studio como se describe en esta guía. Es importante usar agentes de CX Agent Studio como agentes de dirección para administrar el enrutamiento entre agentes y flujos de CX Agent Studio.

Ten en cuenta que este proceso puede ser un esfuerzo único considerable.

Flujos para lógica empresarial altamente determinista

Los flujos son ideales para administrar la lógica empresarial altamente determinista, en especial cuando CX Agent Studio no puede controlar esa lógica.

Estos son buenos ejemplos de uso de un flujo:

  • Realizar recopilaciones y validaciones de datos secuenciales
  • Realizar un flujo de autenticación basado en parámetros de sesión

Estos son ejemplos incorrectos de uso de un flujo:

  • Responder al usuario con una respuesta predefinida, ya que esto se puede lograr fácilmente con una devolución de llamada del agente de CX Agent Studio.
  • Realizar la clasificación y detección de intents, ya que debes usar LLM para esos fines.

Flujos como cajas negras

Un problema con los flujos es que dependen de parámetros de sesión, que son parámetros globales implícitos. De forma predeterminada, todos los parámetros recopilados en un flujo se propagan automáticamente al alcance de la sesión, por lo que se vuelven accesibles para los flujos posteriores. Esta metodología introduce un problema en el que las modificaciones en la lógica de recopilación de parámetros en un flujo ascendente pueden interrumpir inadvertidamente los flujos descendentes.

Este comportamiento se debe considerar con cuidado cuando se usan agentes basados en flujo de CX Agent Studio. Los agentes de CX Agent Studio deben tratar los flujos como cajas negras encapsuladas, con toda la información necesaria transmitida a través de parámetros de entrada explícitos. Cuando se inicia un flujo, este debe usar estos parámetros pasados como parámetros de sesión para ejecutar las acciones designadas. Por el contrario, cuando sales del flujo, es importante que este complete los parámetros de salida predefinidos de los parámetros de sesión antes de ceder el control al agente de CX Agent Studio.

Ejemplos

En el siguiente diagrama, se ilustra una configuración recomendada, en la que el agente de CX Agent Studio funciona como la capa de enrutamiento, mientras que los flujos ejecutan lógica independiente antes de ceder el control.

Diagrama recomendado

En el siguiente diagrama, se ilustra una configuración aceptable (observa la incorporación de la guía), siempre que las interacciones de guía <-> flujo permanezcan encapsuladas como una caja negra del agente de CX Agent Studio de enrutamiento.

Diagrama aceptable

En el siguiente diagrama, se ilustra una configuración inaceptable debido a las transiciones complicadas de ida y vuelta entre CX Flow B y PS Agent A, lo que compromete la encapsulación de la interfaz.

Diagrama aceptable