工具
Traccia：面向 AI 智能体的「黑匣子」SDK 上线
一款用于记录、验证和诊断 AI 智能体执行过程的 SDK，支持主流框架，采用 Apache 2.0 协议。
2026.07.22 · 周三约 3 分钟阅读
近日，一款名为 Traccia 的开源 SDK 正式发布，定位为 AI 智能体的「执行证据层」（Execution Evidence Layer），旨在让自主智能体的行为变得可证明、可复现、可审计。项目将自己比喻为智能体的「崩溃转储 + 飞行记录仪 + 审计回执」，面向构建 AI agent 的开发者提供调试与可信度保障。
安装与基本用法
Traccia 通过 pip 即可安装，开发者只需在原有智能体脚本前增加一行拦截命令即可开启记录：
- 安装：
pip install traccia-sdk - 启动记录：
traccia intercept -- python your_agent.py - 校验证据完整性：
traccia verify traccia-*.evidence - 诊断失败原因：
traccia diagnose traccia-*.evidence
这种「零侵入」接入方式降低了集成门槛，开发者无需修改现有智能体代码即可获得执行快照。
核心命令
SDK 提供五个核心命令，覆盖记录、验证、诊断、认证与安全防护：
traccia intercept：记录任意智能体的完整执行过程。traccia verify：校验生成的证据文件是否被篡改。traccia diagnose：自动定位执行失败的根因。traccia certify：获取 OpenBase 认证徽章。traccia guard：在执行过程中拦截高风险操作。
其中「certify」与「guard」两个命令体现了该工具在合规与安全方向上的延伸。
框架兼容与协议归属
Traccia 支持当前主流的智能体开发框架与 SDK，包括 LangChain、CrewAI、AutoGen、OpenAI SDK、Claude Code、OpenHands 与 LangGraph，覆盖了从轻量级编排到多智能体协作的常见场景。
项目同时声明自己是 OpenBase 协议的官方 SDK。OpenBase 是一个面向 AI 智能体的开放信任协议，规定了「应记录什么」；Traccia 则负责定义「如何记录」，二者构成协议层与实现层的关系。
开源信息
- 许可证：Apache 2.0
- 代码仓库：https://github.com/d87skg/traccia
- PyPI 包：https://pypi.org/project/traccia-sdk/
- 技术说明：随 v1.0.0 发布附带说明文档
目前该 SDK 已发布 1.0.0 版本，功能以基础记录与诊断为主。对于需要在生产环境中对智能体行为进行审计或事后回溯的团队，可作为轻量级入门方案评估使用。