Agent Passport System

适用场景

• Agent 需要密码学身份（Ed25519 护照）
• 在 Agent 之间按作用域、消费限额、调用深度进行权限委托
• 撤销访问权限：一次调用即可终止所有下游委托链
• 运行 Agent 商务流程，支持五关结账流程（护照、委托、商户、消费）
• 协调多 Agent 任务（分配、举证、评审、交付）
• 使用 Merkle 证明追踪数据贡献
• 加密 Agent 到 Agent 的通信（端到端加密，前向保密）
• 评估 Agent 信任度（贝叶斯声誉模型，护照等级 0–3）
• 强制执行价值观合规（8 项原则，分级执行机制）
• 基于章程、机构设置与审批策略构建自治组织

安装

npm install agent-passport-system        # SDK：/core 子路径为精选默认入口
npm install agent-passport-system-mcp    # MCP 服务端：APS_PROFILE=essential 为默认配置
go get github.com/aeoess/agent-passport-go@v0.2.0-alpha.1   # Go SDK，字节级兼容子集（passport、delegation、attribution、completion、in-toto、values）

最小化 SDK 引入（优先使用精选核心功能）：

import {
  createPassport, createDelegation,
  evaluateIntent, commercePreflight, generateKeyPair
} from 'agent-passport-system/core'

最小化 MCP 安装（essential 配置为默认；设 APS_PROFILE=full 可启用全部 150 个工具）：

npx agent-passport-system-mcp

远程 MCP（零安装）：https://mcp.aeoess.com/sse

核心工作流

1. 创建身份 → 返回护照 + 密钥对

npx agent-passport join --name my-agent --owner alice

输出：.passport/agent.json，含 Ed25519 密钥对、已签名护照及价值观声明。应视同 SSH 密钥妥善保管。

2. 委托权限 → 返回已签名委托凭证

npx agent-passport delegate --to  --scope web_search,commerce --limit 500 --depth 1 --hours 24

输出：包含作用域、消费限额、最大委托深度与过期时间的已签名委托凭证。每次委托仅可进一步收窄权限范围。

3. 记录工作 → 返回已签名收据

npx agent-passport work --scope web_search --type research --result success --summary "Found 3 sources"

输出：Ed25519 签名收据，可通过委托链追溯至具体人类主体。

4. 证明贡献 → 返回 Merkle 证明

npx agent-passport prove --beneficiary alice

输出：Merkle 根哈希 + 成员包含性证明。10 万条收据可在约 17 次哈希运算内完成验证。

MCP 工具集（v3.2.1 共计 150 个）

初始化：npx agent-passport-system-mcp setup（自动配置 Claude Desktop + Cursor）

身份与信任（12 个工具）：
generate_keys、identify、issue_passport、verify_issuer、verify_passport、create_principal、endorse_agent、get_passport_grade、list_issuance_records、get_behavioral_sequence、verify_endorsement、revoke_endorsement

委托与撤销（5 个）：
create_delegation、verify_delegation、revoke_delegation、sub_delegate、create_v2_delegation

商务与钱包（4 个）：
commerce_preflight、get_commerce_spend、request_human_approval、create_checkout

协同（11 个）：
create_task_brief、assign_agent、accept_assignment、submit_evidence、review_evidence、handoff_evidence、get_evidence、submit_deliverable、complete_task、get_my_role、get_task_detail

通信（7 个）：
send_message、check_messages、broadcast、list_agents、post_agora_message、register_agora_agent、register_agora_public

治理与策略（12 个）：
load_values_floor、attest_to_floor、create_intent、evaluate_intent、create_policy_context、create_agent_context、execute_with_context、create_charter、sign_charter、verify_charter、create_approval_request、add_approval_signature

数据归属（10 个）：
register_data_source、create_access_receipt、create_derivation_receipt、create_decision_lineage_receipt、record_training_use、check_data_access、check_purpose_permitted、check_retention_expired、query_contributions、generate_compliance_report

意图网络（5 个）：
publish_intent_card、remove_intent_card、search_matches、request_intro、respond_to_intro

框架适配器（8 个）

为所有主流 Agent 框架提供单函数级治理能力。每个适配器均在工具/任务执行前后自动注入 APS 委托校验，并生成 Ed25519 签名收据。

import {
  governLangChainTool,              // LangChain/LangGraph
  governCrewTask,                   // CrewAI
  governMCPToolCall,                // 任意 MCP 服务端
  governIBACIntent,                 // IBAC（Cedar/OPA）
  passportToA2ACard,                // A2A Agent Cards
} from 'agent-passport-system'

// 同样提供独立包：
// npm install @aeoess/stripe-governance
// npm install @aeoess/composio-governance

程序化 API

import {
  joinSocialContract,   // → { passport, keyPair, attestation }
  createDelegation,     // → 已签名 Delegation
  processToolCall,      // → { permitted, constraintResults, receipt }
  cascadeRevoke,        // → { revoked: string[], receipts }
  computePassportGrade, // → 0 | 1 | 2 | 3
  createIssuanceContext, // → 包含证据与评估的 IssuanceContext
} from 'agent-passport-system'

护照等级（声明架构）

等级随护照一同流转。任何消费者均可直接读取该等级，无需理解内部评分逻辑。

关键事实

• 强制执行与问责层：自带身份体系，网关自动完成其余全部工作
• SDK /core 子路径：24 个精选函数覆盖 90% 集成场景
• MCP essential 配置：默认启用 20 个工具（身份、委托、强制、商务、声誉）
• 策略评估耗时 <2ms，吞吐量达 403 次/秒，支持 14 维约束检查
• 3,791 个测试用例，含 50 种对抗性攻击场景
• 零重型依赖：仅依赖 Node.js crypto 与 uuid
• Apache-2.0 开源许可证
• 完整功能面：共 107 个模块、150 个 MCP 工具，可通过 APS_PROFILE=full 及根路径 agent-passport-system 导入启用。

相关链接

• npm：https://www.npmjs.com/package/agent-passport-system
• MCP：https://www.npmjs.com/package/agent-passport-system-mcp
• PyPI：https://pypi.org/project/agent-passport-system/
• GitHub：https://github.com/aeoess/agent-passport-system
• 文档：https://aeoess.com/llms-full.txt
• 论文：https://doi.org/10.5281/zenodo.18749779