Attestix 5分钟快速上手:从零创建第一个AI Agent签名身份(附完整代码)
Attestix 5分钟快速上手:从零创建第一个AI Agent签名身份(附完整代码)
Attestix 是一个为 AI Agent 提供签名身份、可验证凭证与授权委托的开源 Python 工具包。本文带你用不到 5 分钟完成安装,创建并验证你的第一个 AI Agent 签名身份——全程本地运行,无需数据库和云服务。
🎯 读完本文你将掌握:安装 Attestix → 用 CLI 一键建身份 → 用 Python 代码签发 Ed25519 签名身份 → 理解 UAIT / DID / W3C VC 三大核心概念 → 跑通官方 5 分钟演示脚本。
Attestix 是什么?为什么 AI Agent 需要签名身份
随着 AI Agent 开始自主执行任务,一个绕不开的问题是:如何证明"这个 Agent 真的是谁"? 口头声明不可信,日志可以被篡改。Attestix 的答案是用密码学签名把 Agent 的身份和证据"钉死":
| 核心能力 | 说明 | 对应技术 |
|---|---|---|
| 🔐 签名身份(UAIT) | 每个 Agent 拥有可密码学验证的统一身份令牌 | Ed25519 签名 |
| 🆔 去中心化标识(DID) | 由签名密钥推导出的唯一标识符 | W3C DID 标准 |
| 📜 可验证凭证(VC) | 为 Agent 颁发可跨语言验证的"数字证书" | W3C Verifiable Credentials |
| 🤝 授权委托(UCAN) | Agent 间安全下放能力,支持到期自动失效 | UCAN 令牌 |
| 📊 信任评分 | 基于交互记录自动计算 Agent 信任分 | 声誉服务 |
| 📋 合规证据 | 按 EU AI Act 要求记录数据来源与模型谱系 | 合规服务 |
一句话总结:Attestix 让 AI Agent 的"身份证"能被任何语言、任何系统在离线状态下验证(Python、JS/TS、Go、Rust、Java、R 都有配套验证器)。
环境准备:Attestix 安装最快方式
只需两个前提条件,一条命令完成安装:
- Python 3.10 或更高版本
- pip
pip install attestix
安装完成后先跑个体检,确认环境正常:
attestix status
💡 零依赖设计:Attestix 的所有核心操作都在本地完成——数据存为 JSON 文件(首次使用时自动创建),签名密钥自动生成。没有数据库、没有云 API,开箱即用。详细说明见 docs/getting-started.md。
第一步:用 CLI 一行命令创建 Agent 身份
不想写代码?Attestix 自带命令行工具,一条命令即可创建:
attestix init --name MyBot \
--capabilities "data_analysis,report_generation" \
--issuer "Acme Corp"
成功后会打印完整的身份详情(Agent ID、DID、签名等)。接下来用 verify 命令做密码学验证:
attestix verify <agent-id>
输出形如:
Identity attestix:xxxx is VALID
Verification Checks
exists: PASS
not_revoked: PASS
not_expired: PASS
signature_valid: PASS
四项检查全部 PASS,说明这个身份既存在、未撤销、未过期,且签名真实有效。CLI 命令的实现位于 attestix/cli.py,更多子命令(compliance、audit、credential)可直接执行 attestix --help 查看。
第二步:10 行 Python 代码创建并验证签名身份(完整代码)
如果你要把身份管理写进自己的项目,用 Python API 更灵活。下面是完整可运行代码(摘自官方示例 examples/01_basic_identity.py):
from attestix.services.identity_service import IdentityService
svc = IdentityService()
# 1. 创建 Agent 签名身份
agent = svc.create_identity(
display_name="DataAnalyzer",
source_protocol="manual",
capabilities=["data_analysis", "chart_generation", "report_writing"],
description="Analyzes datasets and produces visual reports",
issuer_name="Acme Analytics Inc.",
expiry_days=365,
)
print(f"Agent ID: {agent['agent_id']}") # attestix:f9bdb7a94ccb40f1
print(f"DID: {agent['issuer']['did']}")
print(f"Signed: {bool(agent['signature'])}")
# 2. 密码学验证身份
result = svc.verify_identity(agent["agent_id"])
print(result)
运行后会得到类似这样的验证结果:
{
"valid": true,
"checks": {
"exists": true,
"not_revoked": true,
"not_expired": true,
"signature_valid": true
}
}
背后发生了什么?
调用 create_identity 时,Attestix 在本地悄悄完成了 5 件事(服务实现见 attestix/services/identity_service.py):
- 生成唯一 Agent ID(如
attestix:f9bdb7a94ccb40f1) - 创建 UAIT(Unified Agent Identity Token),包含名称、能力列表、元数据
- 用服务器 Ed25519 密钥对 UAIT 签名
- 存入
identities.json(自动创建,无需配置) - 从签名密钥派生 DID(去中心化标识符)
⚠️ 安全提醒:首次运行会自动生成 Ed25519 密钥对并存入
.signing_key.json——这是你整个系统的"身份根",请妥善保管,切勿提交到代码仓库。
进阶:跑通官方 5 分钟演示,体验完整签名工作流
光有身份还不够,Attestix 的杀手锏是把身份、凭证、委托、合规串成完整链路。官方内置了一个端到端演示脚本 examples/quickstart.py,一条命令跑完 9 个步骤:
python examples/quickstart.py
演示脚本 demo/quick-start/five_min_demo.py 的覆盖范围:
| 步骤 | 演示内容 | 你会看到什么 |
|---|---|---|
| 1 | 创建签名身份 | Ed25519 签名 + DID |
| 2 | 创建高合规要求档案(高风险场景) | 自动生成义务清单 |
| 3 | 记录训练数据来源(EU AI Act Article 10) | 数据来源留痕 |
| 4 | 第三方符合性评估(Article 43) | 通过/拦截结果 |
| 5 | 生成符合性声明(Annex V) | 自动颁发合规凭证 |
| 6 | 签发并验证 W3C VC 凭证 | 签名验证逐项 PASS |
| 7 | 创建委托令牌(UCAN) | Agent 间能力下放 |
| 8 | 记录交互、计算信任分 | 0~1 的 Trust Score |
| 9 | 查看哈希链审计日志 | 防篡改操作轨迹 |
✨ 全程约 2 分钟跑完,所有产物本地落盘——你可以亲眼看到"从零到合规"的完整证据链。
常见疑问 FAQ
Q1:Attestix 需要联网或云端服务吗? 不需要。核心操作(身份、签名、验证、凭证)全部本地完成,数据存为 JSON 文件。
Q2:签名身份如何被"别人"验证? 凭证采用公开的规范 JSON + Ed25519 验证配置,官方为 Python、JS/TS、Go、Rust、Java、R 六种语言提供了离线验证器 SDK,共享同一套一致性测试向量(见 spec/verify/v1)。
Q3:支持集成到 LangChain / CrewAI 等框架吗? 支持。Attestix 原生提供 LangChain、OpenAI Agents SDK、CrewAI 等框架的集成钩子,可参考 docs/integration-guide.md。
Q4:身份可以撤销吗?
可以。verify 结果中的 not_revoked 检查项即为撤销状态验证,被撤销的身份会验证失败。
下一步学习路径
| 想深入的方向 | 推荐资料 |
|---|---|
| 理解 UAIT / DID / VC 概念 | docs/concepts.md |
| EU AI Act 合规全流程 | docs/eu-ai-act-compliance.md |
| 框架集成(LangChain 等) | docs/integration-guide.md |
| 完整 API 参考 | docs/api-reference.md |
| 更完整的示例合集 | examples/ |
现在,回到终端敲下 pip install attestix,你的第一个 AI Agent 签名身份 5 分钟后就会诞生。🚀