トラブルシューティング

サポートされる環境

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:
- 適切なブラウザポリフィルを持つバンドラーを使用すれば v8 isolates 向けに SDK をバンドルできるはずですが、トレーシングは機能しません
- v8 isolates は広範にはテストされていません

SDK で問題が発生している場合、デバッグログを有効にすると、何が起こっているかの詳細を確認できます。

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

DEBUG=openai-agents:*

または、SDK の特定の部分にスコープを限定してデバッグできます。