トラブルシューティング

サポートされる環境

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 のサポートが限定的であるため、一部のトレースが正確でない場合があります
  • アウトバウンド WebSocket 接続では、fetch ベースのアップグレードを使用する必要があります（グローバルな WebSocket コンストラクターではありません）。Realtime では、@openai/agents-extensions の Cloudflare transport（CloudflareRealtimeTransportLayer）を使用してください。
• Responses API WebSocket transport:
  • グローバルな WebSocket 実装が必要です。
  • WebSocket 実装は、ハンドシェイク用のカスタムヘッダーをサポートしている必要があります。
  • 多くのブラウザー形式の WebSocket API（および一部のエッジランタイム）は、カスタムアウトバウンドヘッダーをサポートしていません。そのような環境では、代わりにデフォルトの HTTP Responses transport を使用してください。
  • グローバルな WebSocket 実装がない、またはカスタムヘッダーのサポートがないことに関するエラーが表示される場合、そのランタイムの websocket 実装は Responses WebSocket transport と互換性がありません。
• ブラウザー:
  • コア SDK はブラウザーで使用するためにバンドルできますが、そこではデフォルトでトレーシングが無効になっています。
• v8 isolates:
  • 適切なブラウザーポリフィルを備えたバンドラーを使用すれば、SDK を v8 isolates 向けにバンドルできるはずですが、トレーシングは機能しません
  • v8 isolates は広範にはテストされていません

デバッグログ

SDK で問題が発生している場合は、デバッグログを有効にして、何が起きているかについてより多くの情報を取得できます。

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

DEBUG=openai-agents:*

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

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