トラブルシューティング

対応環境

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 の特定の部分にスコープを絞ってデバッグできます: