トラブルシューティング
サポートされている環境
Section titled “サポートされている環境”OpenAI Agents SDK は次のサーバー環境でサポートされています:
- Node.js 22+
- Deno 2.35+
- Bun 1.2.5+
限定サポート
Section titled “限定サポート”- Cloudflare Workers: Agents SDK は Cloudflare Workers で使用できますが、現在はいくつかの制限があります:
- 現在、この SDK を使用するには
nodejs_compat
を有効にする必要があります - SDK は動的インポート
await import('@openai/agents')
でのみ読み込むことができます AsyncLocalStorage
へのサポートが限定的なため、一部のトレースが正確にならない可能性があります
- 現在、この SDK を使用するには
- ブラウザ:
- ブラウザでは現在トレーシングはサポートされていません
- v8 isolates:
- 適切なブラウザ用ポリフィルを備えたバンドラーを使用すれば v8 isolates 向けに SDK をバンドルできますが、トレーシングは機能しません
- v8 isolates での動作は十分にテストされていません
デバッグログ
Section titled “デバッグログ”SDK の使用で問題が発生した場合、デバッグログを有効にすると状況の詳細が確認できます。
DEBUG
環境変数に openai-agents:*
を設定するとデバッグログが有効になります。
DEBUG=openai-agents:*
また、以下のように対象を限定してデバッグすることもできます:
openai-agents:core
— SDK の主な実行ロジック用openai-agents:openai
— OpenAI API 呼び出し用openai-agents:realtime
— Realtime Agents コンポーネント用