오디오 환경

배경음을 추가하고 에이전트 발신 오디오에 음성 필터를 적용하세요.

개요

오디오 환경은 에이전트의 발신 오디오가 발신자에게 들리는 방식을 제어합니다. 다음 두 가지 설정이 적용됩니다.

발신자는 결과 오디오를 듣습니다. 에이전트는 배경음을 듣지 않으며, 음성 인식으로 전송되지도 않습니다.

이는 도구가 실행되는 동안에만 재생되는 도구 호출 사운드와는 별개입니다.

배경음은 대화가 진행되는 동안 에이전트 음성 아래에 기본 제공 프리셋을 믹싱합니다. 사용자가 끼어들어도 사운드는 계속 반복되며 에이전트 차례가 끝나도 멈추지 않습니다.

프리셋에는 사무실, 레스토랑, 도시, 타이핑, 엘리베이터 음악이 포함됩니다. 대시보드에서는 저장하기 전에 프리셋을 미리 들을 수 있습니다.

conversation_config.conversation.background_sound로 배경음을 구성하세요.

에이전트를 여세요. Agent 페이지에서 Voices 옆의 Audio environment 버튼을 클릭하세요.

Enable background sound를 켜세요. Background sound에서 프리셋을 선택하세요. 드롭다운 옆의 재생 컨트롤로 미리 들을 수 있습니다.

Volume을 설정하세요. 사운드가 반복될 때 들리는 클릭음을 방지하려면 Crossfade loop를 활성화한 상태로 유지하세요. 변경 사항을 저장하세요.

WebSocket 연결 상태가 매우 좋지 않으면 배경음을 믹싱할 때 오디오가 끊길 수 있습니다.

유효한 source_id 값은 office1, office2, restaurant, city, typing, elevator1부터 elevator4까지입니다.

필드	유형	기본값	설명
`source_type`	string	설정 안 함	사운드가 활성화된 경우 `preset`이어야 합니다. `source_id`와 함께 설정하세요.
`source_id`	string	설정 안 함	기본 제공 프리셋의 식별자입니다.
`volume`	number	`0.15`	에이전트 음성 대비 레벨입니다. 범위는 `0.01`~`1.0`입니다.
`crossfade_loop`	boolean	`true`	반복 시 사운드가 클릭되지 않도록 루프 경계에서 크로스페이드합니다.

음성 필터는 에이전트가 생성한 음성을 변형합니다. 배경음을 이퀄라이즈하거나 노이즈를 제거하지는 않습니다. 필터가 먼저 적용되고, 필터링된 음성 아래에 배경음이 믹싱됩니다.

음성 필터는 대시보드 전용입니다. 공개 에이전트 API 또는 CLI 스키마에 포함되지 않으며, 모든 워크스페이스에서 사용 가능한 것은 아닙니다.

같은 Audio environment 패널에서 Voice filter를 Off 또는 전화 프리셋으로 설정한 후 저장하세요.

기본 제공 프리셋만 사용할 수 있습니다. 사용자 지정 파일을 업로드하거나 임의의 URL을 지정할 수 없습니다.
에이전트가 텍스트 전용인 경우 오디오 환경 컨트롤은 숨겨집니다.
배경음은 WhatsApp 음성 메시지 응답에 믹싱되지 않습니다. WhatsApp 통화에는 계속 포함됩니다.
클라이언트 재정의를 통해 대화별로 배경음을 설정할 수 없습니다. conversation_config_override에는 background_sound가 포함되지 않습니다. 그래도 workflow 노드에서는 변경할 수 있습니다.