トラブルシューティング

サポートされる実行環境

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 を十分にサポートしていないため、一部のトレースが正確でない場合があります
• Browsers:
  • ブラウザでは現在トレーシングはサポートされていません
• v8 isolates:
  • 適切なブラウザ用ポリフィルを有するバンドラーを使えば v8 isolates 向けに SDK をバンドルできますが、トレーシングは動作しません
  • v8 isolates については十分なテストが行われていません

デバッグログ

SDK の利用中に問題が発生した場合、デバッグログを有効にすると詳細情報を取得できます。

DEBUG 環境変数を openai-agents:* に設定するとデバッグログが有効になります。

DEBUG=openai-agents:*

特定部分だけを対象にデバッグすることもできます:

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