Agregar funcionalidad personalizada en flujos de conversación de agente IA avanzada usando integraciones simuladas

¿Qué plan tengo?

Complemento

Agentes IA - Avanzado

Una integración falsa permite agregar funcionalidad personalizada a los diálogos usando los datos que ya están presentes en la conversación, sin hacer llamadas a la API ni recuperar datos externos. Esto le permite implementar la lógica usando JSONata para la manipulación de datos, las comparaciones u otras tareas dentro del flujo de diálogo.

Este tipo de integración es útil para manejar tareas que no requieren datos externos en tiempo real, ya que actúa como una integración de “ayuda” para ampliar las capacidades de un agente de IA más allá de las funciones estándar.

En este artículo se tratan los siguientes temas:

• Acerca de las integraciones falsas
• Crear una integración falsa
• Agregar una integración falsa dentro de un diálogo

Acerca de las integraciones falsas

Una integración falsa es útil cuando se desea procesar o manipular datos que ya están disponibles en la conversación. Por ejemplo, puede realizar las siguientes tareas usando una integración falsa:

• Transforme sus datos a un formato más apropiado.
• Formatee y filtre datos complejos de CRM o API.
• Compare las fechas para encontrar la más reciente.
• Recuperar el día y la hora actuales.
• Verifique si una fecha está dentro de un marco de tiempo determinado.
• Verifique si un URL contiene palabras específicas.
• Busque y reemplace los valores nulos.
• Reemplace letras o símbolos en los datos.
• Use un filtro que no distinga entre mayúsculas y minúsculas para analizar los datos y devuelva el primer valor coincidente o proporcione una respuesta alternativa si no hay coincidencias

Si puede definir la lógica usando JSONata, entonces puede mejorar sus conversaciones con estas útiles integraciones.

Crear una integración falsa

Sugerencia: Antes de crear una integración falsa, le sugerimos que se familiarice con el uso de JSONata con el Generador de integraciones. Consulte Activación de JSONata.

Para crear una integración falsa, se crea una integración de API como de costumbre. Sin embargo, nunca se hace ninguna solicitud de datos.

Para crear una integración falsa

1. En el menú principal, haga clic en API Integrations.
2. En la parte superior derecha, haga clic en Agregar integración.
3. En la ventana Agregar integración:
   
   1. En el campo Nombre de la integración, asigne un nombre descriptivo a la integración.
   2. (Opcional) En el campo Descripción, ingrese una descripción de la integración que le ayude a recordar para qué sirve.
   3. Haga clic en Guardar.
4. En la barra lateral izquierda, bajo Entornos, seleccione un entorno (como Producción).
5. Establezca Tipo de método en GET.
6. En el campo URL, ingrese un URL ficticio (por ejemplo, https://dummyjson.com/http/200).
   

   • Nota: Debido a que las integraciones falsas se alojan dentro del framework de integración, deben apuntar a un URL válido. El ejemplo anterior usa https://dummyjson.com/http/200, pero no se puede garantizar su disponibilidad. Puede usar el URL ficticio que más le convenga. Si bien se realizará una llamada de API al URL especificado, no se procesará ningún dato de la respuesta en la integración falsa.

7. Asegúrese de que Tipo de autorización esté establecido en Sin autorización.
8. (Opcional) En la barra lateral izquierda, en Escenarios, pase el mouse por encima de Fallay seleccione el menú de opciones () y seleccione Borrar. No es necesario un escenario de falla para una integración falsa.
9. En la barra lateral izquierda, en Escenarios, seleccione Correcto.
10. Según el escenario, realice una de las siguientes acciones:
    
    • Si tiene una consulta sencilla, ingrésela en el campo Consulta de escenario. Por ejemplo, si solo necesita una respuesta booleana, lo único que necesita es tener la consulta aquí.
    • Si necesita definir la lógica en función de los parámetros de la solicitud (procedentes de la conversación):
      
      1. Ingrese requestParameters en el campo Scenario Query.
      2. En Parámetros de sesión, ingrese los parámetros para la integración falsa. La captura de pantalla a continuación incluye parámetros de ejemplo y expresiones JSONata para devolver el día de la semana y la hora actual.
         
11. Haga clic en Guardar.

Agregar una integración falsa dentro de un diálogo

En el generador de diálogo, puede agregar un nodo de integración de API y seleccionar la integración falsa.

Para agregar una integración falsa dentro de un diálogo

1. En la esquina superior derecha, use el campo desplegable agente IA para seleccionar el agente IA cuyo diálogo desea actualizar.
2. En el menú principal de la izquierda, seleccione Contenido > Intenciones.
3. Seleccione la intención para la que desea actualizar el diálogo.
4. Seleccione la pestaña Respuestas.
5. Seleccione la respuesta cuyo diálogo desea actualizar y luego haga clic en Editar diálogo.
6. Haga clic en el icono de signo más (+) en el punto correspondiente del cuadro de diálogo y agregue un bloque de integración de API.
   
7. Seleccione la integración falsa que creó anteriormente.
   

Ahora, cuando se toca la rama de integración falsa en la conversación, se llama a la integración de API falsa y los parámetros de sesión que definió en su escenario de éxito estarán disponibles para el diálogo. El ejemplo a continuación muestra una integración falsa que alimenta un bloque condicional usando parámetros basados en el día de la semana devueltos por la integración falsa.