跳转到内容

故障排除

OpenAI Agents SDK 在以下服务器环境中受支持:

  • Node.js 22+
  • Deno 2.35+
  • Bun 1.2.5+
  • Cloudflare Workers:Agents SDK 可在 Cloudflare Workers 中使用,但目前存在一些限制:
    • SDK 目前需要启用 nodejs_compat
    • 需要在请求结束时手动刷新追踪数据。参阅追踪获取更多详情。
    • 由于 Cloudflare Workers 对 AsyncLocalStorage 的支持有限,部分追踪可能不准确
    • 出站 WebSocket 连接必须使用基于 fetch 的升级方式(而非全局的 WebSocket 构造函数)。对于 Realtime,请使用 @openai/agents-extensions 中的 Cloudflare 传输(CloudflareRealtimeTransportLayer)。
  • 浏览器
    • 浏览器中目前不支持追踪
  • v8 isolates
    • 如果使用具备合适浏览器 polyfill 的打包工具,虽然可以为 v8 isolates 打包 SDK,但追踪功能将无法使用
    • v8 isolates 尚未经过充分测试

如果您在使用 SDK 时遇到问题,可以启用调试日志以获取更多信息。

通过设置 DEBUG 环境变量为 openai-agents:* 来启用调试日志。

Terminal window
DEBUG=openai-agents:*

或者,您可以将调试范围限定到 SDK 的特定部分:

  • openai-agents:core — SDK 的主要执行逻辑
  • openai-agents:openai — OpenAI API 调用
  • openai-agents:realtime — Realtime Agents 组件