콘텐츠로 이동

Cloudflare용 음성 에이전트

Cloudflare Workers 및 기타 workerd 런타임에서는 전역 WebSocket 생성자로 아웃바운드 WebSocket 연결을 열 수 없습니다. 이러한 환경에서 음성 에이전트를 더 쉽게 연결할 수 있도록, 확장 패키지는 내부적으로 fetch() 기반 업그레이드를 수행하는 전용 전송 계층을 제공합니다.

  1. 확장 패키지를 설치합니다.

    터미널 창
    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*를 사용합니다.