VoltAgent 运行时护栏

要解决的问题

给 TypeScript 写的代理（agent）一旦跑起来，默认是信任模型自己生成的每一步：提示词写错了、模型开始胡言乱语、或者返回了超出授权范围的内容，程序照样往下执行。等到线上出问题再补救，往往已经发生了越权调用或脏数据落库。这个技能要解决的就是运行时缺一层可验证的关卡——在代理真正执行工具、发出请求之前，把输入和输出拦下来做一次检查。

技能如何工作

核心思路是把防护逻辑放进代理工作流的运行路径里，而不是散落在各个业务函数里：

• 拦截与验证：在代理工作流中拦截每一轮的输入与输出，并按你定义的策略执行校验，命中规则的请求不会继续往下跑。
• 监督者与子代理：以监督者运行时统管一组专门的子代理，监督者负责路由任务并维持各子代理之间的同步，护栏统一挂在监督者这一层。
• 评估闭环：在工作流中直接跑代理评估套件，用可度量的结果衡量代理行为是否符合预期，再把结论反馈给策略调整。

实际使用时建议先明确两件事：哪些输入是必须校验的（比如外部传入的自由文本），哪些输出是必须约束的（比如写库、发请求前的最后一道检查）。策略定义清楚了，拦截点才有依据。

适用边界与注意点

• 面向 Node.js / TypeScript 项目，且已经引入 VoltAgent 包并具备模型提供商凭证，不满足这几点需要先补齐环境。
• 它是运行时防护，替代不了权限模型和数据访问层本身的隔离设计；该做的鉴权和最小权限仍然要做。
• 评估套件衡量的是行为是否符合策略，不保证代理在所有场景下绝对不出错，策略质量本身需要结合真实用例持续打磨。
• 策略覆盖不到的路径（比如完全绕过 VoltAgent 直接发起的调用）不会被拦截，接入时建议梳理一遍代理的完整调用链。