跳转到内容

故障排除

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 隔离环境(v8 isolates)
    • 如果使用带有合适浏览器 polyfill 的打包器,你应该可以为 v8 隔离环境打包 SDK,但追踪将无法工作
    • v8 隔离环境尚未经过广泛测试

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

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

Terminal window
DEBUG=openai-agents:*

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

  • openai-agents:core — 用于 SDK 的主要执行逻辑
  • openai-agents:openai — 用于 OpenAI API 调用
  • openai-agents:realtime — 用于 实时智能体 组件