Cloudflare Voice 0.4.0, 에이전트 턴 지연·종료 원인 진단 추가

핵심 요약

Cloudflare가 @cloudflare/voice 0.4.0에 Voice Agent의 각 턴이 어디에서 지연되고 어떤 이유로 종료됐는지 확인할 수 있는 VoiceTurnMetrics를 추가했습니다. 음성 인식부터 모델 응답, TTS 첫 오디오까지의 구간별 시간을 확인하고, 응답 없음·출력 한도·콘텐츠 필터·모델 오류·TTS 오류·중단 같은 종료 원인도 구분할 수 있습니다.

주요 변경

• 각 음성·텍스트 턴에 turnId와 최종 outcome을 포함한 typed VoiceTurnMetrics를 제공합니다.
• speech-to-final-transcript, model-to-first-text, TTS-to-first-audio, 전체 턴 시간 등 주요 지연 구간을 측정할 수 있습니다.
• VoiceClient, useVoiceAgent(), useVoiceInput()에서 턴 요약과 진단 정보를 확인할 수 있습니다.
• withVoice(Agent, { diagnostics: { browserConsole: true }})로 서버 턴 수명주기와 브라우저의 마이크·연결·재생 이벤트를 함께 디버깅할 수 있습니다.

개발자 영향

음성 에이전트에서 “응답이 느리다”거나 “오디오가 나오지 않는다”는 문제를 STT, 모델, TTS 단계별로 분리해 진단하기 쉬워집니다. 특히 무응답과 모델 실패, 콘텐츠 필터링, 출력 한도 초과를 별도 outcome으로 구분할 수 있어 운영 모니터링과 장애 분석에 유용합니다. 사용하려면 @cloudflare/voice@^0.4.0과 호환되는 agents@^0.22.0이 필요합니다.

발표 시각(KST): 2026년 9월 11일 (공식 원문에 세부 시각 미표기)

원문 출처 보기 →