Cloudflare Workers 用トランスポート

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

注意

このアダプターはまだベータ版です。レアケースの問題やバグに遭遇する可能性があります。 問題は GitHub issues から報告してください。迅速に修正します。Workers で Node.js 風の API を使いたい場合は nodejs_compat の有効化を検討してください。

セットアップ

1. extensions パッケージをインストールします。

   npm install @openai/agents-extensions

2. トランスポートを作成してセッションにアタッチします。

   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',
   });
   
   const session = new RealtimeSession(agent, {
     // Set your own transport.
     transport: cfTransport,
   });

3. RealtimeSession を接続します。

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

注意事項

• Cloudflare トランスポートは内部的に fetch() と Upgrade: websocket を使用し、ソケットの open イベント待ちをスキップして workerd API に合わせます
• このトランスポート使用時も、RealtimeSession のすべての機能（tools、ガードレール など）は通常どおり動作します
• 開発時の詳細ログ確認には DEBUG=openai-agents* を使用します