コンテンツにスキップ

トラブルシューティング

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

  • Node.js 22+
  • Deno 2.35+
  • Bun 1.2.5+
  • Cloudflare Workers: Agents SDK は Cloudflare Workers で使用できますが、現在はいくつかの制限があります:
    • 現在、この SDK を使用するには nodejs_compat を有効にする必要があります
    • SDK は動的インポート await import('@openai/agents') でのみ読み込むことができます
    • AsyncLocalStorage へのサポートが限定的なため、一部のトレースが正確にならない可能性があります
  • ブラウザ:
    • ブラウザでは現在トレーシングはサポートされていません
  • v8 isolates:
    • 適切なブラウザ用ポリフィルを備えたバンドラーを使用すれば v8 isolates 向けに SDK をバンドルできますが、トレーシングは機能しません
    • v8 isolates での動作は十分にテストされていません

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

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

Terminal window
DEBUG=openai-agents:*

また、以下のように対象を限定してデバッグすることもできます:

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