Herramientas: conectar el agente a tus propios sistemas

Para qué sirve una herramienta

Una herramienta es una dirección HTTPS que funciona en tu sistema (un endpoint de API). El agente la llama cuando hace falta durante una conversación: por ejemplo, para leer la disponibilidad de citas, el estado de un envío o el saldo de un cliente en tu sistema.

Usa una herramienta para cualquier sistema sin integración lista. Abre «Herramientas» desde el menú; añadir, editar, eliminar y probar herramientas requieren el rol propietario o administrador.

Añadir una herramienta nueva

1. Pulsa «Nueva herramienta».
2. Escribe el «Nombre de la herramienta» en minúsculas con guiones bajos, por ejemplo, check_availability.
3. En «¿Cuándo debe usarse?», describe claramente qué hace la herramienta y para qué preguntas debe llamarse. El agente decide cuándo llamarla a partir de esta descripción.
4. Introduce el método (GET o POST) y la dirección. La dirección debe empezar por https; las direcciones locales y de redes privadas se rechazan.
5. Usa «Añadir campo» para definir los campos que espera la herramienta: nombre, tipo, descripción y si es obligatorio. El agente rellena estos campos con la conversación. Los tipos se explican abajo.
6. Elige la «Autenticación»: ninguna, token Bearer o un encabezado personalizado (con su nombre). El secreto se guarda en el servidor y no vuelve a mostrarse; déjalo en blanco al editar para conservar el valor guardado.
7. Antes de guardar, pruébala con valores de ejemplo usando «Llamada de prueba»; verás la respuesta o el error al momento.

Tipos de campo y campos anidados

Cada campo tiene un tipo, y el valor se envía a tu endpoint en ese tipo. Por ejemplo, un campo «Sí/No» se envía como true, no como el texto «true», y un campo «Número» escrito como 1,234.5 se envía como 1234.5.

• Texto, Número, Sí/No: un solo valor. Un campo Sí/No entiende yes, no, true, false, 1 y 0.
• Fecha: puedes escribir 06.10.2026 (día primero) o 2026-10-06; se envía como 2026-10-06. Fecha y hora: por ejemplo, 06.10.2026 14:30; se envía como 2026-10-06T14:30:00.
• Objeto: un grupo con sus propios subcampos, por ejemplo, un cliente (nombre, correo). Si no añades subcampos, el valor se envía tal cual, como JSON libre.
• Lista: varios valores. Elige el «Tipo de elemento»; si el elemento es un Objeto, define sus campos, por ejemplo, líneas de pedido (ID de producto, cantidad).

Los campos se pueden anidar hasta 5 niveles. Objeto y Lista solo se pueden elegir en herramientas POST; una petición GET no puede llevar datos anidados.

En las herramientas POST aparece un «Cuerpo de ejemplo» bajo los campos: la forma del cuerpo JSON que recibirá tu endpoint. Puedes compararlo con lo que espera tu endpoint. En la «Llamada de prueba», cada campo tiene una entrada adecuada a su tipo; los campos Objeto y Lista se abren rellenados con el cuerpo de ejemplo.

Si un valor no coincide con el tipo de su campo (por ejemplo, «muchos» en un campo Número) o un campo obligatorio está vacío, la petición no se envía; el error indica qué campo es, por ejemplo, items[1].id (el campo id del segundo elemento).

Herramientas que cambian datos

Si la herramienta cambia algo en tu sistema (crear un registro, una cancelación, etc.), marca «Esta herramienta cambia datos». Estas herramientas nunca se reintentan con valores distintos, y cada llamada queda registrada. Aparecen en la lista con la insignia «Cambia datos».

Usar una herramienta en un agente

• En la pestaña «Herramientas» del paso Asistente de IA, elige a qué herramientas puede acceder el agente: todas (incluidas las que se añadan después) o las que selecciones.
• Un paso «Selección» puede cargar sus opciones de una herramienta; por ejemplo, las horas libres aparecen como tarjetas.
• Un paso «Llamada a herramienta» llama a la herramienta en un punto concreto del flujo, sin IA, y guarda la respuesta en una variable.

Consulta los artículos Paso Asistente de IA, Paso Selección y Paso Llamada a herramienta.

Gestionar la lista

Busca herramientas por nombre o descripción y filtra por método y tipo de autenticación. Las herramientas que fallan llevan la insignia «Fallando». Al eliminar una herramienta, el agente deja de llamarla.