🎙️자연스러운 한국어 음성 에이전트(콜봇) 만들기 — Pipecat, 타입캐스트 연동

 

요즘 예약 전화를 받는 콜봇, 앱 속 음성 비서가 사람처럼 실시간으로 말을 주고받죠. 큰 인프라 없이도 이런 음성 AI 에이전트를 직접 만들고 도입하는 스타트업이 빠르게 늘고 있어요.

 

이런 음성 에이전트는 Pipecat 같은 오픈소스 도구로 만들 수 있어요. 오늘은 여기에 한국어 음성으로 타입캐스트를 붙여, 자연스럽게 응대하는 음성 에이전트를 만드는 법을 정리했어요.

 

 

API 무료로 시작하기 →

 

---

 

음성 에이전트, 요즘 이렇게 쓰입니다

음성 에이전트는 사람처럼 듣고 답하는 AI예요. 고객센터 상담, 예약·주문 접수, 안내 전화처럼 ‘말로 주고받는 일’을 대신합니다.

 

특히 효과적인 곳은 사람을 계속 두기 어려운 자리예요. 야간에도 문의는 들어오는데 상담 인력을 24시간 둘 수 없는 병원, 전화는 쏟아지는데 응대할 사람이 부족한 작은 쇼핑몰처럼요. 반복되는 문의를 음성 에이전트가 먼저 받아주면, 사람은 더 중요한 응대에 집중할 수 있죠

 

예를 들어 예약 변경 문의를 받는 음성 에이전트 는 이렇게 응대합니다.

 

Pipecat을 활용하면 이런 음성 에이전트를 쉽게 만들 수 있어요. 예약을 확인하고, 마감된 시간을 알고, 대안까지 자연스럽게 제시하죠. 어떻게 만드는지는 아래에서 자세히 살펴볼게요.

 

---

 

Pipecat이 뭔가요?

Pipecat은 방금 같은 음성 에이전트를 만드는 오픈소스 프레임워크예요. 음성 에이전트가 듣고, 생각하고, 말하는 세 단계 — 사용자의 말을 받아쓰는 STT(귀), 답을 만드는 LLM(머리), 그 답을 목소리로 내는 TTS(입) — 를 하나로 이어 붙여줍니다.

 

Pipecat을 활용하면 음성 에이전트를 처음부터 전부 직접 만들 필요가 없어요. 원하는 STT·LLM·TTS를 골라 끼우는 방식이라 적은 리소스로 빠르게 만들 수 있죠. 덕분에 리소스가 부족한 스타트업이나 작은 팀도 음성 응대를 만들어볼 수 있어요.

 

이 중 TTS는 에이전트의 목소리, 곧 사용자가 듣는 음성 경험과 직접 연결돼요. 에이전트가 어떤 목소리로 얼마나 자연스럽게 말하는지가 여기서 정해지죠. Pipecat에서는 40가지가 넘는 음성 서비스를 선택할 수 있는데요, 한국어 서비스라면 고르는 기준이 좀 달라집니다.

 

---

 

왜 한국어 음성 에이전트엔 타입캐스트인가요?

음성 에이전트는 목소리가 곧 서비스 경험이에요. 어떤 톤으로 말하는지, 대답 사이 어색한 침묵은 없는지, 우리 서비스에 어울리는 목소리인지 — 이 모든 게 사용자 경험을 좌우하죠. 대화형 음성 에이전트에 타입캐스트를 추천하는 이유는 세 가지예요.

 

 

---

 

Pipecat에 타입캐스트를 어떻게 연동하나요?

타입캐스트가 제공하는 Pipecat 플러그인을 연결하면, 한국어로 자연스럽게 응대하는 음성 에이전트를 쉽게 만들 수 있어요. 아래 네 단계면 됩니다.

 

STEP 1기본 파이프라인 준비하기

먼저 음성 에이전트의 기본 파이프라인을 만들어요. Pipecat 공식 퀵스타트의 예제를 따라 필요한 내용을 설치해주세요.

 

STEP 2타입캐스트 설치하고 API 키 연결하기

아래 명령어로 타입캐스트를 Pipecat에 이어주는 패키지를 설치해요.

pip install pipecat-ai-typecast

음성을 쓰는 데 필요한 타입캐스트 API 키는 콘솔에서 무료로 발급받아, 코드가 읽을 수 있게 TYPECAST_API_KEY로 저장합니다.

 

API 키 발급하기 →

 

STEP 3사용할 목소리 고르기

타입캐스트가 제공하는 500개가 넘는 목소리 중에서 에이전트가 쓸 목소리를 골라요. AI 목소리 목록에서 직접 들어보고, 원하는 목소리의 ID를 voice_id에 넣으면 됩니다.

from pipecat_typecast.tts import TypecastTTSService

tts = TypecastTTSService(
    aiohttp_session=session,
    api_key=os.getenv("TYPECAST_API_KEY"),
    voice_id="tc_672c5f5ce59fac2a48faeaee",
)

STEP 4파이프라인에 목소리 연결하기

STEP 1에서 만든 파이프라인의 TTS 자리를, 방금 준비한 타입캐스트 목소리(tts)로 연결해요.

pipeline = Pipeline([
    transport.input(),
    stt,    # 음성 → 텍스트
    llm,    # 답 생성
    tts,    # ← 타입캐스트 (텍스트 → 한국어 음성)
    transport.output(),
])

STT·LLM은 그대로 두고 목소리만 바꾸면, 한국어로 자연스럽게 응대하는 음성 에이전트가 완성됩니다.

 

API 무료로 시작하기 →

 

---