6.1 链路追踪 (Tracing)

1.1 为什么 Multi-Agent 需要链路追踪

在单体 LLM 应用时代，调试和监控相对简单——一次请求、一次响应、日志记录错误即可。但当系统演进到 Multi-Agent 架构时，复杂度呈指数级增长：主 Agent 可能fork出多个子 Agent，每个子 Agent 又调用不同的工具，完成各自子任务后返回结果，主 Agent 再将结果聚合输出。这种嵌套调用、异步协作的架构，使得传统的"请求-响应"日志记录方式完全失效。

链路追踪（Tracing）是解决这一问题的标准方法。OpenTelemetry 的语义约定（v1.37+）已将 GenAI 场景纳入正式规范[^1]，定义了gen_ai.request.model、gen_ai.usage.input_tokens、gen_ai.provider.name等标准属性。这意味着链路追踪不再是定制化方案，而是有统一标准的工程实践。

1.2 链路追踪的核心概念

链路追踪基于两个核心概念：Trace和Span。

Trace（追踪）代表一个端到端的完整工作单元。在 Multi-Agent 场景下，一次用户请求可能触发主 Agent 的完整执行链路，包括所有子 Agent 的调用、工具的执行、记忆的检索——这些共同构成一个 Trace。每个 Trace 有唯一的trace_id，可以跨进程、跨服务传播。