Agent 全链路追踪中的 Trace 与 Span 是什么关系

1. Trace 表示一次完整任务

一个 Trace 对应一次端到端的 Agent 运行，具有全局唯一的 trace_id，自动生成于任务开始时，贯穿整个执行过程直至最终响应。

2. Span 表示单个执行步骤

每个 Span 是一次具体操作（模型调用、工具调用、规划、检索等）的记录，包含自身的 span_id、指向父节点的 parent_span_id、起止时间戳以及执行状态（ok / error）。

3. 父子嵌套构成执行树

Span 通过 parent_span_id 指向上一层 Span，形成树状嵌套结构。阅读这棵树即可按时间顺序看到规划、工具调用、检索与输出的完整路径。

4. 二者是整体与局部的关系

一个 Trace 由多个 Span 组成，Span 不能脱离 Trace 独立存在。Trace 提供"这次任务发生了什么"的全景，Span 提供"某一步具体做了什么、用了多久、是否出错"的细节。