トラブルシューティング

サポート対象の環境

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