¿Qué plan tengo?
Suite, todas las versiones Team, Growth, Professional, Enterprise o Enterprise Plus
Support Team, Professional o Enterprise

Una integración simulada permite agregar funciones personalizadas a los diálogos utilizando los datos ya presentes en la conversación, sin hacer llamadas de API ni recuperar datos externos. De este modo, se puede usar JSONata en el flujo de diálogo para implementar lógica de manipulación de datos, comparaciones u otras tareas.

Este tipo de integración es útil para tareas que no requieren datos externos en tiempo real y funciona como integración auxiliar para incorporar funciones no estándar a un agente IA.

En este artículo se tratan los siguientes temas:

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

Acerca de las integraciones simuladas

Tener una integración simulada es útil para procesar o manipular datos que ya están disponibles en la conversación. Esto permite, por ejemplo:

  • Convertir los datos a un formato más adecuado.
  • Formatear y filtrar datos de CRM o API complejos.
  • Comparar fechas para determinar cuál es la más reciente.
  • Obtener el día y la hora actuales.
  • Comprobar si una fecha está dentro de un determinado periodo de tiempo.
  • Comprobar si un URL contiene determinadas palabras.
  • Comprobar si hay valores nulos y, si los hubiera, sustituirlos.
  • Sustituir letras o símbolos en los datos.
  • Usar un filtro sin distinción entre mayúsculas y minúsculas que analice los datos y presente el primer valor coincidente (u ofrezca una respuesta alternativa si no hay coincidencias).

Si usa JSONata para definir la lógica, podrá mejorar sus conversaciones gracias a estas útiles integraciones.

Crear una integración simulada

Sugerencia: Antes de crear una integración simulada, procure entender cómo se usa JSONata con el generador de integraciones. Consulte Uso de JSONata con los agentes IA.

Las integraciones simuladas se crean como cualquier integración de API, con la diferencia de que nunca llegan a solicitarse datos.

Para crear una integración simulada

  1. En el menú principal, haga clic en Integraciones de API.
  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, escriba un nombre descriptivo para la integración.
    2. (Opcional) En el campo Descripción, describa la integración de un modo que le ayude a recordar para qué sirve.
    3. Haga clic en Guardar.
  4. En la barra lateral izquierda, bajo Entornos, seleccione un entorno (p. ej., Producción).
  5. En Tipo de método, seleccione GET.
  6. En el campo URL, ingrese un URL ficticio (por ejemplo, https://dummyjson.com/http/200).

    • Nota: Como las integraciones simuladas están alojadas dentro del marco de integración, es necesario que apunten a un URL válido. En el ejemplo anterior se utiliza https://dummyjson.com/http/200, pero no se garantiza que esté disponible. Puede usar cualquier URL ficticio que le parezca oportuno. Aunque se hará una llamada de API al URL especificado, no se procesará ningún dato de la respuesta en la integración simulada.

  7. Asegúrese de que, en Tipo de autorización, esté seleccionada la opción Sin autorización.
  8. (Opcional) En la barra lateral izquierda, bajo Escenarios, pase el mouse por encima de Falla, seleccione el menú de opciones () y luego elija Borrar. Para una integración simulada no se necesita un escenario de falla.
  9. En la barra lateral izquierda, bajo Escenarios, seleccione Éxito.
  10. Siga uno de estos dos pasos (el que mejor se adapte a su escenario):
    • Si tiene una consulta sencilla, ingrésela en el campo Consulta del escenario. Por ejemplo, si solo necesita una respuesta booleana, le bastará con especificar aquí la consulta.
    • Si necesita definir una lógica basada en los parámetros de solicitud (procedentes de la conversación):
      1. Ingrese requestParameters en el campo Consulta del escenario.
      2. Bajo Parámetros de sesión, ingrese los parámetros para la integración simulada. En la siguiente captura de pantalla se incluyen los parámetros de ejemplo y las expresiones JSONata para devolver el día de la semana y la hora actuales.
  11. Haga clic en Guardar.

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

En el generador de diálogo se puede agregar un bloque de integración de API y seleccionar la integración simulada.

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

  1. En la esquina superior derecha, en el campo desplegable Agente IA, seleccione 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 para la que desea actualizar el diálogo y haga clic en Editar diálogo.
  6. Haga clic en el icono de más (+) en el punto del diálogo adecuado y agregue un bloque de Integración de API.
  7. Seleccione la integración simulada que creó antes.

Al llegar a la rama de la integración simulada en la conversación, se hace una llamada a la integración de API simulada y se pasan al diálogo los parámetros de sesión definidos para el escenario de éxito. En la integración simulada del ejemplo siguiente, los datos se transfieren a un bloque condicional mediante parámetros basados en los días de la semana (y devueltos por la propia integración).

 

Tecnología de Zendesk