← 返回博客

工具执行前的安全边界——PreToolUse 集中拦截与 safe/ask/allow-all

Agent 平台里,工具执行如果没有统一的安全边界,每个工具都会长出自己的一套「能不能做」的判断,最终变成一盘散沙,而且很容易漏。我的做法是把它收敛成一条管线。

PreToolUse 集中拦截:所有工具调用在执行前过同一道闸门,按 safe / ask / allow-all 三档分流
ToolCall 请求工具 + 参数SessionToolContext注入会话与凭据PreToolUse 集中拦截统一安全边界三档判定safe / ask / allow-allsafe直接放行执行ask人在回路确认allow-all直接拦截

一、把会话与凭据放对位置

第一件事是 SessionToolContext:把会话信息和凭据注入到工具执行上下文。工具不再自己到处找「我是谁、我有哪些权限」,而是从统一上下文里取——权限判断因此有了一个稳定的输入。

二、PreToolUse:一道集中的闸门

第二件事是构建 PreToolUse 集中拦截管线:所有工具调用在真正执行之前,先过这一道闸门。它带来两个好处:

三、safe / ask / allow-all 三档

拦截不是二元的「放行 / 禁止」,而是三档:

这样新工具接入时自动继承这套边界,而不是每个工具各自实现一遍「安全检查」。

四、为什么是「集中」而不是「每个工具自己写」

安全边界分散到工具里,有三类必然失败:新工具会忘记写、写法不一致、改规则要改 N 处。集中拦截把「能不能做」从业务逻辑里抽出来,变成一个统一的、可测试的横切面。

五、复盘

权限不是给 Agent 上锁,而是给「不可靠的推理」加一道确定性的门。safe/ask/allow-all 的意义在于:把判断分成「确定安全」「需要人」「确定禁止」三类,各自用最合适的方式处理,而不是让模型替你做安全决策。