Gobernanza de Skills and Tools
Observe el uso de herramientas, revise skills declaradas y aplique allow-lists para MCP y herramientas de modelos reenviadas.
La página Skills & Tools muestra las herramientas disponibles para los agentes y las que realmente utilizaron. Separa declaraciones de invocaciones: ofrecer una herramienta no significa que se haya ejecutado.
Activar observación#
Abra AI Firewall -> Agent Config -> Tool governance.
| Ajuste | Predeterminado | Significado |
|---|---|---|
| Capture tool use (ai_fw_tool_governance_enabled) | Off | Registra llamadas de la superficie MCP del gateway y del tráfico de modelos reenviado. |
| Tool enforcement | Observe only | Registra decisiones sin bloquear. Block calls outside the allow-list activa enforcement. |
La captura está apagada inicialmente. Al activarla, solo observa hasta que se seleccione el bloqueo. Sin allow-list, el agente permanece sin restricciones; una política vacía no lo deniega.
Revisar Skills & Tools#
La página muestra herramientas vistas, invocaciones, declaraciones, herramientas sin revisar, herramientas principales, skills más usadas y actividad diaria.
Filtre por Source (MCP o Relayed model traffic) y Review state (Unreviewed only). Revise nombre, origen, recuento, primer y último uso y estado de revisión.
Una declaración es una herramienta ofrecida al modelo; una invocación es una llamada realmente realizada por un agente.
Definir skills personalizadas#
El catálogo Skill permite Save skill con estos campos:
| Campo | Significado |
|---|---|
| Id | Identificador estable usado por una concesión swarm; una ID existente actualiza la skill. |
| Name | Nombre visible. |
| Target mode | Destino; la UI actual ofrece webhook. |
| Validation | Skills curadas usan un subconjunto JSON Schema. Free form permite JSON sin validación de esquema. |
| Description | Descripción para operadores. |
| Payload schema | Subconjunto opcional JSON Schema, validado al guardar. |
Retire elimina lógicamente la skill. El registro se conserva para interpretar auditorías y concesiones antiguas, pero la skill retirada no se usa en nuevas órdenes.
Las skills personalizadas se autorizan, validan, auditan y reenvían al webhook del agente registrado. AI-FW no ejecuta código arbitrario de skills.
Allow-list de herramientas#
Las decisiones usan las allow-lists aplicables de agente, política y swarm. La lista más específica prevalece. Los nombres pueden ser Shell, Read, nombre de herramienta Cursor, identidad MCP server/tool o subagent type.
Empiece con observe-only para conocer el inventario real antes de bloquear. Los argumentos se representan con metadatos y digests, no se guardan como un segundo almacén de contenido.
Documentación relacionada#
- Cursor Agent Hooks
- Referencia de IDE Artifacts
- Gobernar llamadas a herramientas MCP
- Chain of Command