OpenAI Agents SDK 中文文档中文教程（3）

跟踪表示 “workflow” 的单个端到端作。它们由 Span 组成。跟踪具有以下属性：
- workflow_name：这是逻辑工作流或应用程序。例如，“代码生成”或“客户服务”。
- trace_id：跟踪的唯一 ID。如果您未传递 1 个，则自动生成。必须具有格式 .trace_<32_alphanumeric>
- group_id：可选的组 ID，用于链接来自同一对话的多个跟踪。例如，您可以使用聊天会话 ID。
- disabled：如果为 True，则不会记录跟踪。
- metadata：跟踪的可选元数据。
Span 表示具有开始时间和结束时间的作。Span 具有：
- started_at和时间戳。ended_at
- trace_id来表示它们所属的跟踪
- parent_id，它指向此 Span 的父 Span（如果有）
- span_data，这是有关 Span 的信息。例如，包含有关 Agent 的信息，包含有关 LLM 生成的信息，等等。AgentSpanDataGenerationSpanData

默认跟踪

默认情况下，SDK 会跟踪以下内容：

整个包裹在一个 .Runner.{run, run_sync, run_streamed}()trace()
每次代理运行时，都会将其包装在agent_span()
LLM 代被包装在generation_span()
函数工具调用都包装在function_span()
护栏被包裹在guardrail_span()
Handoff 被包裹在handoff_span()

默认情况下，跟踪名为 “Agent trace”。如果使用，则可以设置此名称，也可以使用 RunConfig 配置名称和其他属性。trace

此外，您还可以设置自定义跟踪处理器以将跟踪推送到其他目标（作为替代目标或辅助目标）。

更高级别的跟踪

有时，您可能希望多个调用成为单个跟踪的一部分。您可以通过将整个代码包装在 .run()trace()

from agents import Agent, Runner, trace

async def main():
    agent = Agent(name="Joke generator", instructions="Tell funny jokes.")

    with trace("Joke workflow"):

first_result = await Runner.run(agent, "Tell me a joke") second_result = await Runner.run(agent, f"Rate this joke: { 
     first_result.final_output}") print(f"Joke: { 
     first_result.final_output}") print(f"Rating: { 
     second_result.final_output}")