Cloudflare Workers 用トランスポート
Cloudflare Workers とその他の workerd ランタイムは、グローバル WebSocket コンストラクタを使って外向き WebSocket を開くことができません。これらの環境から リアルタイムエージェント に簡単に接続できるようにするため、extensions パッケージは fetch() ベースのアップグレードを内部で実行する専用のトランスポートを提供します。
セットアップ
Section titled “セットアップ”-
extensions パッケージをインストールします。
Terminal window 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',});const session = new RealtimeSession(agent, {// Set your own transport.transport: cfTransport,}); -
RealtimeSessionを接続します。await session.connect({ apiKey: 'your-openai-ephemeral-or-server-key' });
- Cloudflare トランスポートは内部的に
fetch()とUpgrade: websocketを使用し、ソケットのopenイベント待ちをスキップして workerd API に合わせます - このトランスポート使用時も、
RealtimeSessionのすべての機能(tools、ガードレール など)は通常どおり動作します - 開発時の詳細ログ確認には
DEBUG=openai-agents*を使用します