Agent Event-Stream Observability
正式版 v1.0AgentTrace
AgentTrace 是面向 AI Agent 的事件流观测与调试台。Agent 上线后就是黑盒：出错只能在散落的日志里捞线索，既无法完整回放当时发生了什么，也无法归因到哪一步出了问题。AgentTrace 以 12-Factor Agents 的事件流为接入标准——轻量 SDK 一行 append 事件，服务端持久化全部轨迹，提供时间线回放、任意状态分叉重跑、错误聚类与 token 成本归因。开源 SDK，托管与私有化按需选择。
进入控制台 →正式版 v1.0
我们解决的问题
- ✗Agent 出错只能 grep 日志，无法完整回放执行轨迹
- ✗复现一个坏 case 需要重跑全流程，成本高且不确定
- ✗错误散点出现，没有聚类就找不到系统性根因
- ✗token 花在哪了说不清，成本无法归因到具体步骤
核心功能
事件流接入 SDK
Python / TypeScript 轻量 SDK，统一 event stream 格式，append 一行即接入，无侵入改造。
轨迹回放与时间线
每个 thread 的完整事件序列可视化为时间线，逐事件查看 context、工具调用与模型输出。
Fork & Replay
从任意历史状态分叉，改一个事件或换一个模型重跑，对照新旧轨迹差异。
错误聚类与根因标注
相似错误自动聚类，人工标注根因后沉淀为团队知识库，同类问题不再重复排查。
Token 成本归因看板
成本按 agent / 步骤 / 模型多维拆解，找到烧钱的那一步。
开源 SDK + 灵活部署
SDK 开源免费，服务端可选托管或私有化部署，事件数据可完全留在内网。
系统架构
自上而下的请求路径
接入层
Python / TS SDK
统一事件格式，append event 即上报，支持批量与离线缓冲
↓
Ingest 层
FastAPI
事件接收、校验与写入；回放与分叉重跑编排
↓
数据层
PostgreSQL JSONB
事件流原样持久化，thread 即单一事实源，可任意切片查询
↓
展示与分析层
Next.js 时间线 UI + 分析 Worker
时间线回放界面；错误聚类与成本归因离线计算
技术栈
Python / TypeScript SDKFastAPI ingest 服务PostgreSQL JSONB 事件存储Next.js 15 时间线 UI分析 Worker（聚类 / 成本归因）12-Factor Agents 事件流规范
定价方向
开源 SDK
永久免费
事件流 SDK 与 schema 规范开源，自建存储亦可用
托管服务
按事件量订阅（规划中）
免运维托管，含回放与分析全功能
私有化授权
年度授权（规划中）
部署进客户内网，轨迹数据不出域