Agent 全链路追踪如何与 OpenTelemetry GenAI 语义约定对接

1. 以 OpenTelemetry 为标准输出

让 Agent 框架以 OpenTelemetry 规范输出 Trace，使采集层成为相对标准化的环节，降低对单一后端的锁定。

2. 遵循 GenAI 语义约定的属性命名

使用 gen_ai.* 统一命名空间（如 gen_ai.request.model、gen_ai.usage.input_tokens），保证不同框架、不同厂商产生的遥测数据可以互相对齐与查询。

3. 接入标准 OTLP 端点

主流可观测后端均消费标准 OTLP 端点，切换后端通常只需更换 exporter 而非重写埋点，提升可移植性。

4. 注意规范成熟度

GenAI 语义约定由 OpenTelemetry 于 2024 年 4 月成立的 GenAI SIG 维护；自 v1.41 起相关规范已从核心语义约定仓库迁至独立的 semantic-conventions-genai 仓库，但截至 2026 年中期官方文档仍将其标注为 Development（开发中）状态，属性命名可能演进，可通过 OTEL_SEMCONV_STABILITY_OPT_IN（取值 gen_ai_latest_experimental）管理版本过渡。