默认跟踪

默认跟踪

演示内置的自动跟踪系统，该系统无需任何设置即可捕获所有智能体工作流事件。

本演示所展示的内容

• 自动跟踪：内置的工作流监控功能（默认启用）
• 跟踪 ID：每个智能体运行的唯一标识符
• OpenAI 仪表板：免费的跟踪可视化平台
• 跟踪配置：启用和禁用跟踪捕获

快速入门

1. 安装 OpenAI 智能体 SDK：

   pip install openai-agents
   ​

2. 设置环境：

   cp ../env.example .env
   # Edit .env and add your OpenAI API key
   ​

3. 运行智能体：

   import asyncio
   from agent import main
   
   # Test default tracing (automatic)
   asyncio.run(main())
   ​

关键概念

• 无需任何设置：跟踪功能开箱即用
• 唯一运行 ID：每次调用 Runner.run() 都会获得一个唯一的跟踪标识符
• 自动捕获：大语言模型调用、工具执行、性能指标
• 免费仪表板：可在 platform.openai.com/traces 查看跟踪记录

自动捕获

自动跟踪的内容

• 大语言模型生成：输入提示、模型响应、令牌使用情况
• 工具调用：函数执行、参数、结果
• 交接：智能体之间的委托
• 性能：执行时间、延迟指标
• 错误：异常和失败模式

跟踪信息

result = await Runner.run(agent, "Hello")
print(f"Trace ID: {result.run_id}")
# Each run gets a unique identifier for dashboard lookup
​

分离的跟踪

• 每次调用 Runner.run() = 一条独立的跟踪
• 多次运行 = 多条独立的跟踪
• 独立的工作流跟踪

跟踪示例

基本自动跟踪

# Tracing happens automatically - no setup required!
result = await Runner.run(agent, "Explain machine learning")
print(f"View trace: https://platform.openai.com/traces/{result.run_id}")
​

跟踪配置

# Disable tracing for specific runs
result = await Runner.run(
    agent,
    "Private conversation",
    run_config=RunConfig(tracing_disabled=True)
)
​

多个跟踪

# Each run creates a separate trace
result1 = await Runner.run(agent, "Question 1")  # Trace 1
result2 = await Runner.run(agent, "Question 2")  # Trace 2
​

仪表板功能

OpenAI 跟踪仪表板

• 工作流时间线：可视化的执行流程
• 性能指标：响应时间、令牌使用情况
• 错误跟踪：异常详情和堆栈跟踪
• 内容检查：输入/输出内容审查

免费访问

• 无需额外设置
• 只需 OpenAI API 密钥即可访问
• 实时跟踪可用
• 历史跟踪保留

下一步

• 自定义跟踪 - 高级跟踪模式
• 教程 11：生产模式 - 实际部署场景

免责声明：
本文档采用基于机器的 AI 翻译服务进行翻译。尽管我们力求准确，但请注意，自动翻译可能存在错误或不准确之处。应以原文（母语）文档作为权威依据。如需获取关键信息，建议使用专业的人工翻译。对于因使用本翻译而产生的任何误解或误读，我们概不负责。