AI CodeOps

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:

  1. La petición enumera las herramientas, cada una con un nombre, una descripción y un JSON Schema para su entrada.
  2. El modelo decide llamar a una y se detiene con un bloque tool_use que nombra la herramienta y su entrada.
  3. Tu código ejecuta la herramienta y devuelve un tool_result.
  4. 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.