トラブルシューティング

対応環境

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:
  • 適切なブラウザ用ポリフィルを備えたバンドラを使えば 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 — リアルタイムエージェント コンポーネント用に