コンテンツにスキップ

Cloudflare 上の音声エージェント

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

  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-2.1',
    });
    const session = new RealtimeSession(agent, {
    // Set your own transport.
    transport: cfTransport,
    });
  3. RealtimeSession を接続します。

    await session.connect({ apiKey: 'your-openai-ephemeral-or-server-key' });
  • Cloudflare トランスポートは、内部で Upgrade: websocket を指定した fetch() を使用し、workerd の API に合わせてソケットの open イベントを待機しません。
  • このトランスポートを使用しても、RealtimeSession のすべての機能(ツール、ガードレールなど)は通常どおり動作します。
  • 開発中に詳細なログを確認するには、DEBUG=openai-agents* を使用してください。