LangChain AgentMesh 集成实战为 LangChain Agent 构建 Ed25519 身份认证与信任门控工具执行【免费下载链接】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-toolkitAgent 在调用敏感工具、与其他智能体协作时如何证明我是谁、如何判断对方是否可信、如何限制能做什么是 AI Agent 治理的关键问题。本指南以 Agent Governance Toolkit 中的 langchain-agentmesh 集成 为对象讲解如何为 LangChain Agent 引入 Ed25519 密码学身份VerificationIdentity、信任门控工具TrustGatedTool / TrustedToolExecutor、握手校验TrustHandshake与委托链DelegationChain。读完本文你将掌握一套可在 LangChain 应用中直接落地的先验证、后执行信任执行链路并理解其底层源码实现与测试保障。一、集成包概览与安装langchain-agentmesh是 Agent Governance Toolkit 中面向 LangChain 生态的信任集成层定位是为 LangChain Agent 提供密码学身份验证与信任门控工具执行。其目录结构如下agent-governance-python/agentmesh-integrations/langchain-agentmesh/ ├── langchain_agentmesh/ │ ├── __init__.py # 公共 API 导出含弃用告警 │ ├── identity.py # VerificationIdentity / VerificationSignature / UserContext │ ├── trust.py # TrustHandshake / TrustPolicy / TrustedAgentCard / DelegationChain / AgentDirectory │ ├── tools.py # TrustGatedTool / TrustedToolExecutor │ └── callbacks.py # TrustCallbackHandler ├── tests/test_agentmesh.py ├── pyproject.toml └── README.md原 README 给出的安装命令为pip install agentmesh-langchain需要注意的迁移前提从当前仓库源码看该包已进入弃用周期。langchain_agentmesh/__init__.py在导入时会抛出DeprecationWarning提示改用合并后的统一包import warnings warnings.warn( agentmesh-langchain is deprecated and will be removed in a future release. Use agent-governance-toolkit-integrations[langchain] instead. ... DeprecationWarning, )同时 pyproject.toml 中的描述明确写着 Deprecated. Previously published as agentmesh-langchain其依赖已切换为agent-governance-toolkit-integrations[langchain]5.0.0,6.0并要求requires-python 3.11。因此新项目应直接安装合并后的集成包pip install agent-governance-toolkit-integrations[langchain]该统一包位于 agent-governance-python/agent-governance-toolkit-integrations按框架提供 extras 选择如[crewai,openai-agents]。另外identity.py中还有一个运行前提真实的 Ed25519 加解密依赖cryptography库。若未安装包会进入非加密的模拟模式并抛出RuntimeWarning此时签名不做真正的密码学验证。生产环境务必安装pip install langchain-agentmesh[crypto] # 或 pip install cryptography44.0.0二、核心特性一览原 README 列出的六大特性在源码中均有对应实现可在init.py 的__all__中确认全部导出特性说明源码位置VerificationIdentity基于 Ed25519 的密码学身份DID 密钥对 能力声明 TTLidentity.pyTrustGatedTool为任意工具包裹信任要求能力 信任分数门槛tools.pyTrustedToolExecutor自动完成验证、审计与策略强制的工具执行器tools.pyTrustCallbackHandler在链式执行中监控信任事件、阻断未验证调用callbacks.pyTrustHandshake协作前校验对端 Agent 的身份与信任trust.pyDelegationChain分层能力委托scope chain支持链式授权与防提权trust.py除此之外源码还额外导出VerificationSignature、UserContextOBO 用户上下文、TrustPolicy、TrustVerificationResult、TrustedAgentCard、AgentDirectory等类型共同构成完整的信任体系。三、快速上手从身份生成到信任门控执行原 README 的 Quick Start 给出了一条最简链路下面是结合当前源码 API 校准后的完整可用版本from langchain_agentmesh import VerificationIdentity, TrustGatedTool, TrustedToolExecutor # 1. 生成 Agent 身份Ed25519 密钥对 能力声明 identity VerificationIdentity.generate( research-agent, capabilities[search, summarize], ) # 2. 将任意 LangChain 工具包裹为信任门控工具 gated_tool TrustGatedTool( toolsearch_tool, required_capabilities[search], min_trust_score0.8, ) # 3. 通过执行器调用自动完成身份验证 executor TrustedToolExecutor(identityidentity) result executor.invoke(gated_tool, query)几点源码级说明避免照抄示例踩坑VerificationIdentity.generate(agent_name, capabilitiesNone, ttl_secondsNone)会基于agent 名 时间戳的 SHA-256 摘要生成形如did:verification:32位hex的 DID见 identity.py。ttl_seconds可指定身份有效期过期后is_expired()返回True。TrustGatedTool.__init__的实际参数为(tool, required_capabilitiesNone, min_trust_score0.7, description_suffix)其中tool既可以是 LangChain 的BaseTool也可以是普通可调用对象源码会自动提取工具名与描述见 tools.py。TrustedToolExecutor.invoke(tool, input_data, invoker_cardNone)的第二个参数是输入数据不传invoker_card时执行器会以自身身份构造一张自调用卡片并签名然后再走完整的信任校验流程见 tools.py。校验失败会抛出PermissionError。如果只是封装一个普通 Python 函数还可以使用便捷工厂create_trust_gated_tool(func, required_capabilities..., min_trust_score...)内部会先通过StructuredTool.from_function转成标准工具再包裹。四、密码学身份层深入VerificationIdentity 与 Ed25519identity.py是整个集成的地基其模块注释明确说明它采用 verificationCryptographic Multi-Vector Keys方案管理身份用 Ed25519 完成密码学运算。核心数据结构如下VerificationSignature一条签名记录包含algorithm默认verification-Ed25519、public_key、signature与 UTCtimestamp支持to_dict/from_dict序列化。VerificationIdentityAgent 身份字段包括did、agent_name、public_key、private_keybase64、capabilities、created_at、expires_atTTL 强制。核心方法sign(data)用私钥签名返回VerificationSignature无私钥时抛ValueError。verify_signature(data, signature)先校验算法标识再用hmac.compare_digest比对公钥最后做 Ed25519 验签。在缺少 cryptography 的模拟模式下验签一律返回False即不可验证即失败关闭fail closed这是有意为之的安全设计见 identity.py。public_identity()返回剔除私钥的公开身份副本用于对外分发。to_dict()/from_dict()序列化时刻意排除私钥避免密钥泄露。UserContext面向 On-Behalf-OfOBO场景的用户上下文携带user_id、roles、permissions支持*通配、issued_at、expires_at提供is_valid()、has_permission()、has_role()等判定方法。当 Agent 代表终端用户行动时该上下文会随信任层传播使下游 Agent 能执行用户级访问控制见 identity.py。从 tests/test_agentmesh.py 的TestVerificationIdentity用例可以看到该层的验证行为签名后verify_signature返回True但对篡改后的数据验签必然失败TTL 系列测试则覆盖了无 TTL 永不过期、TTL 序列化往返、公开身份保留过期时间但剔除私钥等边界见TestVerificationIdentityTTL。五、信任校验与握手TrustHandshake、TrustPolicy 与 TrustedAgentCard5.1 多 Agent 信任验证原 README 用例的源码校准版原 README 的 Multi-Agent 示例为from langchain_agentmesh import TrustHandshake handshake TrustHandshake(my_identity) result await handshake.verify_peer(peer_identity) if result.trusted: response await peer_agent.invoke(task)需要指出当前源码中TrustHandshake.verify_peer是同步方法且入参是TrustedAgentCard对端 Agent 的签名卡片而非裸身份。正确的调用方式是先让对方签发卡片from langchain_agentmesh import TrustHandshake, TrustedAgentCard, VerificationIdentity my_identity VerificationIdentity.generate(my-agent) peer_identity VerificationIdentity.generate(peer-agent, [search]) # 对端构造并签名自己的 Agent Card peer_card TrustedAgentCard( namePeer Agent, descriptionA peer, capabilities[search], ) peer_card.sign(peer_identity) # 我方发起握手校验 handshake TrustHandshake(my_identity) result handshake.verify_peer( peer_card, required_capabilities[search], min_trust_score0.8, ) if result.trusted: response await peer_agent.invoke(task)TrustedAgentCard是 Agent 的信任名片包含name、description、capabilities、trust_score、identity、card_signature、scope_chain、user_context等字段。卡片内容通过确定性的 JSON 序列化后由身份私钥签名verify_signature()会验证签名有效性见 trust.py。5.2 verify_peer 的完整校验流水线从源码看TrustHandshake.verify_peer依次执行以下检查见 trust.py缓存命中按 DID 查询缓存TTL 由cache_ttl_seconds控制命中直接返回避免重复验签身份存在性无identity直接判定不可信DID 格式必须为did:verification:前缀卡片签名peer_card.verify_signature()失败即拒绝信任分数peer_card.trust_score低于min_trust_score策略默认 0.7即拒绝Scope Chain 校验若卡片携带委托链则验证链的密码学合法性并把链上最终委托的能力与卡片声明的能力取交集作为有效能力防止卡片虚报能力必需能力校验调用方要求的required_capabilities必须全部包含在有效能力内结果缓存通过后写入缓存。5.3 委托链DelegationChain与防滥用机制DelegationChain支持以根身份为锚点逐级向子 Agent 委托能力。add_delegation(delegatee, capabilities, expires_in_hoursNone, delegator_identityNone)会用委托者私钥对规范化的委托载荷_delegation_signing_payloaddelegator、delegatee、排序后的 capabilities、过期时间签名形成不可篡改的委托记录。TrustHandshake.verify_scope_chain对委托链的校验是当前实现中最精细的部分包含以下硬约束均有对应测试校验项说明测试用例锚定根身份链首delegator必须是验证者自己的 DIDtest_verify_peer_scope_chain_tampered_linkage链尾终止链末delegatee必须等于对端声明的身份同上DID 格式每个节点的 delegator/delegatee 都必须是合法 DIDtest_verify_peer_scope_chain_invalid_delegator_did过期检查支持有界时钟偏移max_delegation_expiry_clock_skew_secondstest_verify_peer_scope_chain_expiry_skew_tolerance签名算法白名单仅允许verification-Ed25519策略也无法启用实现不支持的算法test_verify_peer_scope_chain_unsupported_algorithm、test_verify_peer_scope_chain_policy_cannot_enable_unsupported_algorithm签名时效签名时间戳不得超前时钟偏移上限、不得过旧max_delegation_signature_age_secondstest_verify_peer_scope_chain_stale_signature链式链接相邻委托必须delegator 前一条的 delegateetest_verify_peer_scope_chain_tampered_linkage防环检测循环委托test_verify_peer_scope_chain_circular_delegation防提权子委托的能力不能超出父委托授予的能力test_verify_peer_scope_chain_rejects_permission_escalation防重放回放窗口默认 300 秒内相同指纹的链被拒绝指纹表有界默认 2048 条test_verify_peer_scope_chain_replay_detected、..._replay_cache_bounded限流每对端滑动窗口内限制定次数默认 120 次/60 秒test_verify_peer_scope_chain_rate_limited线程安全全部状态由RLock保护test_verify_peer_scope_chain_thread_safety_smoke此外还有两种过渡模式值得一提strict_scope_chain_verificationFalse时链校验失败仅产生 warning 而不会拒绝调用用于渐进式灰度expose_scope_chain_errorsTrue时会把具体失败原因返回给调用方默认只返回脱敏的通用错误避免泄露内部细节。5.4 AgentDirectory框架级服务发现AgentDirectory提供一个本地轻量注册表支持register未签名卡片会被拒绝、find_by_did、find_by_capability、list_trusted(min_trust_score)、remove、count。生产部署时它可与 AgentMesh 核心注册表配合使用见 trust.py。六、信任门控工具执行TrustGatedTool 与 TrustedToolExecutor6.1 TrustGatedTool原 README 的敏感工具示例Python 代码执行器from langchain_agentmesh import TrustGatedTool code_execution_tool TrustGatedTool( toolpython_repl, required_capabilities[code:execute], min_trust_score0.9, audit_loggingTrue ) result executor.invoke(code_execution_tool, code)关于audit_logging参数的说明当前源码中TrustGatedTool构造器并无audit_logging参数该写法属于旧版示例。在现有实现里审计开关统一由TrustPolicy.audit_all_calls控制TrustedToolExecutor内部维护_audit_log列表每次调用都会生成ToolInvocationRecord含工具名、调用者 DID、时间戳、是否验证通过、信任分数、输入/输出摘要、warnings 等只有audit_all_callsTrue时才会写入被拦截的调用也会以BLOCKED: reason的形式记录见 tools.py。可调用get_audit_log()/clear_audit_log()读取或清空审计记录。正确用法示例from langchain_agentmesh import TrustGatedTool, TrustedToolExecutor, TrustPolicy, VerificationIdentity identity VerificationIdentity.generate(research-agent, [code:execute]) policy TrustPolicy(min_trust_score0.9, audit_all_callsTrue) code_execution_tool TrustGatedTool( toolpython_repl, required_capabilities[code:execute], min_trust_score0.9, ) executor TrustedToolExecutor(identityidentity, policypolicy, tools[code_execution_tool]) result executor.invoke(python_repl, code) # 按名称调用已注册工具TrustedToolExecutor还支持register_tool、get_tool、list_tools。TrustGatedTool.can_invoke(invoker_card, handshake)是校验入口invoke在验证失败时抛出PermissionError只有通过验证的调用才会真正触达底层工具——这正是只有受信任的 Agent 才能使用敏感工具的实现保障。七、回调集成TrustCallbackHandler原 README 的示例写法为from langchain_agentmesh import TrustCallbackHandler callback TrustCallbackHandler( on_verificationlambda r: print(fVerified: {r.peer_did}), on_violationlambda v: alert(fViolation: {v}) ) agent create_agent(callbacks[callback])源码校准当前TrustCallbackHandler继承自langchain_core.callbacks.BaseCallbackHandler构造参数为(identity, policyNone, peer_cardsNone)并不接受on_verification/on_violation这类回调函数事件监听通过子类化或查询事件日志实现。它会按 LangChain 回调协议钩入on_llm_start/end、on_tool_start/end/error、on_chain_start/end、on_agent_action/finish等生命周期事件。在on_tool_start中见 callbacks.py若策略要求验证require_verificationTrue且元数据中携带invoker_did会用握手对已注册的对端卡片做verify_peer验证失败且block_unverifiedTrue默认时记录tool_blocked事件并直接抛出PermissionError阻断工具执行无调用者身份且block_unverifiedTrue时产生 No verified invoker identity provided 告警。准确用法示例from langchain_agentmesh import TrustCallbackHandler, TrustPolicy, VerificationIdentity identity VerificationIdentity.generate(chain-agent) policy TrustPolicy(audit_all_callsTrue, block_unverifiedTrue) callback TrustCallbackHandler(identityidentity, policypolicy) agent create_agent(callbacks[callback])该 handler 还提供add_verified_peer(card)先验证再加入白名单、remove_peer(did)、get_events()、get_events_by_type(type)、get_unverified_events()、get_trust_summary()等管理方法。其中get_trust_summary()返回的摘要包含总事件数、已验证/未验证事件数、验证通过率verification_rate、事件类型分布、已验证对端数、告警总数可直接用于治理仪表盘见 callbacks.py。八、配置参数详解8.1 原 README 参数表附源码默认值校准原 README 给出的配置表如下右侧一列标注了当前源码中的真实默认值参数README 默认值源码实际默认值说明min_trust_score0.50.7所需的最低信任分数TrustGatedTool与TrustPolicy均为 0.7required_capabilities[][]必需的调用能力列表audit_loggingFalse由TrustPolicy.audit_all_calls默认 False控制是否启用审计追踪cache_ttl900900cache_ttl_seconds验证结果缓存时长秒即 15 分钟8.2 TrustPolicy 完整字段源码级trust.py 中的TrustPolicy提供了远超 README 表更细粒度的策略控制字段默认值作用require_verificationTrue是否要求验证min_trust_score0.7最低信任分数allowed_capabilitiesNone允许的能力白名单audit_all_callsFalse是否记录全部调用审计block_unverifiedTrue是否阻断未验证调用cache_ttl_seconds900验证结果缓存 TTLstrict_scope_chain_verificationTrue严格模式链校验失败即拒绝False 时降级为告警expose_scope_chain_errorsFalse是否向调用方暴露链校验失败细节allowed_signature_algorithms[verification-Ed25519]允许的签名算法白名单max_delegation_signature_age_seconds900委托签名最大年龄防旧签名重放max_signature_clock_skew_seconds60签名时间戳允许的时钟偏移max_delegation_expiry_clock_skew_seconds60委托过期允许的时钟偏移replay_window_seconds300防重放窗口replay_detection_enabledTrue是否启用重放检测max_seen_scope_chain_fingerprints2048重放指纹表上限内存有界max_scope_chain_attempts_per_window120每窗口链校验次数上限scope_chain_rate_limit_window_seconds60限流窗口长度这些字段通过TrustHandshake(identity, policy)、TrustedToolExecutor(identity, policy)、TrustCallbackHandler(identity, policy)三个入口注入信任栈实现从执行器到回调监控的全局策略统一。九、测试保障一个用例覆盖一套安全语义集成包的测试集中在 tests/test_agentmesh.py1300 行按组件组织为TestVerificationIdentity、TestTrustedAgentCard、TestTrustHandshake、TestDelegationChain、TestTrustGatedTool、TestTrustCallbackHandler、TestVerificationIdentityTTL、TestUserContext、TestAgentDirectory。重点覆盖的安全语义包括篡改必然失败篡改签名数据、给委托链追加admin能力、伪造链上 delegator DID、破坏链式链接均导致verify_peer拒绝过期必然失败委托过期、签名时间戳过旧均被拒滥用被限制回放窗口内复用相同链被拒、环形委托被拒、子链越权提权被拒、超限流被拒能力收敛生效即使对端卡片声明了write只要委托链只授予read最终有效能力仍以链上收敛结果为准并发安全20 线程并发验证不抛异常、不破坏状态RLock保护序列化往返身份 TTL、UserContext、Agent Card 的to_dict/from_dict往返后语义一致。运行测试cd agent-governance-python/agentmesh-integrations/langchain-agentmesh python -m pytest tests/test_agentmesh.py -v十、相关资源与后续路线核心信任网格平台AgentMeshagent-governance-python/agentmesh/README.md治理内核Agent-OSagent-governance-python/agent-os/README.md集成包总览与迁移指引agent-governance-python/agentmesh-integrations/README.md同族 LangChain 生态治理集成LangGraph Trustagent-governance-python/agentmesh-integrations/langgraph-trust/README.md最后再次提醒两条使用前提一是新项目请直接安装agent-governance-toolkit-integrations[langchain]agentmesh-langchain仅保留兼容二是生产环境必须安装cryptography44.0.0否则身份层会退化为非加密模拟模式并采用 fail-closed 策略。在此基础上Ed25519 身份 信任门控 委托链 回调监控即可为你的 LangChain 多 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/9/18 1:24:55 · 阅读 1.2k LangChain AgentMesh 集成实战：为 LangChain Agent 构建 Ed25519 身份认证与信任门控工具执行
LangChain AgentMesh 集成实战为 LangChain Agent 构建 Ed25519 身份认证与信任门控工具执行【免费下载链接】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-toolkitAgent 在调用敏感工具、与其他智能体协作时如何证明我是谁、如何判断对方是否可信、如何限制能做什么是 AI Agent 治理的关键问题。本指南以 Agent Governance Toolkit 中的 langchain-agentmesh 集成 为对象讲解如何为 LangChain Agent 引入 Ed25519 密码学身份VerificationIdentity、信任门控工具TrustGatedTool / TrustedToolExecutor、握手校验TrustHandshake与委托链DelegationChain。读完本文你将掌握一套可在 LangChain 应用中直接落地的先验证、后执行信任执行链路并理解其底层源码实现与测试保障。一、集成包概览与安装langchain-agentmesh是 Agent Governance Toolkit 中面向 LangChain 生态的信任集成层定位是为 LangChain Agent 提供密码学身份验证与信任门控工具执行。其目录结构如下agent-governance-python/agentmesh-integrations/langchain-agentmesh/ ├── langchain_agentmesh/ │ ├── __init__.py # 公共 API 导出含弃用告警 │ ├── identity.py # VerificationIdentity / VerificationSignature / UserContext │ ├── trust.py # TrustHandshake / TrustPolicy / TrustedAgentCard / DelegationChain / AgentDirectory │ ├── tools.py # TrustGatedTool / TrustedToolExecutor │ └── callbacks.py # TrustCallbackHandler ├── tests/test_agentmesh.py ├── pyproject.toml └── README.md原 README 给出的安装命令为pip install agentmesh-langchain需要注意的迁移前提从当前仓库源码看该包已进入弃用周期。langchain_agentmesh/__init__.py在导入时会抛出DeprecationWarning提示改用合并后的统一包import warnings warnings.warn( agentmesh-langchain is deprecated and will be removed in a future release. Use agent-governance-toolkit-integrations[langchain] instead. ... DeprecationWarning, )同时 pyproject.toml 中的描述明确写着 Deprecated. Previously published as agentmesh-langchain其依赖已切换为agent-governance-toolkit-integrations[langchain]5.0.0,6.0并要求requires-python 3.11。因此新项目应直接安装合并后的集成包pip install agent-governance-toolkit-integrations[langchain]该统一包位于 agent-governance-python/agent-governance-toolkit-integrations按框架提供 extras 选择如[crewai,openai-agents]。另外identity.py中还有一个运行前提真实的 Ed25519 加解密依赖cryptography库。若未安装包会进入非加密的模拟模式并抛出RuntimeWarning此时签名不做真正的密码学验证。生产环境务必安装pip install langchain-agentmesh[crypto] # 或 pip install cryptography44.0.0二、核心特性一览原 README 列出的六大特性在源码中均有对应实现可在init.py 的__all__中确认全部导出特性说明源码位置VerificationIdentity基于 Ed25519 的密码学身份DID 密钥对 能力声明 TTLidentity.pyTrustGatedTool为任意工具包裹信任要求能力 信任分数门槛tools.pyTrustedToolExecutor自动完成验证、审计与策略强制的工具执行器tools.pyTrustCallbackHandler在链式执行中监控信任事件、阻断未验证调用callbacks.pyTrustHandshake协作前校验对端 Agent 的身份与信任trust.pyDelegationChain分层能力委托scope chain支持链式授权与防提权trust.py除此之外源码还额外导出VerificationSignature、UserContextOBO 用户上下文、TrustPolicy、TrustVerificationResult、TrustedAgentCard、AgentDirectory等类型共同构成完整的信任体系。三、快速上手从身份生成到信任门控执行原 README 的 Quick Start 给出了一条最简链路下面是结合当前源码 API 校准后的完整可用版本from langchain_agentmesh import VerificationIdentity, TrustGatedTool, TrustedToolExecutor # 1. 生成 Agent 身份Ed25519 密钥对 能力声明 identity VerificationIdentity.generate( research-agent, capabilities[search, summarize], ) # 2. 将任意 LangChain 工具包裹为信任门控工具 gated_tool TrustGatedTool( toolsearch_tool, required_capabilities[search], min_trust_score0.8, ) # 3. 通过执行器调用自动完成身份验证 executor TrustedToolExecutor(identityidentity) result executor.invoke(gated_tool, query)几点源码级说明避免照抄示例踩坑VerificationIdentity.generate(agent_name, capabilitiesNone, ttl_secondsNone)会基于agent 名 时间戳的 SHA-256 摘要生成形如did:verification:32位hex的 DID见 identity.py。ttl_seconds可指定身份有效期过期后is_expired()返回True。TrustGatedTool.__init__的实际参数为(tool, required_capabilitiesNone, min_trust_score0.7, description_suffix)其中tool既可以是 LangChain 的BaseTool也可以是普通可调用对象源码会自动提取工具名与描述见 tools.py。TrustedToolExecutor.invoke(tool, input_data, invoker_cardNone)的第二个参数是输入数据不传invoker_card时执行器会以自身身份构造一张自调用卡片并签名然后再走完整的信任校验流程见 tools.py。校验失败会抛出PermissionError。如果只是封装一个普通 Python 函数还可以使用便捷工厂create_trust_gated_tool(func, required_capabilities..., min_trust_score...)内部会先通过StructuredTool.from_function转成标准工具再包裹。四、密码学身份层深入VerificationIdentity 与 Ed25519identity.py是整个集成的地基其模块注释明确说明它采用 verificationCryptographic Multi-Vector Keys方案管理身份用 Ed25519 完成密码学运算。核心数据结构如下VerificationSignature一条签名记录包含algorithm默认verification-Ed25519、public_key、signature与 UTCtimestamp支持to_dict/from_dict序列化。VerificationIdentityAgent 身份字段包括did、agent_name、public_key、private_keybase64、capabilities、created_at、expires_atTTL 强制。核心方法sign(data)用私钥签名返回VerificationSignature无私钥时抛ValueError。verify_signature(data, signature)先校验算法标识再用hmac.compare_digest比对公钥最后做 Ed25519 验签。在缺少 cryptography 的模拟模式下验签一律返回False即不可验证即失败关闭fail closed这是有意为之的安全设计见 identity.py。public_identity()返回剔除私钥的公开身份副本用于对外分发。to_dict()/from_dict()序列化时刻意排除私钥避免密钥泄露。UserContext面向 On-Behalf-OfOBO场景的用户上下文携带user_id、roles、permissions支持*通配、issued_at、expires_at提供is_valid()、has_permission()、has_role()等判定方法。当 Agent 代表终端用户行动时该上下文会随信任层传播使下游 Agent 能执行用户级访问控制见 identity.py。从 tests/test_agentmesh.py 的TestVerificationIdentity用例可以看到该层的验证行为签名后verify_signature返回True但对篡改后的数据验签必然失败TTL 系列测试则覆盖了无 TTL 永不过期、TTL 序列化往返、公开身份保留过期时间但剔除私钥等边界见TestVerificationIdentityTTL。五、信任校验与握手TrustHandshake、TrustPolicy 与 TrustedAgentCard5.1 多 Agent 信任验证原 README 用例的源码校准版原 README 的 Multi-Agent 示例为from langchain_agentmesh import TrustHandshake handshake TrustHandshake(my_identity) result await handshake.verify_peer(peer_identity) if result.trusted: response await peer_agent.invoke(task)需要指出当前源码中TrustHandshake.verify_peer是同步方法且入参是TrustedAgentCard对端 Agent 的签名卡片而非裸身份。正确的调用方式是先让对方签发卡片from langchain_agentmesh import TrustHandshake, TrustedAgentCard, VerificationIdentity my_identity VerificationIdentity.generate(my-agent) peer_identity VerificationIdentity.generate(peer-agent, [search]) # 对端构造并签名自己的 Agent Card peer_card TrustedAgentCard( namePeer Agent, descriptionA peer, capabilities[search], ) peer_card.sign(peer_identity) # 我方发起握手校验 handshake TrustHandshake(my_identity) result handshake.verify_peer( peer_card, required_capabilities[search], min_trust_score0.8, ) if result.trusted: response await peer_agent.invoke(task)TrustedAgentCard是 Agent 的信任名片包含name、description、capabilities、trust_score、identity、card_signature、scope_chain、user_context等字段。卡片内容通过确定性的 JSON 序列化后由身份私钥签名verify_signature()会验证签名有效性见 trust.py。5.2 verify_peer 的完整校验流水线从源码看TrustHandshake.verify_peer依次执行以下检查见 trust.py缓存命中按 DID 查询缓存TTL 由cache_ttl_seconds控制命中直接返回避免重复验签身份存在性无identity直接判定不可信DID 格式必须为did:verification:前缀卡片签名peer_card.verify_signature()失败即拒绝信任分数peer_card.trust_score低于min_trust_score策略默认 0.7即拒绝Scope Chain 校验若卡片携带委托链则验证链的密码学合法性并把链上最终委托的能力与卡片声明的能力取交集作为有效能力防止卡片虚报能力必需能力校验调用方要求的required_capabilities必须全部包含在有效能力内结果缓存通过后写入缓存。5.3 委托链DelegationChain与防滥用机制DelegationChain支持以根身份为锚点逐级向子 Agent 委托能力。add_delegation(delegatee, capabilities, expires_in_hoursNone, delegator_identityNone)会用委托者私钥对规范化的委托载荷_delegation_signing_payloaddelegator、delegatee、排序后的 capabilities、过期时间签名形成不可篡改的委托记录。TrustHandshake.verify_scope_chain对委托链的校验是当前实现中最精细的部分包含以下硬约束均有对应测试校验项说明测试用例锚定根身份链首delegator必须是验证者自己的 DIDtest_verify_peer_scope_chain_tampered_linkage链尾终止链末delegatee必须等于对端声明的身份同上DID 格式每个节点的 delegator/delegatee 都必须是合法 DIDtest_verify_peer_scope_chain_invalid_delegator_did过期检查支持有界时钟偏移max_delegation_expiry_clock_skew_secondstest_verify_peer_scope_chain_expiry_skew_tolerance签名算法白名单仅允许verification-Ed25519策略也无法启用实现不支持的算法test_verify_peer_scope_chain_unsupported_algorithm、test_verify_peer_scope_chain_policy_cannot_enable_unsupported_algorithm签名时效签名时间戳不得超前时钟偏移上限、不得过旧max_delegation_signature_age_secondstest_verify_peer_scope_chain_stale_signature链式链接相邻委托必须delegator 前一条的 delegateetest_verify_peer_scope_chain_tampered_linkage防环检测循环委托test_verify_peer_scope_chain_circular_delegation防提权子委托的能力不能超出父委托授予的能力test_verify_peer_scope_chain_rejects_permission_escalation防重放回放窗口默认 300 秒内相同指纹的链被拒绝指纹表有界默认 2048 条test_verify_peer_scope_chain_replay_detected、..._replay_cache_bounded限流每对端滑动窗口内限制定次数默认 120 次/60 秒test_verify_peer_scope_chain_rate_limited线程安全全部状态由RLock保护test_verify_peer_scope_chain_thread_safety_smoke此外还有两种过渡模式值得一提strict_scope_chain_verificationFalse时链校验失败仅产生 warning 而不会拒绝调用用于渐进式灰度expose_scope_chain_errorsTrue时会把具体失败原因返回给调用方默认只返回脱敏的通用错误避免泄露内部细节。5.4 AgentDirectory框架级服务发现AgentDirectory提供一个本地轻量注册表支持register未签名卡片会被拒绝、find_by_did、find_by_capability、list_trusted(min_trust_score)、remove、count。生产部署时它可与 AgentMesh 核心注册表配合使用见 trust.py。六、信任门控工具执行TrustGatedTool 与 TrustedToolExecutor6.1 TrustGatedTool原 README 的敏感工具示例Python 代码执行器from langchain_agentmesh import TrustGatedTool code_execution_tool TrustGatedTool( toolpython_repl, required_capabilities[code:execute], min_trust_score0.9, audit_loggingTrue ) result executor.invoke(code_execution_tool, code)关于audit_logging参数的说明当前源码中TrustGatedTool构造器并无audit_logging参数该写法属于旧版示例。在现有实现里审计开关统一由TrustPolicy.audit_all_calls控制TrustedToolExecutor内部维护_audit_log列表每次调用都会生成ToolInvocationRecord含工具名、调用者 DID、时间戳、是否验证通过、信任分数、输入/输出摘要、warnings 等只有audit_all_callsTrue时才会写入被拦截的调用也会以BLOCKED: reason的形式记录见 tools.py。可调用get_audit_log()/clear_audit_log()读取或清空审计记录。正确用法示例from langchain_agentmesh import TrustGatedTool, TrustedToolExecutor, TrustPolicy, VerificationIdentity identity VerificationIdentity.generate(research-agent, [code:execute]) policy TrustPolicy(min_trust_score0.9, audit_all_callsTrue) code_execution_tool TrustGatedTool( toolpython_repl, required_capabilities[code:execute], min_trust_score0.9, ) executor TrustedToolExecutor(identityidentity, policypolicy, tools[code_execution_tool]) result executor.invoke(python_repl, code) # 按名称调用已注册工具TrustedToolExecutor还支持register_tool、get_tool、list_tools。TrustGatedTool.can_invoke(invoker_card, handshake)是校验入口invoke在验证失败时抛出PermissionError只有通过验证的调用才会真正触达底层工具——这正是只有受信任的 Agent 才能使用敏感工具的实现保障。七、回调集成TrustCallbackHandler原 README 的示例写法为from langchain_agentmesh import TrustCallbackHandler callback TrustCallbackHandler( on_verificationlambda r: print(fVerified: {r.peer_did}), on_violationlambda v: alert(fViolation: {v}) ) agent create_agent(callbacks[callback])源码校准当前TrustCallbackHandler继承自langchain_core.callbacks.BaseCallbackHandler构造参数为(identity, policyNone, peer_cardsNone)并不接受on_verification/on_violation这类回调函数事件监听通过子类化或查询事件日志实现。它会按 LangChain 回调协议钩入on_llm_start/end、on_tool_start/end/error、on_chain_start/end、on_agent_action/finish等生命周期事件。在on_tool_start中见 callbacks.py若策略要求验证require_verificationTrue且元数据中携带invoker_did会用握手对已注册的对端卡片做verify_peer验证失败且block_unverifiedTrue默认时记录tool_blocked事件并直接抛出PermissionError阻断工具执行无调用者身份且block_unverifiedTrue时产生 No verified invoker identity provided 告警。准确用法示例from langchain_agentmesh import TrustCallbackHandler, TrustPolicy, VerificationIdentity identity VerificationIdentity.generate(chain-agent) policy TrustPolicy(audit_all_callsTrue, block_unverifiedTrue) callback TrustCallbackHandler(identityidentity, policypolicy) agent create_agent(callbacks[callback])该 handler 还提供add_verified_peer(card)先验证再加入白名单、remove_peer(did)、get_events()、get_events_by_type(type)、get_unverified_events()、get_trust_summary()等管理方法。其中get_trust_summary()返回的摘要包含总事件数、已验证/未验证事件数、验证通过率verification_rate、事件类型分布、已验证对端数、告警总数可直接用于治理仪表盘见 callbacks.py。八、配置参数详解8.1 原 README 参数表附源码默认值校准原 README 给出的配置表如下右侧一列标注了当前源码中的真实默认值参数README 默认值源码实际默认值说明min_trust_score0.50.7所需的最低信任分数TrustGatedTool与TrustPolicy均为 0.7required_capabilities[][]必需的调用能力列表audit_loggingFalse由TrustPolicy.audit_all_calls默认 False控制是否启用审计追踪cache_ttl900900cache_ttl_seconds验证结果缓存时长秒即 15 分钟8.2 TrustPolicy 完整字段源码级trust.py 中的TrustPolicy提供了远超 README 表更细粒度的策略控制字段默认值作用require_verificationTrue是否要求验证min_trust_score0.7最低信任分数allowed_capabilitiesNone允许的能力白名单audit_all_callsFalse是否记录全部调用审计block_unverifiedTrue是否阻断未验证调用cache_ttl_seconds900验证结果缓存 TTLstrict_scope_chain_verificationTrue严格模式链校验失败即拒绝False 时降级为告警expose_scope_chain_errorsFalse是否向调用方暴露链校验失败细节allowed_signature_algorithms[verification-Ed25519]允许的签名算法白名单max_delegation_signature_age_seconds900委托签名最大年龄防旧签名重放max_signature_clock_skew_seconds60签名时间戳允许的时钟偏移max_delegation_expiry_clock_skew_seconds60委托过期允许的时钟偏移replay_window_seconds300防重放窗口replay_detection_enabledTrue是否启用重放检测max_seen_scope_chain_fingerprints2048重放指纹表上限内存有界max_scope_chain_attempts_per_window120每窗口链校验次数上限scope_chain_rate_limit_window_seconds60限流窗口长度这些字段通过TrustHandshake(identity, policy)、TrustedToolExecutor(identity, policy)、TrustCallbackHandler(identity, policy)三个入口注入信任栈实现从执行器到回调监控的全局策略统一。九、测试保障一个用例覆盖一套安全语义集成包的测试集中在 tests/test_agentmesh.py1300 行按组件组织为TestVerificationIdentity、TestTrustedAgentCard、TestTrustHandshake、TestDelegationChain、TestTrustGatedTool、TestTrustCallbackHandler、TestVerificationIdentityTTL、TestUserContext、TestAgentDirectory。重点覆盖的安全语义包括篡改必然失败篡改签名数据、给委托链追加admin能力、伪造链上 delegator DID、破坏链式链接均导致verify_peer拒绝过期必然失败委托过期、签名时间戳过旧均被拒滥用被限制回放窗口内复用相同链被拒、环形委托被拒、子链越权提权被拒、超限流被拒能力收敛生效即使对端卡片声明了write只要委托链只授予read最终有效能力仍以链上收敛结果为准并发安全20 线程并发验证不抛异常、不破坏状态RLock保护序列化往返身份 TTL、UserContext、Agent Card 的to_dict/from_dict往返后语义一致。运行测试cd agent-governance-python/agentmesh-integrations/langchain-agentmesh python -m pytest tests/test_agentmesh.py -v十、相关资源与后续路线核心信任网格平台AgentMeshagent-governance-python/agentmesh/README.md治理内核Agent-OSagent-governance-python/agent-os/README.md集成包总览与迁移指引agent-governance-python/agentmesh-integrations/README.md同族 LangChain 生态治理集成LangGraph Trustagent-governance-python/agentmesh-integrations/langgraph-trust/README.md最后再次提醒两条使用前提一是新项目请直接安装agent-governance-toolkit-integrations[langchain]agentmesh-langchain仅保留兼容二是生产环境必须安装cryptography44.0.0否则身份层会退化为非加密模拟模式并采用 fail-closed 策略。在此基础上Ed25519 身份 信任门控 委托链 回调监控即可为你的 LangChain 多 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考