Agent 全链路追踪是如何工作的

1. 以 Trace 树记录一次运行

把单个 Agent 任务（一次用户请求、一个触发事件或一条定时任务）建模为一棵 Trace 树，从根节点到叶子节点完整表达"用户请求 → 推理 → 调工具 → 再推理 → 最终响应"的链路。

2. 在关键语义边界自动埋点

在 Agent 入口与出口、LLM 调用、工具调用、Agent 间调用等语义边界插入 Span，而非对每一行代码埋点。每个边界代表一次具有独立延迟特征与失败模式的操作。

3. 统一上下文贯穿全链路

通过 W3C Trace Context（traceparent / tracestate）在 HTTP 调用、消息队列等传输介质上传播 trace_id，使分散在不同服务、不同进程中的观测数据自动关联为同一条 Trace。

4. 采集后聚合分析与闭环

Span 数据上报到可观测后端后，按 trace_id 还原完整调用树，结合指标与日志进行排障、成本与质量分析，并进一步驱动 Prompt 调整、模型替换与工具顺序优化。