Introducción a las herramientas

Qué es una herramienta

Una herramienta conecta un agente con una capacidad externa. Mientras el conocimiento sirve para responder con información, una herramienta permite consultar datos o ejecutar una acción: buscar un pedido, crear una incidencia, enviar un correo o gestionar una cita.

Las herramientas se crean en el catálogo de Studio → Herramientas y después se autorizan únicamente para los agentes que deban utilizarlas.

Tipos disponibles

• HTTP Request: consulta o modifica recursos de una API.
• Webhook: envía un evento a un endpoint, normalmente mediante POST.
• Email SMTP: envía correo a destinatarios previamente autorizados.
• Calendario: consulta disponibilidad y gestiona citas dentro del horario configurado.

Elige el tipo según la acción real. Un nombre y una descripción precisos ayudan al agente a decidir cuándo debe invocarla.

Ciclo recomendado

1. Crea la herramienta y describe su finalidad.
2. Configura únicamente los datos y permisos necesarios.
3. Guarda y ejecuta una prueba manual.
4. Revisa el resultado en Ejecuciones.
5. Autorízala para uno o varios agentes.
6. Prueba una conversación completa antes de publicarla.

Herramientas activas y autorizadas

Una herramienta activa está disponible en el catálogo, pero eso no significa que todos los agentes puedan usarla. Cada agente mantiene su propia lista de herramientas autorizadas. Esta separación evita exponer acciones a agentes que no las necesitan.