Las Herramientas permiten extender las capacidades de un agente de IA, habilitándole el acceso a funciones avanzadas como consultar sistemas internos, ejecutar validaciones, obtener información dinámica o realizar acciones específicas dentro de tu negocio.
Mientras los Conocimientos proveen información estática, las Herramientas permiten que el agente actúe, consulte o procese datos en tiempo real.
Esta guía explica cómo crearlas, configurarlas y administrarlas.
1. ¿Qué es una herramienta?
Una herramienta es una función personalizada que el agente puede invocar cuando lo considere necesario para resolver una solicitud del usuario.
Estas funciones pueden ser simples (ej.: validar un número de pedido) o complejas (ej.: consultar un inventario con lógica de negocio aplicada).
Cada herramienta se compone de:
Una definición básica (nombre, descripción, etiqueta, estado).
Parámetros que ayudan al agente a enviar información a la herramienta.
Código avanzado que contiene la lógica de la herramienta.
2. Crear una nueva herramienta
Para crear una herramienta, ingresá al módulo de Agentes → Herramientas → Crear nueva herramienta.
Verás la siguiente estructura:
Configuración básica
Esta sección define la identidad y propósito de la herramienta.
Nombre de la herramienta
Debe ser claro y descriptivo.
Ejemplos:
“Consulta Inventario”
“Verificar Estado De Pedido”
“Calcular Costo De. Envío”
Descripción
Explicá en lenguaje natural qué hace. El agente usará esta descripción para decidir cuándo llamar a la herramienta.
Ejemplo:
“Devuelve el estado del pedido según el ID ingresado por el usuario.”
Etiqueta
Sirve para organizar lógicamente las herramientas (ej.: “Pedidos”, “Inventario”, “Pagos”).
Herramienta activa
Permite habilitar o deshabilitar la herramienta sin eliminarla.
Parámetros
Los parámetros son los datos que el agente debe enviar a la herramienta cuando la utiliza.
Ejemplos típicos:
“idPedido”
“emailCliente”
“skuProducto”
“montoTotal”
Cada parámetro incluye:
Nombre
Descripción
Tipo (texto, número, booleano)
El agente usa esta información para estructurar la llamada correctamente.
Configuración avanzada (Código)
Aquí se define la lógica real de la herramienta.
Es un bloque de código que se ejecuta cuando el agente invoca la función.
Dentro de este código podés:
Conectarte a APIs internas.
Procesar datos.
Validar información.
Retornar resultados estructurados.
El resultado que devuelve la herramienta es lo que después el agente utiliza para responder al usuario.