Inicio › El Arsenal › Glosario: tool calling
Glosario – Tool calling

Qué es el tool calling: cómo una IA pide usar una herramienta

Por IActn – escrita con ayuda de IA y revisada por una persona antes de publicarla. Fuentes al final.

Un modelo de IA, por sí solo, solo escribe texto. No abre tu agenda, no lee tu archivo, no busca en internet. Para eso existe el tool calling (también «function calling» o uso de herramientas): el modelo pide una herramienta y alguien más la ejecuta de verdad. Aquí va cómo funciona, quién hace qué y por qué una IA con herramientas necesita límites.

Lo que vas a ver
  1. 01Qué esQué es el tool calling
  2. 02Qué esQuién ejecuta la herramienta de verdad
  3. 03Paso a pasoLa ronda completa: pedir, ejecutar, responder
  4. 04CuidadoPor qué una IA con herramientas necesita límites
  5. 05Qué esCómo se relaciona con agentes, MCP y hooks
  6. 06PromptsUn prompt para decidir qué herramientas darle a tu IA
  7. 07CuidadoLo que falta confirmar
01 – qué es

Qué es el tool calling (o function calling)

Anthropic lo llama «tool use», también conocido como function calling. Lo describe así: Claude decide cuándo usar una herramienta según lo que le pides y la descripción de la herramienta, y entonces devuelve una petición estructurada, es decir, un mensaje ordenado con el nombre de la herramienta y los datos que necesita. (Anthropic – Tool use with Claude)

La idea que más importa de toda la documentación es esta: el modelo nunca ejecuta nada por su cuenta. Emite la petición; el código (el tuyo o el de Anthropic) hace la operación, y el resultado vuelve a la conversación. (Anthropic – How tool use works)

Piensa en un restaurante. El cliente (el modelo) no entra a la cocina: le dice al mesero lo que quiere. El mesero lleva el pedido, la cocina lo prepara y el plato vuelve a la mesa. Pedir y cocinar son trabajos distintos, y por eso se puede poner a alguien a vigilar la puerta de la cocina.

02 – qué es

Quién ejecuta la herramienta de verdad

Anthropic separa las herramientas según dónde corre el código. Para ti, la diferencia es quién se encarga del trabajo:

TipoQuién la ejecutaEjemplos según la documentación
Herramientas propias (las defines tú)La aplicación que usa el modeloConsultar una agenda, una base de datos, tus sistemas
Herramientas con formato de AnthropicLa aplicación; Anthropic solo publica el formatoMemoria, comandos de terminal (bash), editar archivos, controlar el escritorio o un navegador
Herramientas de servidorLos servidores de AnthropicBúsqueda web, leer páginas web, ejecutar código, buscar entre herramientas

En las dos primeras filas la aplicación recibe la petición, hace la operación y devuelve el resultado. En la tercera, tú activas la herramienta y los servidores de Anthropic hacen el trabajo; tú solo ves el resultado. (Anthropic – How tool use works)

03 – paso a paso

La ronda completa: pedir, ejecutar, responder

Con una herramienta propia, la documentación describe un ciclo. Así se vería con una consulta del clima:

  1. Le das la lista de herramientas y tu pregunta. «¿Qué clima hace en Madrid?», y una herramienta de clima descrita en palabras.
  2. El modelo responde con una petición, no con la respuesta. Su señal de parada es tool_use: «quiero la herramienta de clima, con Madrid».
  3. La aplicación ejecuta. Consulta el clima de verdad y prepara un resultado (tool_result).
  4. Le devuelve el resultado al modelo. Con eso ya puede redactar la respuesta final.
  5. Se repite mientras haga falta. Si el modelo pide otra herramienta, el ciclo vuelve al paso 3; termina cuando da una respuesta final.

Nuestro ejemplo real - Claude Code

Claude Code trabaja así: para hacer cualquier cosa, pide herramientas. Leer un archivo, buscar algo, ejecutar un comando en la terminal. Cada una de esas acciones es una petición de herramienta.

Nuestro ejemplo real - el punto de control

Entre «Claude pide» y «se ejecuta» hay un hueco. En IActn lo usamos para que unos hooks revisen la petición antes de que pase.

04 – cuidado

Por qué una IA con herramientas necesita límites

Sin herramientas, lo peor que puede hacer una IA es escribir algo equivocado. Con herramientas, puede hacer algo equivocado: borrar, enviar, leer lo que no debía. La documentación de Anthropic cita justo ese tipo de usos para las herramientas: acciones con efectos, como enviar un correo o escribir un archivo. (Anthropic – How tool use works)

La buena noticia es la que viste arriba: como el modelo solo pide y otro ejecuta, hay un punto donde se puede frenar. En Claude Code ese punto son los hooks: Anthropic describe uno, llamado PreToolUse, que corre antes de que se ejecute la herramienta y puede bloquearla, y su guía trae como ejemplo bloquear ediciones a archivos sensibles. (Claude Code – Hooks guide)

  • Qué puede hacer sola: lo de poco riesgo y fácil de deshacer, como leer y buscar.
  • Qué pasa por una persona: lo que envía, borra, publica o gasta.
  • Qué queda bloqueado siempre: lo que nunca debería ocurrir, sin importar quién lo pida.

Así lo hacemos: en IActn, antes de que se ejecute un comando que Claude pide, unos hooks lo revisan y pueden bloquearlo. Uno impide que se lea un archivo de contraseñas (el archivo .env), para que su contenido no quede en la conversación.

05 – qué es

Cómo se relaciona con agentes, MCP y hooks

PalabraRelación con el tool calling
Agente de IAEs una IA que usa herramientas en bucle para cumplir una tarea. El tool calling es lo que le permite actuar.
MCPUna forma estándar de entregarle herramientas a la IA, para no armar cada conexión desde cero.
HooksControles que se meten en el camino entre la petición y la ejecución, para revisarla o bloquearla.
06 – prompts

Un prompt para decidir qué herramientas darle a tu IA

Es nuestro, no de Anthropic.

Qué puede hacer sola y qué pasa por una persona

Cuándo usarlo: antes de conectarle herramientas a una IA, o cuando ya las tiene y quieres ordenar sus permisos.

Dónde se pega: Claude Claude Code
Prompt
Quiero que una IA use estas herramientas en mi negocio: [lista lo que quieres que pueda hacer: leer la agenda, buscar en internet, enviar correos...]. Para cada una: 1. Explícame en una frase qué puede hacer de verdad y qué es lo peor que podría pasar si se equivoca. 2. Clasifícala en tres grupos: puede hacerlo sola, debe pasar por una persona antes, o debe quedar bloqueada. 3. Dime si el error se puede deshacer o no. 4. Para las que pasan por una persona o quedan bloqueadas, dime qué control pondrías antes de que se ejecuten. Usa lenguaje sencillo, sin tecnicismos.
07 – cuidado

Lo que falta confirmar

  • Esta guía sigue la documentación de Anthropic. Otros proveedores de IA usan los mismos conceptos con nombres y formatos distintos, y no los verificamos aquí.
  • Los nombres técnicos cambian. Las herramientas y sus versiones se actualizan seguido; lo que dura es la idea de fondo: el modelo pide, alguien ejecuta.
  • Los hooks son una de varias capas de control. No cubren por sí solos todo lo que podría salir mal.
  • Los permisos concretos de cada herramienta dependen de cómo se configure tu aplicación; aquí no los detallamos.
Si te llevas una sola cosa

Una IA con herramientas no actúa: pide, y alguien ejecuta. Ahí está tu control. Decide qué puede hacer sola, qué pasa por una persona y qué queda bloqueado, y pon la revisión justo entre la petición y la ejecución.

¿Y ahora qué?

Tres formas de seguir, según lo que prefieras.

Recibe las guías nuevas en tu correo

Un correo cuando sale una guía nueva o una novedad que te sirva para tu negocio.

El mensaje para tu grupo

¿Le sirve a alguien de tu equipo o de tu grupo? Cópialo tal cual o ábrelo directo en WhatsApp.

Te paso esta guía: Qué es el tool calling. Tu IA no actúa: pide una herramienta. Ahí está tu control. https://iactn.com/arsenal/que-es-tool-calling/
Abrir en WhatsApp
Cuándo se verificó esto

Fuentes, leídas el 21-10-2026

  1. Tool use with Claude – Documentación de Anthropic. Tool use también se llama function calling; Claude devuelve una petición estructurada que ejecuta la aplicación o Anthropic; qué herramientas son de cliente y cuáles de servidor.
  2. How tool use works – Documentación de Anthropic. El modelo nunca ejecuta por su cuenta; los tres tipos de herramienta según dónde corren; el ciclo de pedir, ejecutar y devolver el resultado; cuándo conviene usar herramientas.
  3. Automate actions with hooks – Documentación de Claude Code. El hook PreToolUse corre antes de ejecutar una herramienta y puede bloquearla; el ejemplo de proteger archivos sensibles.