Barge-in 이벤트 (Agent → 콜브릿지 통화시스템)
1. API 개요
Barge-in 이벤트Agent가 음성을 재생하는 중 사용자가 발화를 시작하여 Agent의 음성을 중간에 끊는 상황(Barge-in) 이 감지되었을 때 발생하는 이벤트입니다.
이 이벤트는 Agent 서버에서 콜브릿지 통화시스템으로 전달됩니다.
이 이벤트를 수신한 콜브릿지 통화시스템은 아직 사용자에게 재생되지 않은 Agent 음성 데이터를 재생하지 않도록 처리합니다.
Barge-in 설명
Barge-in은 Agent가 음성 응답을 재생하는 동안 사용자가 말을 시작하여 Agent의 음성을 중단시키는 상황을 의미합니다.
예시 상황
1.
Agent:
"안녕하세요. 무엇을 도와드릴까요?"
2.
사용자가 말을 시작
"아니요 잠깐만요—"
이 경우 Agent의 음성 재생이 중단되고 사용자 발화 처리가 우선 수행됩니다.
Plaintext 설명
Barge-in은 사용자가 시스템 음성을 중간에 끊고 발화를 시작하는 상황을 의미합니다.
이 이벤트는 Agent의 음성 인식 시스템이 사용자의 발화를 감지했을 때 발생하며,
콜브릿지 통화시스템은 해당 이벤트를 수신하면 현재 재생 중이거나 대기 중인 Agent 음성을 중단합니다.
2. 사전 조건 / 권한
•
콜브릿지 계정 필수
•
WebSocket 음성 세션이 이미 연결된 상태
3. API 정보
Method / Endpoint
wss {wss 또는 ws}://{상담콜내 연동정보 입력한 주소}
4. Request
Request Body
이름 | 타입 | 필수 | 기본값 | 설명 |
type | string | O | interruption | Agent가 Barge-in 상황을 감지했을 때 발생하는 이벤트 타입 |
Request Example
{
"type": "interruption"
}
JavaScript
복사
5. 동작 방식
이 이벤트가 발생하면 콜브릿지 통화시스템은 다음 동작을 수행합니다.
1.
아직 사용자에게 재생되지 않은 Agent 음성 데이터 제거
2.
현재 재생 중인 Agent 음성 중단
3.
사용자 발화 처리 우선 수행
6. 이벤트 전송 타이밍
상황 | 이벤트 발생 |
Agent 음성 재생 중 사용자가 발화를 시작 | interruption 이벤트 전송 |
이 이벤트는 감지 시 즉시 1회 전송됩니다.