LLM Agent 调 bug 调疯了？这个开源链路追踪工具把黑箱变白箱

LLM Agent 跑飞了，调 bug 调到你怀疑人生？

说个真实场景：你写了个 Agent，它执行了三轮工具调用、两次上下文检索，结果输出莫名其妙烂掉了。你翻日志，日志是破碎的；你 print，你不知道哪一步开始歪的。

——这就是 agent-tracing 解决的问题。

它是什么

agent-tracing 是 LobeHub 团队开源的一个本地链路追踪工具，专门给 AI Agent 用的可观测性模块。零配置，开箱即用，开发模式下自动记录每一次 executeStep 的快照，写入 .agent-tracing/ 目录。

每条快照包含：

• 失败的工具调用及参数
• 每步的 LLM 输入/输出
• 可用的 tools 列表和执行位置
• 上下文注入记录

怎么用

装好之后，一条命令搞定：

agent-tracing inspect latest

然后你会看到一个树状结构：每个 step、每次 tool call、每条消息，完整展开。想知道第 0 步 LLM 看到了什么？加个 -m 就显示消息详情。

生产环境也支持远程拉取，用 lh trace op inspect <opId> 拉取云端快照，同样能看完整链路。

为什么值得装

Agent 开发最怕的不是「跑不通」，而是「不知道哪一步跑歪了」。agent-tracing 把黑箱变白箱——你终于能说清楚：是 tool 传参错了，还是 context 丢了，还是 LLM 自己开始胡说八道。

GitHub 8.2 万星，LobeHub 出品，质量有保证。前沿技术方向，强烈建议入手。

https://github.com/lobehub/lobehub

GitHub: https://github.com/lobehub/lobehub/tree/canary/.agents/skills/agent-tracing