Governança de Skills and Tools
Observe uso de ferramentas, revise skills declaradas e aplique allow-lists para MCP e ferramentas de modelos encaminhadas.
A página Skills & Tools separa o que os agentes declaram do que realmente invocam, para que uma ferramenta oferecida não seja confundida com uma execução.
Habilitar observação#
Abra AI Firewall -> Agent Config -> Tool governance.
| Configuração | Padrão | Significado |
|---|---|---|
| Capture tool use (ai_fw_tool_governance_enabled) | Off | Registra chamadas de ferramentas da superfície MCP e tráfego de modelo encaminhado. |
| Tool enforcement | Observe only | Registra decisões sem bloquear. Block calls outside the allow-list habilita bloqueios. |
Captura começa desligada. Ao ligar, permanece observe-only até selecionar bloqueio. Sem allow-list, o agente continua irrestrito; política vazia não o nega.
Revisar Skills & Tools#
A página mostra ferramentas vistas, invocações, declarações, ferramentas não revisadas, principais ferramentas/skills e atividade diária. Filtre por Source (MCP ou Relayed model traffic) e Review state (Unreviewed only). Confira nome, origem, contadores, primeiro/último uso e estado.
Declarações são ofertas ao modelo; invocações são chamadas realmente feitas por agentes.
Definir skills personalizadas#
O catálogo Skill permite Save skill com:
| Campo | Significado |
|---|---|
| Id | Identificador estável usado por concessão de swarm; ID existente atualiza a skill. |
| Name | Nome exibido. |
| Target mode | Destino; a UI atual oferece webhook. |
| Validation | Skills curadas usam subconjunto de JSON Schema. Free form permite JSON arbitrário sem validação. |
| Description | Descrição para operadores. |
| Payload schema | Subconjunto opcional de JSON Schema validado ao salvar. |
Retire remove a skill logicamente. O registro permanece para explicar auditorias e concessões antigas, mas a skill não funciona em novas ordens.
Skills personalizadas são autorizadas, validadas, auditadas e encaminhadas ao webhook do agente registrado. O AI-FW não executa código arbitrário delas.
Allow-list de ferramentas#
Decisões usam allow-lists aplicáveis por agente, política e swarm; a mais específica prevalece. Nomes podem ser Shell, Read, ferramenta Cursor, identidade MCP server/tool ou subagent type.
Comece em observe-only para conhecer o inventário antes de bloquear. Argumentos são representados por metadados e digests, não armazenados como outro repositório de conteúdo.
Documentação relacionada#
- Cursor Agent Hooks
- Referência de IDE Artifacts
- Governar chamadas de ferramentas MCP
- Chain of Command