使用说明
⏸️ 项目状态：待定
当维护人员专注于其他优先级时，此项目会暂停。
架构和设计文档仍可供审查和反馈。
欢迎捐款，但可能不会立即审查。
AgentLedger
代理生态系统的信任和隐私层。
问题
人工智能代理正在成倍增加。处理财务分析任务的编排者可能有50个代理可供选择，但没有好的方法来决定：
- 哪种代理最适合此特定任务？ 不是通用评级——经过验证的质量 这 能力。
- 它将如何处理我的数据？ 它会在上面训练吗？储存？转发给第三方？
- 它符合我关心的规定吗？ GDPR、HIPAA、POPIA、CCPA——我可以按此过滤吗？
- 这个特工的幕后主使是谁？ 是否有经过验证的、负责任的组织在运营它？
- 最划算的选择是什么 在我需要的信任级别？
- 如果它委托给另一个代理，隐私和合规链会成立吗？
如今，注册中心对代理进行编目。他们都没有回答这些问题。 AgentLedger 是一个开源的信任层。我们不会替换 主控程序 或 A2A --我们补充它们。MCP将代理连接到工具。A2A允许特工之间进行对话。 我们帮助代理商决定 谁 信任。
我们正在建造什么
1.代理数据处理策略（ADHP）
一种标准化的方式，让代理声明数据发生了什么，并让编排者根据这些声明过滤代理。
五个层次，从 open （不保证） zero-trace （仅流式传输，无存储，无日志，无委派）：
| 级别 | 培训 | 坚持 | 记录 | 委派 | 第三方共享 |
|---|---|---|---|---|---|
| 打开 | 是 | 无限 | 满 | 无限制 | 允许 |
| 标准 | 否 | 会话 | 仅元数据 | 同一级别+ | 经同意 |
| 敏感的 | 否 | 仅请求 | 仅元数据 | 仅声明 | 仅匿名 |
| 严格的 | 否 | 仅请求 | 无 | 同级+ | 不允许 |
| 零轨迹 | 否 | 无 | 无 | 不允许 |
关键创新：授权级联。 当代理A委托给代理B时，必须保持或加强数据处理级别，绝不能削弱。注册表验证整个链。
隐私立法合规标签。 代理人声明他们遵守哪些规定-- GDPR, HIPAA, CCPA, POPIA, PIPEDA, LGPD以及其他。编排器按规则过滤： “给我找一个符合GDPR和HIPAA的代理，严格处理数据。”
2.运营商验证（KYC）
信任需要责任。我们通过分层验证来验证代理背后的组织：
| 级别 | 验证内容 | 徽章 |
|---|---|---|
| 未验证 | 无-自行注册 | - |
| 电子邮件已验证 | 有效电子邮件已确认 | ✉️ |
| 身份验证 | 通过文件确认合法身份 | ✅ |
| 已审核 | 身份+技术ADHP合规性审核 | 🛡️ |
编排器可以组合过滤器： “给我找一个ADHP≥敏感且验证≥身份验证的代理人。”
📄 完整的KYC规范
3.按能力信任评分
固定的评级是无用的。代理人可能擅长财务分析，但不擅长创意写作。我们的注册商店 上下文信任图 --每个能力的质量和信心得分。
GET /agents?capability=financial-analysis&min_quality=4.0&adhp_level=strict&jurisdiction=EU&compliance=GDPR
它如何适应生态系统
我们不是在与现有项目竞争，而是在填补它们都没有解决的空白：
┌─────────────────────────────────────────────────────┐
│ Agentic Ecosystem │
│ │
│ MCP Registry ─── catalogs servers/tools │
│ A2A Protocol ─── agents discover & talk to agents │
│ Kong/Solo.io ─── enterprise gateway & governance │
│ │
│ AgentLedger ───── WHO DO I TRUST? ◄── you are here │
│ ├── ADHP: what happens to my data? │
│ ├── Compliance: GDPR, HIPAA, CCPA, POPIA... │
│ ├── KYC: who's behind this agent? │
│ ├── Trust scores: is it good at THIS task? │
│ └── Delegation chains: will trust hold? │
└─────────────────────────────────────────────────────┘
我们计划 与官方MCP注册表联合 --提取服务器元数据并在其上添加我们的信任层。我们支持MCP和A2A协议。我们符合AAIF标准。
项目状态
阿尔法MVP -使用REST API的工作注册表、PostgreSQL存储、API密钥验证、速率限制、带过滤的搜索、web仪表板和Docker部署。47次测试，覆盖率84%。
| 组件 | 状态 |
|---|---|
| REST API（FastAPI） | ✅ 工作 |
| 代理CRUD+搜索 | ✅ 工作 |
| ADHP字段+过滤 | ✅ 工作 |
| API密钥身份验证（写入） | ✅ 工作 |
| 速率限制（Redis） | ✅ 工作 |
| Web仪表板 | ✅ 工作 |
| Docker部署 | ✅ 工作 |
| ADHP规范 | 📄 v0.1草稿 |
| KYC规范 | 📄 v0.1草稿 |
| 操作员系统 | 🔨 下一个 |
| 公共部署 | 🔨 下一个 |
看 路线图 为了即将发生的事情。
快速开始
# Clone
git clone https://github.com/StevenJohnson998/AgentLedger.git
cd AgentLedger
# Start (requires Docker)
./batch/run-dev.sh
# API available at http://localhost:8000
# Dashboard at http://localhost:8000/dashboard
# Docs at http://localhost:8000/docs
# Run tests
./batch/run-tests.sh
# Seed example agents
./batch/seed-db.sh
注册代理
curl -X POST http://localhost:8000/agents \
-H "X-API-Key: your-api-key" \
-H "Content-Type: application/json" \
-d '{
"name": "FinanceAnalyzer Pro",
"description": "Financial document analysis with strict privacy",
"capabilities": ["financial-analysis", "document-parsing"],
"endpoint": "https://api.finanalyzer.example.com",
"protocol": "REST",
"data_handling": {
"level": "strict",
"training_opt_out": true,
"max_retention": "request",
"content_logging": false,
"delegation_policy": "same_or_higher",
"jurisdiction": ["DE", "FR"],
"compliance": ["GDPR"],
"third_party_sharing": { "enabled": false }
}
}'
按信任要求查找代理
# Find strict+ agents in the EU, GDPR-compliant, that don't share data
curl "http://localhost:8000/agents?min_data_handling_level=strict&jurisdiction=EU&compliance=GDPR&third_party_sharing=false"
仓库结构
AgentLedger/
├── docs/ # Specifications
│ ├── ADHP-SPEC.md # Agent Data Handling Policy specification
│ ├── KYC-SPEC.md # Operator verification specification
│ └── ROADMAP.md # Project roadmap
├── dev/ # Application source code
│ ├── app/ # FastAPI application
│ │ ├── api/ # API routes
│ │ ├── core/ # Config, auth, rate limiting
│ │ ├── models/ # SQLAlchemy models
│ │ └── schemas/ # Pydantic schemas
│ ├── tests/ # Test suite
│ ├── alembic/ # Database migrations
│ ├── static/ # Web dashboard
│ └── docker-compose.dev.yml
├── batch/ # Operational scripts
│ ├── run-dev.sh
│ ├── stop-dev.sh
│ ├── run-tests.sh
│ ├── seed-db.sh
│ └── ...
└── notes/ # Internal project notes
贡献
我们特别寻求以下方面的反馈：
- ADHP规范 --五个层次是否正确？我们遗漏了哪些数据处理问题？
- 生态系统整合 --我们应该如何最好地使用MCP和A2A？
- 真实世界测试 --你们经营代理商吗？我们很乐意注册它们并测试我们的假设。
如何做出贡献
欢迎所有贡献，从规范反馈到代码再到文档。
许可证
AGPLv3--参见 许可证双重许可可用于商业用途， 伸出援手.
贡献者必须签署 贡献者许可协议.
