Herramientas y permisos
Qué es una herramienta, cómo la usa un agente y cómo decidir qué puede hacer sin preguntar, qué necesita tu aprobación y qué queda prohibido.
Antes de empezar
- Diseño del contexto para agentesTécnica
Qué información recibe el agente en cada momento, por qué más no siempre es mejor y cómo darle lo justo: lo esencial desde el principio y el resto cuando lo necesite.
Publicado
La idea clave: el modelo no ejecuta nada por sí mismo: pide usar una herramienta, y el programa que lo rodea decide si la ejecuta. Esa decisión —permitir, preguntar o bloquear— es el primer punto donde controlas al agente.
El problema
Un modelo de lenguaje solo produce texto. Para leer un archivo, ejecutar las pruebas o buscar en internet necesita herramientas. Sin ellas, el agente solo puede sugerirte qué hacer; con ellas, puede hacerlo.
Pero cada herramienta también es un riesgo. Un agente con acceso libre a la terminal puede ejecutar cualquier comando, incluido uno que borre datos o publique algo por error. La pregunta no es “¿qué herramientas existen?”, sino “¿cuáles necesita esta tarea y con qué control?”.
Cómo funciona
El ciclo de una herramienta tiene cinco pasos:
- El programa describe las herramientas disponibles: nombre, para qué sirve y qué datos necesita.
- El modelo decide si necesita una y genera una petición: “quiero usar
read_fileconpath: src/reading.js”. - El programa que lo rodea (el host) comprueba la petición: ¿existe esa herramienta?, ¿los datos son válidos?, ¿está permitida?
- Si procede, la ejecuta y devuelve el resultado al modelo.
- El modelo continúa con ese resultado, y puede pedir otra herramienta.
Lo esencial está en el paso 3: el modelo solo propone y quien ejecuta es el host. Escribir “tienes permiso para borrar archivos” en el prompt no crea ningún permiso; los permisos viven en el host.
Los agentes de código ya traen herramientas incluidas: leer y editar archivos, buscar, ejecutar comandos en la terminal o consultar la web. No tienes que programarlas; tienes que decidir cómo se usan.
Permitir, preguntar o bloquear
Los clientes de agentes de código suelen clasificar cada acción en tres niveles:
| Nivel | Cuándo | Ejemplos |
|---|---|---|
| Permitir sin preguntar | Seguro, frecuente y reversible | Leer archivos, ejecutar las pruebas o el linter |
| Preguntar antes | Afecta a algo fuera de tu copia local o cuesta deshacerlo | git push, instalar dependencias, llamar a un servicio |
| Bloquear | No debería ocurrir nunca en este proyecto | Leer .env, borrar fuera del proyecto |
Ejemplo práctico
En Claude Code, estas reglas se escriben en .claude/settings.json, un archivo que puedes versionar con el proyecto:
{
"permissions": {
"allow": ["Bash(npm test *)", "Bash(npm run lint)"],
"ask": ["Bash(git push *)", "Bash(npm install *)"],
"deny": ["Read(./.env)", "Read(./.env.*)"]
}
}
Las reglas se evalúan en este orden: primero las de bloqueo, después las de preguntar y por último las de permitir. Si una acción coincide con una regla de bloqueo, da igual que otra la permita.
Otros clientes usan otros nombres —modos de aprobación, listas de herramientas permitidas—, pero la idea es la misma: decidir fuera del prompt qué puede hacer el agente.
Si construyes tu propia herramienta, por ejemplo para un agente que programas con una API, haz que realice una sola acción clara y valida siempre los datos en tu código:
{
"name": "read_project_file",
"description": "Lee un archivo de texto dentro del proyecto. No modifica nada.",
"parameters": {
"type": "object",
"properties": {
"path": { "type": "string", "description": "Ruta relativa a la raíz del proyecto" }
},
"required": ["path"]
}
}
La descripción ayuda al modelo a elegir bien, pero no protege nada: tu código debe comprobar que la ruta no se sale del proyecto (por ejemplo, ../../.ssh/id_rsa).
Errores comunes
- Dar todas las herramientas “por si acaso”. Más herramientas significan más opciones donde equivocarse y más superficie de riesgo.
- Preguntar por todo. Si el agente pide aprobación para cada lectura, acabarás aprobando sin leer. Permite lo seguro y pregunta lo importante.
- Herramientas que hacen demasiado. Una herramienta
run_anythinges imposible de controlar. Mejor varias pequeñas y claras. - Fiarse de los resultados. Lo que devuelve una herramienta —una página web, un archivo de terceros— son datos, no órdenes.
- Creer que los permisos son una frontera perfecta. Las reglas sobre comandos comparan el texto del comando y se pueden esquivar escribiéndolo de otra forma. Son un primer filtro; la protección completa está en Ejecución segura.
Cuándo usarlo
Desde el principio: revisa qué herramientas tiene tu agente y configura qué puede hacer sin preguntar. Añade herramientas nuevas solo cuando una tarea las necesite, y empieza por las de solo lectura.
Siguiente paso
Las herramientas incluidas cubren tu proyecto local. Para conectar el agente con servicios externos —una base de datos, GitHub, un gestor de tareas— existe un estándar: MCP.
Fuentes
Consultadas el 2026-10-05.
- Function calling, guía de OpenAI.
- Configure permissions, documentación de Claude Code.
Contenido relacionado
- Model Context Protocol (MCP)Herramienta
Un protocolo abierto para conectar agentes con servicios externos —bases de datos, GitHub, gestores de tareas— sin crear una integración distinta para cada uno. Añade capacidades, y también riesgo.
Publicado - Ejecución segura de agentesTécnica
Por qué las reglas escritas no bastan para contener a un agente y qué capas del entorno limitan el daño aunque el agente se equivoque o alguien lo engañe.
Publicado