음성 에이전트 설정 참조

모든 ThunderPhone 음성 에이전트 설정을 설명합니다. 티어, 음성, 언어, 맞장구, 도구, 발화 순서, 음성사서함, 동의 안내, 무음 처리, 테스트 및 배포를 다룹니다.

음성 에이전트를 열고 에이전트를 선택한 다음 구성 탭에서 음성, 추론, 통화 시작 방식, 도구 사용, 무음 및 음성사서함 처리, 발신자 연결 방식을 제어합니다. 변경 사항은 초안으로 자동 저장되며, 배포를 선택하기 전까지 운영 트래픽에는 적용되지 않습니다.

이 페이지는 전체 대시보드 참조 문서입니다. 필드 이름과 요청 예시는 에이전트 API 참조를 확인합니다.

프롬프트 및 정체성#

에이전트 이름은 대시보드, 보고서, 통화 기록, 클라이언트 포털 전반에서 에이전트를 식별합니다. 프롬프트는 에이전트의 운영 스크립트로서 페르소나, 비즈니스 정보, 필수 질문, 에스컬레이션 정책 및 통화 작업을 정의합니다.

프롬프트 편집기는 예상 토큰을 표시하고 빈 프롬프트, 해결되지 않은 템플릿 자리 표시자, 누락된 에스컬레이션 경로 또는 매우 긴 프롬프트와 같은 일반적인 문제를 표시합니다. 처음 예상 토큰 5,000개는 포함되며, 더 긴 프롬프트에는 블록 기반 추가 요금이 적용됩니다.

라우팅 규칙, 콜드 전환 및 스크리닝된 웜 전환은 통화 전환을 참조합니다.

모델 등급#

Storm은 두 가지 선택 통제 항목을 제공합니다.

• 응답 표시 — 없음은 전체 응답을 준비하는 동안 무음으로 유지됩니다. 틱은 부드러운 대기음을 재생하며, 음성은 짧은 응답 표시를 말하고 2¢/min의 추가 요금이 적용됩니다. 음성 텍스트는 기본 프롬프트에서 생성하거나 수동으로 제공할 수 있습니다. 사용자 지정 응답 표시 프롬프트는 선택한 Storm 모드가 음성 응답 표시를 지원할 때만 나타나며, 그렇지 않으면 해당 필드를 사용할 수 없습니다.
• 추가 지능 — 복잡한 통화를 위한 심층 추론이 추가되며 3¢/min의 추가 요금이 적용됩니다.

빌더는 등급, 음성/언어 경로, 프롬프트 길이, 음성 응답 표시, 추가 지능 및 감독을 포함한 에이전트의 총 분당 비용을 지속적으로 표시합니다.

음성, 배경 및 언어#

배포하기 전에 음성을 선택하고 샘플을 재생합니다. 선택기에서는 선택한 음성이 기본 언어를 지원하기만 하면 됩니다. 기본 음성으로 전환을 켜면 추가 언어는 동일 성별의 기본 카탈로그 음성으로 지원할 수 있습니다. 프리미엄 조합에는 추가 요금이 표시됩니다. 사용자 지정 음성은 준비되면 같은 선택기에 표시됩니다. 음성 라이브러리 및 사용자 지정 음성을 참조하세요.

배경 트랙은 다음 중에서 선택할 수 있습니다.

• 없음 — 주변 소리 없음
• 콜센터 — 대시보드 내 미리보기가 제공되는 콜센터 분위기음

하나의 기본 언어를 설정한 다음 원하는 수의 추가 언어를 설정합니다. 에이전트는 발신자가 선택된 언어로 전환하는 시점을 자동으로 감지하고 해당 언어로 응답합니다. 일부 음성/언어 조합에는 3¢/min의 추가 요금이 적용됩니다. 생성된 지원 언어 카탈로그를 참조합니다.

에이전트에 추가 언어가 있는 경우 기본 음성으로 전환을 활성화하여 감지된 언어의 원어민 카탈로그 음성을 성별에 맞춰 사용합니다. 기본 언어에 구성된 음성으로 다시 전환됩니다. 일치하는 원어민 음성을 사용할 수 없는 경우 현재 음성이 계속 사용됩니다. 사용자 지정 음성은 전환되지 않습니다. 대화로 각 언어를 테스트한 다음 배포를 선택합니다.

기본 음성 전환에는 별도의 추가 요금이 없습니다. 선택한 언어와 음성 조합에 따라 프리미엄 언어 요금 적용 여부가 결정됩니다.

연결된 기능#

Config 탭에는 독립적으로 연결할 수 있는 네 개의 기능 섹션이 있습니다.

연결 항목은 초안의 일부이며 배포 후 프로덕션 통화에서 사용할 수 있습니다. 먼저 Connections 또는 Knowledge에서 리소스를 구성한 다음 에이전트에 연결합니다.

전화 및 웹 엔드포인트#

Phone numbers에서 기존 번호를 연결하거나 ThunderPhone 번호를 받거나 VoIP 연결을 통해 번호를 가져옵니다. 하나의 번호는 수신 및 발신 방향에 서로 다른 에이전트를 사용할 수 있습니다.

Web widgets에서 위젯을 연결하면 방문자가 사이트에서 에이전트와 대화할 수 있습니다. 위젯 사용 가능 여부는 에이전트 구성의 일부로 활성화하거나 비활성화할 수도 있습니다.

시간대#

전화번호 아래의 시간대는 에이전트가 "현재"로 간주하는 기준입니다. 에이전트는 이 시간대를 기준으로 날짜와 시간을 안내하고, 예약 시간을 제안하며, "오늘"과 "내일"을 계산합니다. 보고서의 이 에이전트 업무 시간도 이 시간대를 사용합니다.

새 에이전트는 조직의 시간대를 사용하며, 조직에 시간대가 없으면 컴퓨터의 시간대를 사용합니다. 발신자가 다른 지역에 있는 경우 변경합니다. 에이전트의 전화번호가 선택한 시간대와 다른 시간대에 있으면 빌더에서 이를 알리고 변경할 수 있도록 제안합니다.

시간대가 없는 에이전트(기존 에이전트 또는 timezone 없이 API를 통해 생성된 에이전트)는 통화에 사용되는 번호의 시간대를 먼저 사용하고, 그다음 에이전트 번호의 시간대, 조직의 시간대, 미국 태평양 시간대 순으로 사용합니다. 빌더는 적용되는 시간대를 표시하고 확인을 요청합니다. 번호만으로 시간대를 결정할 수 없는 경우(수신자 부담 번호 또는 서로 다른 시간대의 번호)에는 시간대를 선택하도록 요청합니다.

하나의 에이전트가 여러 시간대의 연락처를 지원하는 경우, 각 통화에 시간대를 전달합니다. POST /v1/call의 timezone 또는 구성 웹훅 응답에서 설정합니다.

에이전트에 아직 시간대가 없는 경우#

새 에이전트에는 시간대가 필요합니다. 이전 에이전트에는 여전히 시간대가 없을 수 있습니다.

이전 에이전트에 시간대가 없는 경우, ThunderPhone은 먼저 에이전트 자체 설정이 있으면 이를 사용하고, 그다음 조직의 설정을 사용하며, 이후 에이전트의 전화번호에서 추론한 시간대를 사용합니다. 그래도 결정되지 않으면 로스앤젤레스 시간대로 대체합니다. 빌더는 확인된 시간대를 표시하고 확인을 요청하며, 전화번호만으로 결정되지 않는 경우에는 시간대를 선택하도록 요청합니다.

고급 통화 동작#

다음 통제 항목을 사용하려면 구성 하단에서 고급을 펼치십시오.

감독#

활성화하면 두 번째 AI 모니터가 각 에이전트 턴을 지시 사항과 비교하여 확인하고 조용히 개입할 수 있습니다. 감독 기능을 사용하면 4¢/분 요금이 추가되며 Bolt에서는 사용할 수 없습니다.

연결음#

통화가 연결된 직후와 어느 쪽이든 말하기 전에 짧은 소리를 재생합니다.

소개 클립#

수신 전화가 시작될 때 미리 녹음된 클립을 재생한 후 벨소리가 울리도록 하여, 에이전트가 응답하기 전에 회사 전화선처럼 들리게 합니다. 이 기능은 수신 전화와 빌더의 통화(브라우저) 테스트 통화에서 재생됩니다. 발신 전화, AI 테스트 통화, 웹 위젯 통화 또는 Realtime API 통화에서는 재생되지 않습니다.

• 끔(기본값) — 에이전트가 즉시 응답합니다.
• 녹음 고지 — 녹음된 음성이 "이 통화는 품질 보증을 위해 모니터링되거나 녹음될 수 있습니다."라고 안내합니다. 빌더에서 미리 들어볼 수 있습니다.
• 자체 녹음 — 오디오 파일(MP3, WAV, M4A 및 브라우저에서 재생할 수 있는 기타 형식)을 업로드하거나 브라우저에서 녹음합니다. 클립 길이는 0.5~15초일 수 있습니다. 빌더가 업로드 전에 클립을 변환하며, 재생하거나 제거할 수 있습니다.

소개 후 벨소리는 클립 뒤에 재생할 미국식 벨소리 횟수를 설정합니다. 끔, 1회 벨소리(기본값) 또는 2회 벨소리 중에서 선택합니다.

통화 시작 시 순서는 다음과 같습니다. 연결음(켜져 있는 경우), 소개 클립, 벨소리, 적용되는 경우 동의 안내 또는 AI 처리 고지, 그리고 인사말입니다. 클립에서 통화가 녹음된다고 안내하더라도 소개 클립은 동의 안내나 AI 처리 고지를 대체하지 않습니다. 클립과 벨소리가 재생되는 동안에는 발신자 오디오가 처리되지 않습니다. 맞춤 클립은 통화가 시작될 때 가져옵니다. 몇 초 내에 로드할 수 없으면 클립 없이 통화가 진행되므로, 로드 실패 시 인사말이 최대 약 3초 지연될 수 있습니다.

소개 클립은 다른 설정과 마찬가지로 초안 설정입니다. 배포하면 실제 통화에 적용됩니다.

도구 소리#

프롬프트에서 호출할 수 있는 소리 도구가 내는 소리를 선택하십시오.

• 없음 — 도구를 제공하지 않습니다.
• 차임, 딩 또는 비프 — 빌더에서 각각 미리 들을 수 있습니다.

타이핑 소리#

에이전트가 맞춤 도구를 실행하는 동안 부드러운 키보드 소리를 재생하려면 타이핑 소리를 활성화하십시오. 플랫폼에서 관리하는 도구는 이를 실행하지 않습니다.

활성화한 후 사운드를 선택합니다. 각 사운드는 빌더에서 미리 들을 수 있습니다.

• 키보드 및 마우스(기본값): 무언가를 찾아보는 듯한 마우스 클릭이 포함된 타이핑 소리입니다.
• 기계식 키보드: 밝고 클릭감 있는 기계식 키 소리입니다.
• 데스크톱 키보드: 일반 키보드에서 일정하게 타이핑하는 소리입니다.
• 노트북: 부드럽고 평평한 노트북 키 소리입니다.
• 사무용 키보드: 조용하고 차분한 사무용 키보드 소리입니다.
• 조용한 방: 한 사람이 타이핑하는 부드러운 실내 배경음입니다.

도구 시작 안내 문구#

에이전트가 도구를 호출할 때 안내 문구를 말할지 선택합니다.

• 항상(새 에이전트의 기본값): 도구가 얼마나 빨리 응답하더라도 모든 도구 호출 시 안내 문구를 말합니다. 에이전트가 도구 호출과 함께 말한 경우에는 에이전트가 한 말이 해당 안내 문구가 됩니다. 그렇지 않은 경우 호출용으로 작성된 짧은 안내 문구가 준비되는 즉시 재생되며, 약 1초 이상 걸리면 "잠시만 기다려 주세요"와 같은 기본 안내 문구가 재생됩니다. 자체 오디오를 재생하거나 통화 자체에 작용하는 도구(키패드 입력, 소리, 보류, 연결 전환, 통화 종료, 단계 인계)는 느린 경우에만 안내 문구가 재생됩니다. 에이전트가 전화 메뉴에 있거나 음성사서함과 대화 중일 때의 모든 도구에도 동일하게 적용됩니다.
• 도구가 느린 경우에만: 에이전트가 마지막으로 말한 후 약 3초가 지나도 도구가 계속 실행 중인 경우에만 짧은 안내 문구가 재생됩니다. 이 설정이 도입되기 전에 생성된 에이전트는 이 선택을 유지합니다.
• 안 함: 도구가 시작될 때 ThunderPhone은 아무 말도 하지 않으며, 에이전트에게도 도구를 호출할 때 말하지 않도록 지시합니다. 에이전트가 도구 호출과 함께 계속 말하는 내용은 재생됩니다.

어떤 옵션을 선택하든 에이전트가 직접 말한 내용은 항상 재생됩니다. 발신자는 턴당 도구 시작 안내 문구를 최대 하나만 듣습니다. 에이전트의 말이나 느린 응답에 대한 채움 문구처럼 해당 턴에서 이미 말한 안내 문구가 있으면 그것이 도구 시작 안내 문구로 계산됩니다.

긴 대기 업데이트#

기본적으로 켜져 있습니다. 약 12초 동안 아무 말 없이 도구가 계속 실행 중이면 에이전트가 아직 처리 중이라고 말한 다음, 결과가 도착할 때까지 약 15초마다 짧은 기다림 안내 문구를 추가합니다. 이 안내 문구는 통화에 맞게 작성됩니다. 에이전트의 프롬프트와 페르소나, 지금까지의 대화 내용 및 통화 언어를 따르므로 하나의 고정된 문장을 반복하지 않습니다. 제시간에 안내 문구를 작성할 수 없으면 에이전트는 "죄송합니다. 예상보다 조금 더 시간이 걸리고 있습니다"와 같은 기본 안내 문구를 사용합니다. 도구 없이 응답이 느린 경우에는 "잠시만요"와 같은 짧은 기본 안내 문구가 사용됩니다.

도구 시작 안내 후 결과가 도착할 때까지 조용히 유지하려면 긴 대기 업데이트를 끕니다. 도구 없이 응답이 느린 경우에도 추가 안내가 제공되지 않습니다. 타이핑 소리는 활성화되어 있으면 계속 재생됩니다. Storm의 맞장구 설정은 별도이며 영향을 받지 않습니다.

설정이 프롬프트보다 우선합니다#

도구 시작 안내 문구와 긴 대기 업데이트는 도구가 실행되는 동안 ThunderPhone이 말하는 내용을 결정합니다. 프롬프트 텍스트로는 이러한 안내 문구를 중지하거나 추가할 수 없습니다. 도구가 실행되는 동안 조용히 유지되는 에이전트를 만들려면 프롬프트에서 조용히 하도록 요청하는 대신 도구 시작 안내 문구를 안 함으로 설정하고 긴 대기 업데이트를 끕니다. 빌더의 프롬프트 검사는 프롬프트가 조용히 하도록 요청하거나 모든 도구 호출 시 안내 문구를 요청하는데 이러한 설정이 다르게 지정된 경우 경고를 표시합니다.

이메일 보내기#

이메일 보내기를 활성화하고 수신자 주소 하나를 입력하면 에이전트에 send_email 도구가 제공됩니다. 주소는 에이전트 설정에 고정됩니다. 모델이 제목과 일반 텍스트 본문을 작성하지만 수신자를 선택하거나 변경할 수는 없습니다. 예를 들어 발신자의 이름과 회신 전화번호를 수집한 후 발신자의 메시지를 보내는 경우처럼, 이메일을 생성해야 하는 정확한 상황을 에이전트에 프롬프트로 지정하십시오.

전체 도구 동작은 내장 도구를 참조하십시오.

SMS 보내기#

SMS 보내기를 활성화하면 에이전트에 send_sms 도구가 제공됩니다.

어떤 연결된 VoIP 번호(Twilio 또는 Telnyx, SMS 사용 가능 및 인증됨)에서 발송할지 선택하십시오. ThunderPhone에서 프로비저닝한 번호는 SMS를 보낼 수 없습니다. 발신자에게만 보내도록 제한하거나 다른 수신자를 허용하고 승인된 번호의 허용 목록을 유지할 수 있습니다. 통화 후 전송하는 메시지에 사용할 SMS 후속 메시지 템플릿을 활성화할 수도 있습니다.

전체 도구 동작은 내장 도구를 참조하십시오.

추가 오디오 컨텍스트#

추가 오디오 컨텍스트는 턴 간에 전달되는 최근 발신자 오디오의 양을 제어합니다.

• 자동(권장) 모드는 인바운드, 브라우저 및 WebSocket 통화에 더 많은 최근 오디오를 사용하고, 아웃바운드 전화 통화에는 가장 최근 턴만 사용합니다.
• 켜기는 수정, 철자 확인 및 숫자가 많은 데이터 수집에 도움이 되도록 최근 몇 개의 발신자 턴을 포함합니다.
• 끄기는 지연 시간을 낮추기 위해 가장 최근 발신자 턴만 포함합니다.

Agents API는 Storm 전용 audio_context_mode 호환성 필드도 제공합니다. 값은 full 또는 reduced입니다. 이는 위의 대시보드 additional_audio_context 3단계 설정과 별개입니다.

먼저 말하는 사람#

인바운드 및 아웃바운드 통화를 각각 구성하십시오.

• 인바운드: 에이전트가 먼저 말하거나 발신자가 먼저 말합니다.
• 아웃바운드: 에이전트가 먼저 말하거나 수신자가 먼저 말합니다.

에이전트의 첫 인사를 제거하려면 인바운드 통화에는 발신자가 먼저 말함을 선택하고, 아웃바운드 통화에는 수신자가 먼저 말함을 선택하십시오.

이 설정은 스크립트를 시작하기 전에 사람 또는 전화 메뉴를 기다려야 하는 아웃바운드 다이얼러에 유용합니다.

음성사서함 처리#

아웃바운드 통화가 음성사서함에 연결될 때 수행할 작업을 선택하십시오.

음성사서함 메시지는 최대 2,000자까지 포함할 수 있으며 {agent_name} 및 {org_name}을 지원합니다. 통화 시간이 측정되는 방식은 요금을 참조하십시오.

동의 안내#

기본적으로 모든 통화 시작 시 짧은 안내가 발신자에게 AI 어시스턴트와 통화 중이며 통화가 녹음된다는 사실을 알립니다. 안내 문구는 최대 2,000자까지 편집할 수 있으며 에이전트의 언어로 그대로 재생됩니다.

사용 가능한 에이전트에서 안내를 비활성화하려면 조직 관리자가 조직이 법적으로 요구되는 모든 고지를 제공하고 법적으로 요구되는 모든 동의를 받을 것임을 확인해야 합니다. 다시 활성화한 후 나중에 비활성화하려면 새로 확인해야 합니다. 이 설정을 변경하기 전에 녹음 동의 법률 가이드를 검토하십시오.

통화 녹음#

통화 녹음은 이 에이전트가 통화 오디오, 스크립트 및 기타 통화 콘텐츠를 저장할지 여부를 제어합니다. 녹음이 이루어지려면 조직 전체의 녹음 설정도 활성화되어 있어야 합니다. 녹음이 꺼져 있으면 해당 기록은 저장되지 않습니다. 녹음은 통화 시작 후 최대 3시간까지만 포함합니다. 통화가 더 길어도 계속 진행되지만, 3시간 이후의 오디오는 녹음되지 않습니다. 자세한 내용은 통화 녹음 동의 관련 법률을 참조하세요.

AI 처리 고지#

녹음이 꺼져 있으면 AI 처리 고지가 오디오는 실시간으로 처리되지만 녹음되지는 않는다는 짧은 고지를 제어합니다. 조직 설정 사용, 항상 재생 또는 재생 안 함을 선택하십시오. 고지를 비활성화하려면 조직 관리자의 확인이 필요합니다.

중단할 수 없는 고지#

중단할 수 없는 고지는 호환성을 위해 계속 표시되지만, 활성화해도 효과가 없습니다. 꺼 둔 상태로 유지하십시오. 필수 시작 문구에는 대화 전에 재생되며 중단할 수 없는 동의 안내를 사용하십시오.

침묵 확인#

활성화하면 에이전트가 일정 시간 침묵한 후 발신자가 아직 통화 중인지 확인하고, 설정한 한도까지 반복한 후 전화를 끊습니다.

• 확인 전 대기 시간: 10–120초
• 최대 확인 횟수: 1–10회

기본값은 15초 및 3회 확인입니다.

통화 길이 및 시간 초과#

다음 통제 항목을 사용하여 멈춘 통화나 비정상적으로 긴 통화로 통화 시간과 전화 요금이 누적되지 않도록 하십시오.

• 통화 종료 전 무음 시간(분): 1~60분입니다. 기본값은 10분이며 무음 확인이 비활성화된 경우 적용됩니다.
• 최대 통화 시간: 1~360분입니다. 새 에이전트의 기본값은 60분이지만, 통역사 템플릿으로 만든 에이전트는 에이전트 수준 제한 없이 시작합니다. 제한을 늘리거나 줄이거나, 에이전트 수준 제한을 없애려면 비활성화할 수 있습니다. 이 기본값이 적용되기 전에 생성된 에이전트는 기존 설정을 유지합니다. 제한 45초 전(제한이 3분 미만인 경우 제한 시간의 4분의 1 전)에 에이전트에게 통화를 마무리하고 작별 인사를 하도록 안내합니다.
• 플랫폼 제한: 에이전트 설정과 관계없이 모든 통화는 6시간 후 종료됩니다. 에이전트는 그 전에 동일한 마무리 경고를 받습니다.
• 벨 울림 시간: 발신 및 전환 통화의 벨이 5~120초 동안 울리도록 설정합니다. 플랫폼 기본값을 사용하려면 설정하지 마세요. 발신 통화는 60초, 웜 전환은 45초, 콜드 전환은 통신사 기본값이 적용됩니다. 이 설정은 수신 통화의 벨 울림에는 영향을 주지 않습니다.

빌더 탭 및 수명 주기#

다른 편집자가 에이전트를 불러온 후 동일한 에이전트를 저장하면 ThunderPhone은 변경 사항을 덮어쓰는 대신 충돌하는 저장 또는 배포를 중지하고 새로 고치도록 요청합니다.

목록에서 에이전트 관리#

음성 에이전트 페이지는 조직 수준의 수명 주기 작업도 지원합니다.

• 동일한 조직에서 새 시작점으로 에이전트를 복제합니다.
• 소속된 다른 조직으로 에이전트를 이전합니다. 복사는 원본을 유지하고, 이동은 현재 조직에서 제거하며 관리자 권한이 필요합니다.
• 확인 후 에이전트 하나를 삭제하거나 선택한 에이전트를 일괄 삭제합니다.

에이전트 목록 내보내기#

하나 이상의 에이전트를 선택하고 요약 필드를 CSV 또는 JSON으로 내보냅니다. 내보내기에는 전체 프롬프트가 포함되지 않으며 구성 백업이 아닙니다.

조직 간에 에이전트를 복사하거나 이동해도 대상 조직에 원본 전용 연결에 대한 액세스 권한이 자동으로 부여되지는 않습니다. 해당 위치에 배포하기 전에 복사한 에이전트의 앱, API, 지식, MCP, 전화번호 및 위젯 연결을 검토합니다.

관련 페이지#