Módulos
Servicios API
Guia completa para conectar el Agente de IA con servicios Externos.
Configuración de los Servicios de Agentes IA
Este documento como se puede conectar en el archivo agent.config.json
, servicios externos API rest ya sean GET o POST para poder ejecutar ciertas acciones, que le dan mas capacidades al Agente de IA, por ejemplo consultar servicios a base de datos, productos, reservar citas, etc.
Github
Puedes descargar nuestro repositorio de ejemplo para crear tus agentes.
Estructura
✅ El servicio se encuentra en Pruebas Experimentales para probar su fiabilidad y el porcentaje de Aciertos con las solicitudes del usuario, estamos mejorando el servicio dia a dia.
Campos del Servicio
Campo | Descripción |
---|---|
intent | Identificador único de la intención del servicio. Se usa para detectar qué está solicitando el usuario (por ejemplo, "schedule_appointment" ). |
reference | Frase corta y descriptiva que ayuda a la IA a entender cuándo debe activarse este servicio. Ejemplo: “Servicio para reservar citas médicas”. |
enabled | Booleano que indica si el servicio está activo (true ) o no (false ). |
method | Método HTTP usado para llamar a la API externa (GET , POST .), no se puede otra solicitud por el momento. |
endpoint | URL completa de la API que se desea invocar cuando se activa la intención. |
headers | Objeto con pares clave-valor para incluir headers HTTP personalizados como Authorization . |
requiredFields | Arreglo de strings que indica qué datos del usuario son requeridos antes de ejecutar el servicio (por ejemplo, ["nombre", "email"] ). |
bodyTemplate | Objeto que se usa para construir el cuerpo del request. Soporta interpolación de variables como {{email}} , {{nombre}} . |
responseMapping | Define cómo extraer datos desde la respuesta de la API (por ejemplo, "mensaje": "$.response.message" ). |
responseMessage | Mensaje que el agente debe devolver al usuario tras ejecutar correctamente el servicio. Se pueden usar placeholders como {{fecha}} . |
Consideraciones
- El Agente de IA consultará al usuario, los campos que se encuentran en el campo
requiredFields
en el formato: campo: campo, el usuario puede llenar un campo o todos, la IA entenderá si faltan o no campos antes del consumir el servicio. - El
responseMapping
te ayudará a poder completar los datos del camporequiredMessage
, colocando la información en las llaves correspondientes, el json que te trae el servicio deberia de poder colocar los campos dentro del Mensaje. - Se pueden crear uno o varios servicios dentro de la configuración del Agente, para que pueda consultar sus servicios.