페이지 콘텐츠로 건너뛰기
문서
Make Agent Fast 문서

음성 및 실시간 통화

텍스트, 음성 메시지, 실시간 통화와 언어 동작을 설정합니다.

이 페이지 한눈에

텍스트, 음성 메시지, 실시간 통화와 언어 동작을 설정합니다.

음성 파이프라인음성 입력, 에이전트 추론, 음성 출력
방문자마이크STT음성→텍스트에이전트추론TTS텍스트→음성
기본 음성음성 메시지실시간 통화

세 가지 상호작용 모드 이해하기#

모드방문자 경험권한 및 사용량
텍스트 채팅메시지를 입력하고 텍스트 수신항상 활성화, 일반 AI 크레딧 사용
음성 메시지녹음 후 전사/에이전트/TTS를 기다려 답변 수신모든 요금제 포함, 전사/모델/음성 작업에 크레딧 사용
실시간 음성 통화낮은 지연으로 음성 대화Operate 월 30분, Scale 월 90분, Launch 미지원. 설정한 통화 한도만큼 크레딧도 선결제

텍스트는 끌 수 없습니다. 음성 메시지와 실시간 토글은 방문자가 사용할 추가 화면을 제어합니다. 실시간 토글을 저장해도 워크스페이스 요금제 권한이나 누락된 제공자 설정을 우회하지 않습니다.

상호작용 동작 설정하기#

  1. 사이트의 에이전트 페이지에서 음성을 찾습니다.
  2. 텍스트 채팅은 켠 상태로 두고 음성 메시지 및/또는 실시간 음성을 선택합니다.
  3. 에이전트에 여러 언어가 있으면 선택적으로 실시간 언어 미러링을 켭니다.
  4. 통화당 자동 제한을 설정합니다.
  5. 기본 음성을 선택하세요.
  6. 저장하고 활성화한 각 모드를 따로 테스트합니다.

통화 제한은 30초부터 20분까지 30초 단위이며 기본값은 3분입니다. 개별 통화를 끝내고 월 허용량을 보호하지만 요금제의 남은 실시간 시간을 늘리지는 않습니다.

언어와 음성 선택하기#

에이전트에는 영어, 한국어, 우즈베크어, 러시아어를 설정할 수 있습니다. 첫 언어가 기본 언어입니다. 단일 언어 에이전트는 항상 그 언어로 답합니다. 다국어 텍스트 에이전트는 방문자가 설정된 언어 중 하나를 사용하면 그 언어를 따릅니다.

실시간 통화의 언어 미러링은 두 개 이상 언어에서만 표시되는 명시적 옵션입니다. 꺼져 있으면 실시간 통화는 기본 언어를 사용합니다. 우즈베크어 음성은 제공자 음성 지원이 덜 완전해 현재 최선 노력 방식이므로 출시 전 실제 제공자와 대상 사용자로 테스트하세요.

기본 음성에는 영어 우선, 다국어, 한국어 네이티브 옵션이 있습니다. 언어 레이블은 조정된 전달 특성이지 절대 보장이 아닙니다. 대시보드 미리 듣기 컨트롤이 있으면 선택 음성을 들어 보고 실제 방문자 흐름에서 이름, 약어, 통화, 전화번호, 전문 용어를 항상 테스트합니다.

제공자 키 및 폴백#

음성에는 모델 키 외의 설정이 필요합니다.

  • 음성-텍스트 전사는 플랫폼에 설정된 전사 제공자를 사용합니다.
  • 음성 메시지와 커넥터 오디오 답변에는 설정된 TTS 제공자가 필요합니다.
  • 실시간 통화에는 설정된 실시간 제공자와 요금제 허용량이 필요합니다.

플랫폼 관리 음성은 플랫폼에 설정된 제공자를 사용하므로 키가 필요하지 않습니다. Scale 소유자는 선택적으로 설정 → AI 제공업체 키에서 전사와 음성 합성용 Speko 키를 추가하고 제공자 키를 따를 수 있습니다. 실시간 통화는 항상 플랫폼 요금으로 청구됩니다. 텍스트 채팅 성공은 모델 경로만 증명하며 전사, 음성 합성, 미디어 업로드, 실시간 세션 생성을 증명하지 않습니다.

음성 메시지 테스트하기#

소유자 미리보기만 사용하지 말고 실제 임베드나 에이전트 링크에서 테스트하세요. 마이크 접근을 허용하고 짧은 질문을 녹음한 뒤 전사 의미와 음성/텍스트 응답을 확인합니다. 다음도 테스트하세요.

  • 조용하고 시끄러운 환경;
  • 필요한 경우 모바일 Safari와 Chrome;
  • 25MB 공개 오디오 제한에 가까운 긴 질문;
  • 마이크 권한 거부;
  • 지원하지 않거나 품질이 낮은 오디오;
  • 설정된 각 언어.

임베드 사이트에서는 상위 CSP와 Permissions Policy가 마이크를 허용해야 합니다. 보안 및 CSP를 참고하세요.

플랫폼 vs 게시된 사이트의 실시간 통화#

실시간 통화는 같은 통화 컨트롤을 두 곳에서 사용합니다.

화면위치모습활성화로 치나
에이전트 스튜디오 캔버스에이전트 페이지의 탭 옆 라이브 위젯대시보드 안에 표시되는 방문자 위젯 모습아니요 — 소유자 테스트는 활성화되지 않음
게시된 사이트와 임베드embed.js iframe, 에이전트 링크의 위젯, 남은 호스팅 데모 페이지(있는 경우)테넌트/위젯 모습예 — 방문자 통화는 실제 대화

표시 탭 옆의 캔버스도 같은 방문자 모습을 보여 줍니다. 출시 전 실제 임베드에서 테스트하세요. 대시보드 테스트 성공만으로는 임베드 마이크 권한, 호스트 페이지 CSP, 활성화를 증명하지 않습니다.

표시 탭 에이전트 테마의 사이트 설정 사용은 호스트 페이지와 임베드에서 방문자의 라이트/다크 모드를 따릅니다. 라이트 또는 다크를 고정하면 채팅과 실시간 통화가 고정됩니다. Look을 참고하세요.

실시간 통화 테스트하기#

요금제에 사용하지 않은 실시간 시간이 있고 사이트에 접근할 수 있으며 실시간 제공자 키가 검증되는지 확인합니다. 짧은 통화로 시작해 에이전트를 중간에 끊어 보고, 미러링이 켜졌을 때만 언어를 전환하며, 설정된 통화 제한이 테스트 세션 하나를 끝내도록 확인합니다. 에이전트 페이지 캔버스만이 아니라 실제 임베드에서도 한 통화를 반복하세요.

실시간 시간은 일반 크레딧과 별도의 월 권한입니다. 실시간 토큰이 발급되면 서버가 승인한 최대 시간만큼 크레딧이 청구되고 그 시간이 월 실시간 허용량에서도 보류됩니다. 미디어는 브라우저와 제공업체 사이에서 직접 흐르므로 클라이언트가 보고한 더 짧은 통화 시간을 검증할 수 없고, 토큰 전달 후 사용하지 않은 시간은 부분 환불되지 않습니다. 서버 측 토큰 발급 실패는 청구를 해제하지만 중단된 세션은 승인된 한도만큼 청구됩니다. 테스트를 정상 종료하고 설정한 통화 한도로 사용량을 예측하세요. 크레딧 및 사용량도 참고하세요.

실시간 음성 작업#

에이전트 → 액션 → 실시간 통화 작업(실시간 통화 중 에이전트 작업 허용)에서 모든 언어에서 Gemini 3.8 Live로 진행되는 실시간 통화의 도구 사용을 제어합니다. voice.liveActions는 기본 켜짐이며 끄면 지식 조회만 유지됩니다. 실시간 음성 요금제, 제공업체 및 접근 조건은 계속 적용됩니다.

통화 중 조회 결과, 선택지, 변경 제안, 캘린더 시간·예약, 감시 알림과 사람 연결을 표시할 수 있습니다. 업무 변경·예약·감시는 화면의 카드 버튼으로 확인해야 하며 말이나 채팅의 “네”로 쓰기를 승인할 수 없습니다. 감시는 화면에서 이메일 동의도 받아야 합니다. 카드와 도구 결과는 대화 기록에 남습니다. 페이지 작업과 자체 MCP 도구는 실시간 음성에 포함되지 않습니다. 통화 요금은 사전 예약 방식이며 토큰 전달 후 남은 시간은 환불되지 않습니다.

고객 제공 전 음성 결과와 화면 확인을 함께 검증하세요. 후속 알림과 변경 작업을 참고하세요.

고지 및 안전#

통화자에게 AI 및 합성 음성과 상호작용한다는 사실을 알리세요. 녹음, 전사, 외부 제공자 데이터의 보존 및 삭제 방법을 정하세요.

문제 해결#

증상확인 사항
텍스트는 되지만 음성 컨트롤 실패전사/TTS/실시간 제공자 키, 기능 토글, 요금제, 크레딧, 브라우저 권한
녹음 시작 불가HTTPS, 마이크 권한, 입력 장치, 임베드 Permissions Policy, 브라우저 지원
전사가 부정확오디오 품질, 선택 언어 집합, 억양/용어, 전사 제공자 지원
음성 답변이 이상함선택 음성, 원본 텍스트, 문장 부호, 언어 레이블, 제공자 가용성
실시간 통화가 즉시 종료남은 시간, 통화당 제한, 제공자 키, 네트워크, 동시 세션 상태

음성을 별도의 출시 화면으로 취급하세요. 텍스트 승인 테스트만으로는 충분하지 않습니다.

음성 라우팅과 대체 음성#

음성 모델에서 전사, 음성 합성, 실시간 통화에 사용할 모델을 선택하세요. 각 항목에는 모델과 제공자가 표시되며, 자동을 선택하면 저희가 결정해요. 호스팅과 라우팅은 Make Agent Fast가 관리하므로 별도 플랫폼 선택은 없어요. 모델에 따라 기본 음성이 달라질 수 있어요.

음성 서비스를 사용할 수 없으면 사용 가능한 대체 서비스를 이용할 수 있어요. 음성 생성이 실패해도 텍스트는 표시돼요.

실시간 통화는 선택한 실시간 제공자의 기본 음성을 스트리밍합니다. 지식 검색, 언어 규칙, 끼어들기, 통화 시간 한도와 선결제 비용은 유지됩니다. 통화 답변에 별도 TTS 요청을 보내지 않습니다.