Attestix 5分钟快速上手:从零创建第一个AI Agent签名身份(附完整代码)

原创2026-10-24 18:45:151,422 阅读

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):

  1. 生成唯一 Agent ID(如 attestix:f9bdb7a94ccb40f1)
  2. 创建 UAIT(Unified Agent Identity Token),包含名称、能力列表、元数据
  3. 用服务器 Ed25519 密钥对 UAIT 签名
  4. 存入 identities.json(自动创建,无需配置)
  5. 从签名密钥派生 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 分钟后就会诞生。🚀

登录后查看全文
attestix