トラブルシューティング

サポート対象の環境

OpenAI Agents SDK は以下のサーバー環境でサポートされています:

Cloudflare Workers: Agents SDK は Cloudflare Workers で利用できますが、現在いくつかの制限があります:
- 現在 SDK は nodejs_compat を有効にする必要があります
- リクエストの最後にトレースを手動でフラッシュする必要があります。トレーシングガイドを参照
- Cloudflare Workers の AsyncLocalStorage サポートが限定的なため、一部のトレースが正確でない可能性があります
- アウトバウンド WebSocket 接続は fetch ベースのアップグレードを使用する必要があります（グローバルの WebSocket コンストラクタは使用しない）。Realtime では、@openai/agents-extensions の Cloudflare トランスポート（CloudflareRealtimeTransportLayer）を使用してください
Browsers:
- ブラウザでは現在トレーシングはサポートされていません
v8 isolates:
- 適切なブラウザ polyfill を持つバンドラを使用すれば v8 isolates 向けに SDK をバンドルできるはずですが、トレーシングは動作しません
- v8 isolates は十分にテストされていません

SDK で問題が発生している場合、デバッグログを有効にして詳細な情報を取得できます。

DEBUG 環境変数を openai-agents:* に設定してデバッグログを有効にします。

DEBUG=openai-agents:*

また、SDK の特定の部分にデバッグのスコープを絞ることもできます: