为Agent运行追踪模型、工具与handoff跨度

目标

定位一次Agent任务在哪个阶段变慢、失败或偏离预期。

步骤

1. 确定追踪启用范围、数据保留和哪些敏感字段不得记录。 [openai-tracing]
2. 用 with trace("agent-workflow"): 包住一段或多段 Runner.run(...)，让其共享trace。 [openai-tracing]
3. 使用SDK默认追踪或自定义processor采集Agent、模型、工具及handoff跨度。 [openai-tracing]
4. 在trace结束后调用 flush_traces()（如需立刻导出）；按组织策略配置processor或关闭tracing。 [openai-tracing]
5. 按组织数据策略限制外发；如不允许外部追踪则关闭导出并保留安全本地诊断。 [openai-tracing]

验证方式

追踪中可沿单一workflow定位工具和模型阶段；检查记录无密钥或不必要的个人数据。

故障处理

若跨度缺失，检查追踪配置和processor flush；不要把凭据写入诊断日志。