Skills and Tools 治理

观察工具使用、审查声明的 skill，并为 MCP 和 relay 模型工具应用 allow-list 策略。

Skills & Tools 页面将声明的工具与实际调用分开，避免把提供的工具误认为已运行。

启用观察

打开 AI Firewall -> Agent Config -> Tool governance。

设置	默认值	含义
Capture tool use	Off	记录 gateway MCP 与 relay 模型流量中的工具调用。
Tool enforcement	Observe only	只记录决策；启用 Block calls outside the allow-list 后才阻止。

捕获默认关闭。开启后先 observe-only，直到选择阻止。未配置 allow-list 时 Agent 保持开放，不会因空策略被拒绝。

审查 Skills & Tools#

页面显示工具、调用、声明、未审查项、热门工具/skill 和每日活动。按 Source（MCP/Relayed model traffic）及 Review state（Unreviewed only）筛选，查看名称、来源、计数、首次/最近使用和状态。

声明表示工具提供给模型；调用表示 Agent 实际执行。

自定义 skills#

Skill catalog 的 Save skill 字段：Id、Name、Target mode（当前 webhook）、Validation、Description 和可选 Payload schema。Curated skill 使用 JSON Schema 子集；Free form 允许无 schema 验证。Retire 软删除，保留历史解释但不能用于新命令。

自定义 skill 经授权、验证、审计后发往 Agent webhook；AI-FW 不执行任意 skill 代码。

工具 allow-list#

Agent、policy 和 swarm 层级中最具体的适用列表优先。名称可为 Shell、Read、Cursor tool、MCP server/tool 或 subagent type。先 observe-only 了解清单再阻止。参数以元数据/digest 表示，不作为任意内容库保存。