トラブルシューティング

対応環境

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

• Node.js 22+
• Deno 2.35+
• Bun 1.2.5+

制限付きサポート

• Cloudflare Workers: Agents SDK は Cloudflare Workers でも利用できますが、現在は次の制限があります:
  • SDK では現在 nodejs_compat を有効にする必要があります
  • リクエストの終了時にトレースを手動でフラッシュする必要があります。詳細は トレーシング ガイド を参照してください
  • Cloudflare Workers では AsyncLocalStorage のサポートが限定的なため、一部のトレースが正確でない可能性があります
• ブラウザ:
  • ブラウザでは現在トレーシングはサポートされていません
• v8 isolates:
  • 適切なブラウザ polyfill を含むバンドラを使用すれば v8 isolates 向けに SDK をバンドルできますが、トレーシングは機能しません
  • v8 isolates での動作は十分にテストされていません

デバッグログ

SDK で問題が発生した場合は、デバッグログを有効にして処理状況の詳細を確認できます。

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

DEBUG=openai-agents:*

また、SDK の特定の部分だけに対象を絞ってデバッグを有効にすることもできます:

• openai-agents:core — SDK のメイン実行ロジック
• openai-agents:openai — OpenAI API 呼び出し
• openai-agents:realtime — Realtime Agents コンポーネント