跳转至

Tracing(可回放的可观测性)

解决的问题

没有 trace,Agent 很难 debug:

  • 模型究竟看到了什么?
  • 调了哪些工具?输出是什么?
  • 卡在了哪里?为什么停不下来?

Tracing 把一次运行变成 JSONL 事件流,可回放、可对比、可做回归。

建议记录的事件

  • 模型调用(输入/输出)
  • 工具调用与结果
  • loop step 与终止原因
  • policy/guardrail/HITL 的拦截事件

本仓库对应代码

  • 实现:src/agent_patterns_lab/runtime/tracing.py
  • 输出:.traces/*.jsonl