Uso de herramientas y funciones
Por qué un modelo necesita herramientas
- No accede a datos en tiempo real por sí mismo.
- No hace cálculos fiables ni ejecuta código.
- Las herramientas cubren sus puntos ciegos.
El catálogo de herramientas
Se define un conjunto de funciones con nombre, descripción y parámetros. El agente lee esas fichas y elige cuál invocar según la tarea.
Llamada a función
El modelo, en lugar de responder en prosa, emite una llamada estructurada: nombre de la herramienta y argumentos, normalmente en formato tipo JSON. Un ejecutor la lleva a cabo.
Argumentos correctos
La calidad del agente depende de que rellene bien los parámetros: tipos, formatos y valores plausibles. Un argumento torcido rompe la llamada o da resultados falsos.
Devolver la observación
El resultado de la herramienta regresa al agente, que lo integra en su razonamiento. Es el cierre del bucle herramienta-observación.
Encadenar herramientas
Para una tarea compleja, el agente puede necesitar varias llamadas en secuencia: buscar, extraer, calcular. Encadenarlas correctamente es parte del reto.
Elegir la herramienta adecuada
- Debe decidir si la tarea requiere buscar, calcular o escribir.
- Equivocarse aquí desperdicia pasos o falla el objetivo.
- Un buen catálogo describe cuándo usar cada herramienta.
Manejo de errores
Las herramientas fallan: tiempos de espera, datos vacíos, formatos raros. El agente debe reconocer el fallo y reintentar o cambiar de estrategia en vez de inventar el resultado.
No alucinar la salida
Un riesgo sutil es que el modelo «simule» la respuesta de la herramienta sin llamarla. Hay que forzar que use el resultado real devuelto.
Diseño de la interfaz
Buenas herramientas tienen contratos claros y poco ambiguos. La claridad de la firma reduce errores del agente al invocarla.
Seguridad de la acción
- Toda herramienta que escribe o envía debe estar vigilada.
- Limitar permisos y confirmar acciones irreversibles.
- Un agente con manos necesita rienda.
Errores frecuentes
- Firmas ambiguas: parámetros con nombres crípticos o descripciones vagas producen argumentos inventados.
- Dejar que el modelo simule el resultado de la herramienta en prosa en lugar de obligarlo a esperar la observación real.
- Otorgar permisos de escritura sin confirmación: un agente con manos necesita rienda en las acciones irreversibles.
Ejemplo resuelto: cotizar un envío con tres herramientas
«¿Cuánto cuesta enviar 3 kg de Madrid a Lisboa mañana?» exige datos que el modelo no puede saber de memoria.
- El agente elige la herramienta de código postal y confirma las coordenadas de ambas ciudades.
- Invoca la calculadora de tarifas con peso, origen, destino y fecha como argumentos tipados.
- La API del transportista devuelve dos opciones: estándar y exprés, con sus plazos.
- El agente integra las observaciones y redacta la comparación citando los números reales recibidos.
- Si la tarifa devolviera error, reintentaría o cambiaría de transportista en vez de inventar el precio.
¿Para qué sirve en la realidad?
Copilotos que ejecutan código, asistentes que reservan vuelos y sistemas de atención que consultan el estado de un pedido son tool calling en producción: el puente entre el lenguaje y los sistemas de empresa.
¿Qué añade la «llamada a funciones» a un agente basado en un modelo de lenguaje?
Un agente que alucina la respuesta de una herramienta sin llegar a llamarla está cometiendo un fallo de uso de herramientas.
Herramientas
Ordena el ciclo de una llamada a herramienta:
Elegir
Invocar
Ejecutar
Integrar
API
Interfaz que permite a un programa invocar servicios de otro.
Une cada término del tool calling con su papel.
Del texto a la acción
# Uso de herramientas ## Catálogo ### fichas claras ### cuándo usar cada una ## Llamada ### argumentos tipados ### ejecutor externo ## Bucle ### observación real ### encadenar pasos ## Control ### reintentos ante fallo ### permisos y confirmación
Función
El concepto computacional de caja negra con entrada y salida que el agente aprende a operar.
Tu agente a veces inventa el precio de un producto en vez de consultarlo. ¿Es un problema de diseño de la herramienta, del prompt o de la verificación? Razona.