トラブルシューティング

サポートされる環境

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:
- 適切なブラウザポリフィルを備えたバンドラを使えば v8 isolates 向けに SDK をバンドルできるはずですが、トレーシングは動作しません
- v8 isolates は十分な検証が行われていません

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

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

DEBUG=openai-agents:*

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