Llamada a herramientas (tool calling)
Última actualización
La llamada a herramientas permite a un modelo pedir a la aplicación que ejecute una función y le devuelva el resultado. Cómo funciona el intercambio y los límites de herramientas en AI CodeOps.
La llamada a herramientas (tool calling), también llamada llamada a funciones (function calling), es una capacidad del modelo por la que este devuelve una petición estructurada para ejecutar una herramienta con nombre y argumentos, en lugar de texto plano. La aplicación ejecuta la herramienta y devuelve el resultado, y el modelo continúa.
Qué es
El intercambio, tal como lo describe la documentación de uso de herramientas de Anthropic:
- La petición enumera las herramientas, cada una con un nombre, una descripción y un JSON Schema para su entrada.
- El modelo decide llamar a una y se detiene con un bloque
tool_useque nombra la herramienta y su entrada. - Tu código ejecuta la herramienta y devuelve un
tool_result. - El modelo usa el resultado para responder, o llama a otra herramienta.
Algunas herramientas se ejecutan en el lado del proveedor, como la búsqueda web. Las definiciones y los resultados de las herramientas cuentan todos como tokens de entrada.
Por qué importa
Las herramientas son la forma en que un agente deja de solo hablar y empieza a actuar: leer un archivo, buscar en un gestor de incidencias, ejecutar un comando. Cada herramienta es también un permiso, así que las herramientas que ve un agente merecen tanto cuidado como lo que se le dice.
En AI CodeOps
Los agentes de una sesión llaman a herramientas de los servidores MCP remotos que añades. Tal como las ven los agentes:
tool names <server>__<tool>
per session up to 32 MCP tools
per step up to 6 rounds of tool calls
per call 30-second timeout; long results are shortened
Las herramientas que deniega una regla de política, o que excluyen los permisos de un agente, se quitan antes de que el modelo vea la lista.
Preguntas frecuentes
¿La llamada a herramientas es lo mismo que la llamada a funciones?
Sí. Los proveedores usan los dos nombres para lo mismo: el modelo devuelve una petición estructurada para llamar a una función con nombre, con sus argumentos.
¿Puede un modelo llamar a una herramienta que no se le dio?
En AI CodeOps, no. Un nombre de herramienta que se invente el modelo no está en la lista de la sesión, así que la llamada no se puede ejecutar.