Herramientas del agente: function calling
Respuesta corta: una herramienta es una función que el modelo puede decidir llamar: tiene nombre, descripción y parámetros tipados. El mecanismo — function calling — es el puente entre razonar y actuar: el modelo no ejecuta nada, pide la llamada y tu código la ejecuta con los permisos que tú definiste.
El ciclo de una llamada, por dentro
- Definición: registras la herramienta con su nombre, descripción y esquema de parámetros. El modelo lee ese contrato.
- Selección: ante el objetivo, el modelo decide si necesita una herramienta y cuál — o responde sin ella.
- Pedido: el modelo entrega la llamada con argumentos en JSON. Nota: entrega, no ejecuta. La ejecución es tuya.
- Ejecución: tu código valida los argumentos, verifica permisos y corre la función real.
- Resultado: el resultado vuelve al modelo como observación, y el ciclo continúa — actuar, observar, decidir.
Que el modelo no ejecute nada es la línea de defensa más importante del diseño: cada acción pasa por tu código, donde viven los permisos, los límites y la bitácora.
Qué hace buena a una herramienta
- Una sola cosa, bien: “consultar_existencias(producto)” es mejor que “gestionar_inventario(accion, ...)” con siete acciones escondidas.
- Descripción escrita para el modelo: dice qué hace, cuándo usarla y cuándo NO. La descripción ES la interfaz.
- Parámetros tipados y validados: enums para opciones cerradas, rangos para números, formatos para fechas. Menos ambigüedad, menos errores de selección.
- Errores que se pueden leer: “sin existencias del producto X” ayuda al modelo a decidir; “error 500” no.
- Grano correcto: ni micro-pasos que obligan al modelo a coreografiar de más, ni mega-herramientas que hagan de todo.
Ejemplo: la herramienta de existencias
Para el agente de tienda de el paso anterior: la herramienta recibe un identificador de producto y devuelve existencias y ubicación — nada más. No aparta (esa es otra herramienta, con permiso distinto), no sugiere alternativas (eso lo razona el modelo). Una herramienta estrecha y honesta hace al agente más confiable, no menos capaz.
Cuándo las herramientas se vuelven infraestructura
Con dos o tres herramientas, definirlas a mano es suficiente. Cuando crecen, aparecen los problemas de M×N que resuelve MCP — el estándar para exponer herramientas a cualquier modelo sin reescribir la integración cada vez.
Preguntas frecuentes
- ¿Una herramienta es lo mismo que una función normal?
- Es una función con contrato público: nombre, descripción y parámetros tipados que el modelo puede leer. La diferencia es la audiencia: una función normal la llama otro programador; una herramienta la llama un modelo leyendo su descripción. Por eso la descripción bien escrita es parte de la interfaz, no documentación opcional.
- ¿Cuántas herramientas debe tener un agente?
- Las mínimas para su objetivo, típicamente entre tres y ocho. Cada herramienta adicional compite por la atención del modelo y sube la probabilidad de elegir mal. Si un agente necesita quince herramientas, casi siempre es señal de que son dos agentes.
- ¿Qué pasa cuando una herramienta falla?
- El agente observa el error y decide: reintentar, probar otro camino o escalar a un humano. Ese comportamiento se diseña: el error debe volver al modelo como texto legible y accionable, y las herramientas delicadas deben tener su propio límite de reintentos para que un agente insistente no tumbe el sistema.
Siguiente paso de la ruta
Actuar genera historia. La siguiente pregunta es qué recuerda tu agente y por cuánto tiempo: memoria en agentes.