Gouvernance Skills and Tools
Observer l’usage des outils, examiner les skills déclarées et appliquer les allow-lists MCP et des outils de modèles relayés.
La page Skills & Tools distingue outils déclarés et réellement invoqués : la présence d’un outil proposé ne signifie pas qu’il a été utilisé.
Activer l’observation#
Ouvrez AI Firewall -> Agent Config -> Tool governance.
| Paramètre | Défaut | Signification |
|---|---|---|
| Capture tool use (ai_fw_tool_governance_enabled) | Off | Consigne appels MCP du gateway et trafic de modèles relayé. |
| Tool enforcement | Observe only | Consigne les décisions sans bloquer. Block calls outside the allow-list active le blocage. |
La capture est désactivée par défaut. Son activation reste observe-only jusqu’au choix du blocage. Sans allow-list, l’agent reste libre ; une liste vide ne le bloque pas.
Examiner Skills & Tools#
La page indique outils observés, invocations, déclarations, outils non examinés, principaux outils et skills, et activité quotidienne. Filtrez par Source (MCP ou Relayed model traffic) et Review state (Unreviewed only). Vérifiez nom, source, compteurs, dates de première/dernière utilisation et état.
Une déclaration est une offre faite au modèle ; une invocation est un appel réellement effectué.
Définir des skills personnalisées#
Dans le catalogue Skill, Save skill accepte :
| Champ | Signification |
|---|---|
| Id | Identifiant stable d’une concession swarm ; une ID existante met à jour la skill. |
| Name | Nom affiché. |
| Target mode | Cible ; l’UI propose actuellement webhook. |
| Validation | Skills curées : sous-ensemble JSON Schema. Free form permet JSON sans validation de schéma. |
| Description | Description opérateur. |
| Payload schema | Sous-ensemble JSON Schema facultatif, validé à l’enregistrement. |
Retire retire logiquement la skill ; son entrée reste pour interpréter anciens audits et concessions, mais elle ne sert plus aux nouvelles commandes.
Les skills personnalisées sont autorisées, validées, auditées et relayées vers le webhook de l’agent enregistré. AI-FW n’exécute pas leur code arbitraire.
Allow-list des outils#
Les décisions utilisent les allow-lists applicables par agent, politique et swarm ; la plus spécifique prévaut. Les noms peuvent être Shell, Read, outil Cursor, identité MCP server/tool ou subagent type.
Commencez par observe-only pour connaître l’inventaire avant blocage. Les arguments sont représentés par des métadonnées et digests, pas conservés comme un second stockage de contenu.