故障排除
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)。
- SDK 目前需要启用
- 浏览器:
- 浏览器中目前不支持追踪
- v8 isolates:
- 如果使用具备合适浏览器 polyfill 的打包工具,虽然可以为 v8 isolates 打包 SDK,但追踪功能将无法使用
- v8 isolates 尚未经过充分测试
如果您在使用 SDK 时遇到问题,可以启用调试日志以获取更多信息。
通过设置 DEBUG 环境变量为 openai-agents:* 来启用调试日志。
DEBUG=openai-agents:*或者,您可以将调试范围限定到 SDK 的特定部分:
openai-agents:core— SDK 的主要执行逻辑openai-agents:openai— OpenAI API 调用openai-agents:realtime— Realtime Agents 组件