traceroot-ai/traceroot

TraceRoot – AI 编码代理的自我改进层

它是什么 – TraceRoot 是一个开源平台，用于记录（“追踪”）AI 编码代理对语言模型或工具进行的每一次调用，让您可以定义检测器来标记不良行为，将这些标记聚类为信号，然后运行自动化评估来验证修复。其核心理念是闭环：生产环境中的失败会转化为具体的改进建议，供编码代理采取行动、测试并重新部署。

关键组件

功能	您将获得
Trace	模型调用、工具调用、延迟、成本以及输入/输出的全栈可观测性。
Detect	可自定义的检测器，用于编码“良好行为”并自动标记违反该行为的运行。
Signals	检测器输出的聚类；后台编码代理会检查相关代码（通过 GitHub 沙盒）并提出修复建议。
Verify	针对您自己的数据集进行离线评估，以衡量改进并捕捉回归问题。
CLI / SDKs	代理原生 CLI 以及 Python (traceroot-py) 和 TypeScript (traceroot-ts) SDK，便于进行检测。
Integrations	针对主要代理框架（LangChain, CrewAI, AutoGen 等）和模型提供商（OpenAI, Anthropic, Gemini, Mistral, OpenRouter）的现成挂钩。

运作方式

1. Instrument 使用 TraceRoot SDK 检测您的应用程序，或让编码代理通过 CLI 进行设置。
2. Run 在生产环境中运行您的 AI 驱动代码；每个 LLM/工具调用都会发送到 TraceRoot 后端。
3. Detect – 设置好的检测器会自动标记违反您预期的运行。
4. Signal – 被标记的运行会被分组；后台代理会检查追踪记录和相关的仓库代码，然后建议代码变更。
5. Verify – 建议的变更在合并前会通过离线评估进行测试，从而完成自我改进循环。

开始使用

• Cloud – 在 app.traceroot.ai 注册以使用托管实例。
• Self‑host – 克隆仓库，将 .env.example 复制为 .env，并运行 make prod-lite (Docker‑Compose)。在 localhost:3000 访问 UI。
• Instrumentation – 安装 CLI (npm i -g traceroot-cli) 并运行 traceroot login。然后要求您的编码代理设置追踪，或手动添加 Python/TS SDK 并调用 TraceRoot.initialize(...)。

适用对象

• 正在构建 AI 辅助编码助手或其他 LLM 驱动代理的团队，需要生产级可观测性以及将错误转化为已验证修复的系统化方法。
• 已经使用 LangChain, CrewAI 或 LlamaIndex 等框架，并希望拥有即插即用监控层的开发者。

授权 – 核心代码采用 Apache 2.0；部分 ee/ 目录采用商业企业授权。

社区 – 活跃的 Discord、Y Combinator 支持，以及针对新手的贡献指南。

---

所有详细信息均直接取自仓库的 README。