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.
- 01Qué esQué es el tool calling
- 02Qué esQuién ejecuta la herramienta de verdad
- 03Paso a pasoLa ronda completa: pedir, ejecutar, responder
- 04CuidadoPor qué una IA con herramientas necesita límites
- 05Qué esCómo se relaciona con agentes, MCP y hooks
- 06PromptsUn prompt para decidir qué herramientas darle a tu IA
- 07CuidadoLo que falta confirmar
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.
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:
| Tipo | Quién la ejecuta | Ejemplos según la documentación |
|---|---|---|
| Herramientas propias (las defines tú) | La aplicación que usa el modelo | Consultar una agenda, una base de datos, tus sistemas |
| Herramientas con formato de Anthropic | La aplicación; Anthropic solo publica el formato | Memoria, comandos de terminal (bash), editar archivos, controlar el escritorio o un navegador |
| Herramientas de servidor | Los servidores de Anthropic | Bú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)
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:
- Le das la lista de herramientas y tu pregunta. «¿Qué clima hace en Madrid?», y una herramienta de clima descrita en palabras.
- 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». - La aplicación ejecuta. Consulta el clima de verdad y prepara un resultado (
tool_result). - Le devuelve el resultado al modelo. Con eso ya puede redactar la respuesta final.
- 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.
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.
Cómo se relaciona con agentes, MCP y hooks
| Palabra | Relación con el tool calling |
|---|---|
| Agente de IA | Es una IA que usa herramientas en bucle para cumplir una tarea. El tool calling es lo que le permite actuar. |
| MCP | Una forma estándar de entregarle herramientas a la IA, para no armar cada conexión desde cero. |
| Hooks | Controles que se meten en el camino entre la petición y la ejecución, para revisarla o bloquearla. |
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.
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.
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/Fuentes, leídas el 21-10-2026
- 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.
- 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.
- 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.