コンテンツにスキップ

Cloudflare Workers 用トランスポート

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

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

    Terminal window
    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* を使用します