Qué es una herramienta

El cliente y el camarero

En un restaurante tú no entras a la cocina. Dices al camarero qué quieres, él lo pide, cocinan y te traen el plato. Tú decides; otro ejecuta.

Con un agente es igual. El modelo solo produce texto. Para «usar» una herramienta, escribe una petición con un formato preciso («quiero usar leer_archivo con esta ruta»). El harness la ve, ejecuta la acción de verdad y devuelve el resultado al modelo.

Cómo funciona por dentro

Las herramientas se describen al modelo indicando su estructura exacta: nombre, descripción y parámetros. Cuando el modelo decide usar una, su respuesta incluye un bloque de uso de herramienta (tool use block), según explica Anthropic. El ciclo es:

1. El harness le presenta las herramientas disponibles.
2. El modelo responde pidiendo una, con sus argumentos.
3. El harness la ejecuta (y puede comprobar permisos antes).
4. El resultado vuelve al modelo, que decide el siguiente paso.

Un ejemplo ilustrativo (no es el formato exacto de ninguna API concreta):

{
  "herramienta": "leer_archivo",
  "argumentos": { "ruta": "/proyecto/src/app.py" }
}

El resultado de vuelta sería el contenido del archivo. Ese resultado es la «verdad del terreno» que el agente necesita en cada paso (lo vimos en agentes autónomos).

Tipos habituales

La skill harness-creator menciona, como ejemplos de herramientas que un agente necesita para ser productivo, la shell, la edición de archivos y la búsqueda. Ayudan mucho, pero un acceso sin límites trae riesgos: operaciones destructivas, choques entre llamadas simultáneas y permisos mal configurados. De eso trata permisos y límites.

Siguiente paso: cómo escribir esa definición para que el modelo la use bien, en diseña buenas herramientas.