Cloudflare 上の Realtime Agent

Cloudflare Workers やその他の workerd ランタイムでは、グローバルな WebSocket コンストラクターを使用してアウトバウンド WebSockets を開くことはできません。これらの環境からリアルタイムエージェントに簡単に接続できるように、extensions パッケージは内部で fetch() ベースのアップグレードを実行する専用 transport を提供します。

注意

この adapter はまだベータ版です。エッジケースの問題やバグに遭遇する可能性があります。 問題があれば GitHub issues から報告してください。迅速に修正します。 Workers で Node.js スタイルの API を使う場合は、nodejs_compat の有効化を検討してください。

セットアップ

1. extensions パッケージのインストール

   npm install @openai/agents-extensions

2. transport の作成と session への接続

   import { CloudflareRealtimeTransportLayer } from '@openai/agents-extensions';
   import { RealtimeAgent, RealtimeSession } from '@openai/agents/realtime';
   
   const agent = new RealtimeAgent({
     name: 'My Agent',
   });
   
   // Create a transport that connects to OpenAI Realtime via Cloudflare/workerd's fetch-based upgrade.
   const cfTransport = new CloudflareRealtimeTransportLayer({
     url: 'wss://api.openai.com/v1/realtime?model=gpt-realtime-2',
   });
   
   const session = new RealtimeSession(agent, {
     // Set your own transport.
     transport: cfTransport,
   });

3. RealtimeSession の接続

   await session.connect({ apiKey: 'your-openai-ephemeral-or-server-key' });

注意点

• Cloudflare transport は内部で Upgrade: websocket を指定した fetch() を使用し、socket の open イベントの待機をスキップして、workerd API に合わせます。
• この transport を使用している場合も、すべての RealtimeSession 機能（tools、ガードレールなど）は通常どおり動作します。
• 開発中に詳細なログを確認するには、DEBUG=openai-agents* を使用してください。