​

실행 대기음

​

사용 시점

• 응답이 느린 API 호출: 외부 서비스에서 데이터를 가져오는 동안 무음 구간을 소리로 대체
• 오래 걸리는 작업: 조회·예약 처리·외부 시스템 연동처럼 몇 초 이상 걸리는 작업에 오디오 피드백 제공
• 자연스러운 대화 흐름: 대화 중간의 어색한 침묵 방지
• 처리 중 신호: 장애가 아니라 요청을 처리하는 중임을 사용자에게 전달

​

선택할 수 있는 대기음

​

동작 방식

• 에이전트가 말하는 동안에는 음소거됩니다. 실행 중 발화와 대기음이 겹쳐 들리지 않습니다.
• 사용자가 말을 시작하면 즉시 정지합니다.
• 도구 결과를 바탕으로 한 발화가 시작되면 종료됩니다.

사용자: "제 주문 언제 도착하나요?"
에이전트: "주문 내역을 확인해 드릴게요." [발화가 끝난 뒤 타이핑음 재생]
에이전트: "어제 발송되어 내일 도착 예정입니다."

​

설정 위치

​

API와 CLI에서 설정하기

{
  "tool_call_sound": "typing"
}

{
  "data": {
    "tool_call_sound": "elevator_1"
  }
}

​

모범 사례

​

실행 시간에 맞는 대기음

​

실행 중 발화와의 조합

​

실제 지연으로 테스트

​

예시 구성

​

조회형 도구

​

외부 시스템을 조회하는 상담 에이전트

​

여러 단계를 거치는 플로우

​

문제 해결

​

대기음이 들리지 않을 때

1. 도구가 너무 빨리 끝났습니다: 실행이 500밀리초 안에 끝나면 대기음이 재생될 시간이 없습니다. 정상 동작입니다.
2. 실행 중 발화가 실행 구간을 전부 덮었습니다: 에이전트가 말하는 동안 대기음은 음소거되므로, 발화가 도구 실행보다 길면 대기음이 들리지 않습니다.
3. 지원되지 않는 위치에 설정했습니다: 커스텀 API 도구와 Flow api·tool·sendSms 노드에서만 설정할 수 있습니다.

​

관련 문서

• 도구 개요
• API 도구
• 도구 노드