人工智能AI AgentAI 安全治理策略引擎Agent 沙箱认证鉴权【免费下载链接】agent-governance-toolkitAI Agent Governance Toolkit — Policy enforcement, zero-trust identity, execution sandboxing, and reliability engineering for autonomous AI agents. Covers 10/10 OWASP Agentic Top 10.项目地址https://gitcode.com/GitHub_Trending/ag/agent-governance-toolkit点击查看免费下载本指南以 policy-engine/docs/adapter-mediation.md 为主线系统讲解 Agent Control SpecificationACS运行时如何通过包装器wrapper模式中介受治理的模型调用、工具调用与 Agent 运行涵盖pre_*/post_*接入点、allow/deny/warn/transform四种裁决语义、包装器保证wrapper guarantee、各语言 SDK 的适配器清单以及中介失败与下游调用失败的严格区分。读完本文你将掌握 ACS 中介模型的设计约束、四种语言的适配器选型与接入方式以及如何利用保留原因reserved reason定位治理链上的故障。一、核心概念适配器如何卡位受治理调用路径ACS 适配器的本质是把 ACS 运行时放到被包装操作唯一允许的调用路径上。它不是旁路监听而是强制中介宿主只能通过适配器暴露的表面surface调用底层模型或工具任何绕过该表面的调用都不在治理范围内。接入点intervention point按调用类型分为三类每一类都成对出现模型适配器在调用模型前评估pre_model_call在返回模型响应前评估post_model_call工具适配器在调用工具前评估pre_tool_call在返回工具结果前评估post_tool_callAgent 运行适配器在 Agent 主体执行前评估input在最终返回前评估output。以 Rust Rig 集成 policy-engine/integrations/rig/src/lib.rs 的GuardedRigTool::call_with_result为例可以清晰看到这条调用链的顺序let (effective_args, pre_result) self.control .pre_tool_call_with_options(name, raw_args, options)?; // ① 调用前评估 let output self.inner.call(serde_json::to_string(effective_args)?).await?; // ② 调用真实工具 let (effective_output, post_result) self.control .post_tool_call_with_options(name, effective_args, raw_output, options)?; // ③ 返回前评估Rust 的ToolDyn::calltrait 只能返回String因此需要保留具体GuardedRigTool值、在擦除为dyn ToolDyn之前调用call_with_result才能拿到post_tool_call的 ACS 元数据如result_labels用于后续 IFC 传播。1.1 四种裁决语义中介点的评估结果verdict只有四种其中只有一种是变更性的裁决语义allow放行以原始策略目标policy target执行被包装的可调用对象warn放行以原始策略目标执行可携带告警信息deny在 pre 点阻止被包装的模型、工具、运行器、过滤器续体或上游应用执行transform唯一具有变更语义的裁决在 pre 点被包装的可调用对象收到转换后的请求/参数在 post 点适配器返回转换后的响应/结果Python 侧测试 policy-engine/sdk/python/tests/test_adapter_mediation.py 明确标注了这一约定TRANSFORM is the only mutating decision; auto-pick it when the caller provided a transformed_policy_target——即调用方只要提供了transformed_policy_target就自动选择TRANSFORM。同文件第 65-69 行的用例验证了双向转换{q: raw}经 pre 点转换为{q: safe}传给真实 runnable真实返回值再经 post 点转换为{answer: checked}返回给调用方。二、中介保证Wrapper Guarantee治理成立的前提中介保证是一种包装器保证它的成立条件是宿主只发布并调用被守卫的对象guarded object/function/middleware/hook/provider/filter宿主不得保留或发布原始未包装模型/工具的独立引用宿主不得调用适配器表面之外的替代框架方法能识别不安全替代方法的适配器会直接阻止这些方法接收next委托或显式上游可调用对象的适配器表面依赖框架按顺序调用适配器的契约。各语言 SDK 对该保证的执行强度不同这与运行时能力直接相关RustRigGuardedRigTool把内部工具保存在inner: Arcdyn ToolDyn字段中见 policy-engine/integrations/rig/src/lib.rs只对外暴露该值实现的ToolDyn。但若宿主克隆了原始Arcdyn ToolDyn仍可直接调用所以 Rig 集成者必须只注册并保留守卫后的工具。ToolDyn for GuardedRigTool的实现同文件第 157-175 行确保call一定走call_with_result这条治理路径。.NET委托型聊天客户端delegating chat client与 MCP provider 把被包装的客户端/可调用对象保存在私有字段中Semantic Kernel 与 AutoGen 中间件则每次调用时接收框架续体因此宿主契约是框架把 ACS 中间件注册进调用流水线。Python / Node鸭子类型返回代理对象或包装函数运行时无法阻止保存了原始对象的宿主直接调用。集成者必须在注册后丢弃未包装引用且只能向框架注册守卫后的代理。GHCPGitHub Copilot 权限钩子基于 hook 的中介通过中介权限钩子值permission hook values工作依赖 GHCP 在底层工具调用前兑现 deny 决策与修改后的参数。三、当前适配器清单Adapter Inventory文档列出了四个 SDK 的适配器矩阵与 policy-engine/docs/adapter-matrix.md 中的覆盖表相互印证n/a 表示该框架在该语言没有第一方包base 表示走通用包装器而非专用形态RustRig 工具适配器integrations/rig依赖承载 crate实现rig::tool::ToolDyn另有不依赖rig-core的RigLikeTool/GuardedRigLikeTool抽象。PythonLangChain runnable、OpenAI client、OpenAI Agents runner、Anthropic client、MCP tool 与 server、Semantic Kernel function 与 filter、AutoGen agent、CrewAI crew、LiteLLM proxy 适配器源码见 policy-engine/sdk/python/agent_control_specification/_adapters/。Node通用模型中间件与模型包装、LangChain runnable、OpenAI Agents runner、Anthropic client 与 tool、MCP tool provider、OpenClaw 显式钩子、GHCP 钩子。.NETMCP tool provider、Semantic Kernel function filter、AutoGen middleware、delegating chat client、通用 agent 中间件、通用工具调用过滤器。其中 Rust 侧还发布了两个专用依赖承载 crateagent_control_specification_openaiintegrations/openai基于真实async-openai的GuardedOpenAiToolExecutor与agent_control_specification_mcpintegrations/mcp基于官方rmcp的GuardedMcpToolExecutor/GuardedMcpServer不使用这些 crate 的宿主仍可走通用run_tool/ProtectedTool表面。四、Rig 适配器进阶用法环境快照与结果标签文档特别强调了 Rig 适配器的两个关键方法对应 policy-engine/integrations/rig/src/lib.rs 的实现GuardedRigTool::with_ambient_snapshot当策略需要宿主上下文如snapshot.ifc.source_labels、租户标识、请求元数据时使用。它把额外字段附加到每次pre_tool_call与post_tool_call的评估快照上。GuardedRigTool::call_with_result当宿主需要在擦除为dyn ToolDyn之前拿到 post-tool 的 ACS 元数据如result_labels供后续 IFC 传播时使用普通ToolDyn::calltrait 只返回 Rig 工具字符串。文档还给出了一个与中介模型强相关的快照契约根据 policy-engine/docs/snapshot-contract.mdpre_tool_call快照要求tool_call.name、tool_call.args可选tool_call.idpost_tool_call要求tool_call.name、tool_result可选tool_call.id。tool_call.id在所有 SDK 宿主 API 中统一处理可选、当提供时校验为长度大于零的字符串、原样保留字节含空白、未提供时完全省略该字段任何 SDK 层都不得伪造合成 id——因为它参与 sha256 动作身份action identity计算伪造会破坏 pre/post 评估的确定性。策略作者必须把tool_call.id视为可选字段需要时用缺省即拒绝模式显式 denypolicy-engine/policy/lib/approval.rego 等策略库中的valid_tool_call_id/requireRego 辅助函数正是为此而设计。五、失败模式Failure Modes中介失败 vs 下游调用失败ACS 严格区分两类失败这是故障排查的关键分界线5.1 中介失败Mediation Failure指守卫路径内部、由 ACS 拥有的任何失败包括策略分发器policy dispatcher抛异常裁决无法反序列化verdict fails to deserialize注解分发失败审批解析器approval resolver抛异常、返回 null 或返回无法识别的结果适配器收到不支持的框架方法。每一类中介失败都 fail closed失败即关闭并产生带保留原因的DENY引擎失败runtime_error:*例如runtime_error:annotation_failed宿主层失败host_error:*例如host_error:approval_resolver_failed、host_error:adapter_unsupported。时序上有两个关键窗口pre-call 中介失败与不支持方法失败发生在被包装的模型/工具运行之前调用被阻止上游不执行post-call 中介失败包括缓冲流式输出之后的 post-model 审批失败发生在上游返回之后会阻止守卫后的响应到达调用方。Python 测试 policy-engine/sdk/python/tests/test_adapter_mediation.py 中的AdapterUnsupportedError正是适配器收到不支持框架方法这一失败类型的体现LangChain 守卫代理的同步invoke被判定为不支持的方法而抛出异常未执行真实调用。5.2 下游调用失败Downstream Callable Failure指被包装的模型/工具自身在pre_tool_call/pre_model_call已放行之后抛出的异常。ACS不会把这个异常转换成策略拒绝policy denial异常原样传播给调用方对应的 post 点不会运行——因为失败源于 ACS 被要求调用的宿主代码而非 ACS 执行的中介本身需要治理失败工具结果的宿主必须把结构化结果暴露给 post 点而不是直接抛出异常。六、结语中介模型的取舍与适用前提ACS 适配器中介是一个强包装、弱旁路的模型它把治理边界收敛到适配器表面以包装器保证为前提换取全覆盖的变更能力transform 参数/结果与确定性的失败关闭语义。使用时的关键约束可归纳为三条注册纪律宿主必须只注册/只调用守卫后的对象Python/Node 这类鸭子类型运行时尤其要在注册后丢弃未包装引用表面纪律不要调用适配器表面之外的框架方法能识别替代方法的适配器会主动阻止故障分类纪律中介失败看保留原因runtime_error:*/host_error:*下游失败让异常原样传播——两者不要混淆也不要期望 ACS 把模型/工具自身的异常翻译成策略裁决。更完整的框架覆盖矩阵、每行 n/a/base 的判定依据及 .NET 双层打包依赖无关的基础包 携带真实框架依赖的伴生包与 Rust 依赖承载 crate 的对照设计可进一步阅读 policy-engine/docs/adapter-matrix.md接入点的完整快照字段契约见 policy-engine/docs/snapshot-contract.mdRig 集成实现与测试见 policy-engine/integrations/rig/。赞分享人工智能AI AgentAI 安全治理策略引擎Agent 沙箱认证鉴权【免费下载链接】agent-governance-toolkitAI Agent Governance Toolkit — Policy enforcement, zero-trust identity, execution sandboxing, and reliability engineering for autonomous AI agents. Covers 10/10 OWASP Agentic Top 10.项目地址https://gitcode.com/GitHub_Trending/ag/agent-governance-toolkit点击查看免费下载相关推荐Agent Governance Toolkit 的框架适配器统一包 agent-governance-toolkit-integrationsextras 安装机制与旧包迁移指南Agent Governance Toolkit 的框架适配器统一包 agent governance toolkit integrationsextras人工智能AI AgentAI 安全治理策略引擎Agent 沙箱认证鉴权存量 Agent 无侵入接入治理Agent Governance Toolkit Retrofit Governance 实战指南存量 Agent 无侵入接入治理Agent Governance Toolkit Retrofit Governance 实战指南 本指南面向已经运行中的 A人工智能AI AgentAI 安全治理策略引擎Agent 沙箱认证鉴权Agent Governance Toolkit 实战Wisdom Curator 人机协同审查机制——从检查语法到审批知识的范式转移Agent Governance Toolkit 实战Wisdom Curator 人机协同审查机制——从检查语法到审批知识的范式转移 导读 本文基于 age人工智能AI AgentAI 安全治理策略引擎Agent 沙箱认证鉴权创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
