故障排除

支持的环境

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

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:* 来启用调试日志。

DEBUG=openai-agents:*

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