Cloudflare 上の音声エージェント
Cloudflare Workers やその他の workerd ランタイムでは、グローバルの WebSocket コンストラクターを使用して外向きの WebSocket 接続を確立できません。これらの環境から音声エージェントを簡単に接続できるように、extensions パッケージには、fetch() ベースのアップグレードを内部で実行する専用のトランスポートが用意されています。
セットアップ
Section titled “セットアップ”-
extensions パッケージをインストールします。
ターミナルウィンドウ npm install @openai/agents-extensions -
トランスポートを作成し、セッションに設定します。
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.1',});const session = new RealtimeSession(agent, {// Set your own transport.transport: cfTransport,}); -
RealtimeSessionを接続します。await session.connect({ apiKey: 'your-openai-ephemeral-or-server-key' });
- Cloudflare トランスポートは、内部で
Upgrade: websocketを指定したfetch()を使用し、workerd の API に合わせてソケットのopenイベントを待機しません。 - このトランスポートを使用しても、
RealtimeSessionのすべての機能(ツール、ガードレールなど)は通常どおり動作します。 - 開発中に詳細なログを確認するには、
DEBUG=openai-agents*を使用してください。