トラブルシューティング

サポート対象の環境

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

Cloudflare Workers: Agents SDK は Cloudflare Workers でも利用できますが、現時点ではいくつかの制限があります:
- 現在、SDK では nodejs_compat を有効化する必要があります
- トレースはリクエストの最後に手動でフラッシュする必要があります。詳しくはトレーシングを参照してください
- Cloudflare Workers の AsyncLocalStorage サポートが限定的なため、一部のトレースが正確でない可能性があります
Browsers:
- ブラウザでは現在トレーシングはサポートされていません
v8 isolates:
- 適切なブラウザ用ポリフィルを備えたバンドラを使えば SDK を v8 isolates 向けにバンドルできますが、トレーシングは動作しません
- v8 isolates は広範にはテストされていません

SDK の利用時に問題が発生した場合、デバッグログを有効にすると、内部で何が起きているかの情報を得られます。

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

DEBUG=openai-agents:*

また、SDK の特定部分にデバッグ対象を絞り込むこともできます: