> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 첫 번째 음성 에이전트 구축

> 에이전트 빌더의 전체 과정: 프롬프트, 엔진, 음성 및 언어, 도구 및 지식, 대화, 배포.

에이전트에 관한 모든 것은 **음성 에이전트**
(`/dashboard/agents`)의 빌더에서 관리합니다. 에이전트를 만들면 바로 이 화면으로 이동합니다. 이 가이드는 앱 내 "에이전트 구축" 투어와 동일한 경로를 안내합니다.

<Tip>
  처음이신가요? [대시보드 빠른 시작](/ko/quickstart-dashboard)에서는
  이 페이지의 내용과 청구, 번호, 시뮬레이션을 5단계 설정 마법사로
  안내합니다.
</Tip>

## 1. 프롬프트 작성

프롬프트는 음성 에이전트의 스크립트입니다. 어떤 언어로든 에이전트가 누구인지와 통화를 어떻게 처리해야 하는지 설명합니다. 에이전트의 페르소나, 알고 있는 내용, 해야 할 일과 하지 말아야 할 일을 포함합니다.

통화 작업도 프롬프트로 지정합니다. 전달, 키패드 입력, 통화 종료는 \*"발신자가 사람을 요청하면 통화를 +1 555…로 전달합니다"\*와 같은 일반 프롬프트 줄로 작성하면 되며, 별도 구성은 필요하지 않습니다.

<Tip>
  구체적인 지시가 일반적인 지시보다 효과적입니다. "변경하기 전에 주문 번호를 발신자에게 다시 확인합니다"는 "주문을 신중하게 처리합니다"보다 더 효과적입니다.
</Tip>

## 2. 엔진 선택

**구성** 탭의 엔진 선택기는 세 가지 등급에서 비용과 성능의 균형을 제공합니다. **Spark**는 비용에, **Bolt**는 속도에, **Storm**은 복잡한 프롬프트에서의 지능에 최적화되어 있습니다.
각 카드에 분당 가격이 표시됩니다. 언제든지 전환할 수 있으며,
[전체 등급 비교](/api-reference/agents#product-tiers-at-a-glance)를 확인할 수 있습니다.

## 3. 음성과 언어 선택

음성을 선택하고 빌더에서 바로 샘플을 재생합니다. 통화가 시작될 때 사용할
**기본 언어**와 **추가 언어**를 설정합니다. 발신자가 추가 언어 중 하나를 사용하면 에이전트가 자동으로 전환합니다.
음성 목록은 선택한 모든 언어를 지원하는 음성으로 필터링됩니다. 전체 카탈로그는
[지원 언어](/ko/guides/supported-languages)를 확인하세요(프리미엄 언어는 분당 2¢가 추가됩니다).

## 4. 도구와 지식 연결

구성 탭의 네 가지 섹션에서 에이전트에 기능을 추가할 수 있습니다.

* **연결된 앱** — 가장 쉬운 방법입니다.
  몇 번의 클릭으로 [Slack, HubSpot, Google 등 연결](/ko/guides/connect-apps)을
  설정한 다음, 에이전트가 통화 중에 사용하도록 합니다.
* **API 연결** — 다른 API의 경우,
  에이전트에 필요한 작업을 위한 [API 연결 생성](/ko/guides/api-connections)을
  설정합니다(cURL 명령을 붙여 넣으면 AI 마법사가 도구 초안을 작성합니다).
* **지식** — 에이전트가
  통화 중 검색할 수 있는 [지식 베이스](/ko/guides/knowledge-base)를
  연결합니다.
* **MCP 서버** — URL로 [MCP 서버 추가](/ko/guides/mcp-servers)를 설정합니다.

네 가지 유형의 차이점은 [연결](/ko/guides/concepts)을 확인하세요.

## 5. 총 분당 요금 확인

빌더에는 엔진과 추가 요금을 포함한 **총 분당 요금**이 표시되며, 설정을 변경하면 실시간으로 업데이트됩니다. 청구서에서 예상치 못한 요금이 발생하지 않습니다.

## 6. 대화하기

**대화하기**를 클릭하고 인사해 보세요. 에이전트가 브라우저에서 바로 응답합니다
(마이크 접근 권한을 요청합니다). 가장 빠른 반복 방식은 다음과 같습니다.
프롬프트를 조정하고, 대화하고, 반복합니다. 내 대신 다른 발신자가 통화 반대편에 있도록 하려면 [시뮬레이션 실행](/ko/guides/simulate-a-call)을 사용하세요.

## 7. 배포

모든 수정 사항은 **초안에 자동 저장**됩니다. 상단 표시줄에서 "저장됨"을 확인하세요.
초안 변경 사항은 **배포**를 클릭하기 전까지 적용되지 않습니다.

모든 배포는 **기록** 탭에 스냅샷으로 저장됩니다. 버전 간 변경 사항을 확인하고 이전 버전을 복원할 수 있습니다. 따라서 배포를 자주 수행해도 안전하며, 언제든지 롤백할 수 있습니다.

## 8. 외부에 연결

구성 탭의 **전화번호** 및 **웹 위젯** 섹션에서 빌더를 벗어나지 않고
엔드포인트를 연결할 수 있습니다. 기존 번호를 연결하거나, 새 데모 번호를 프로비저닝하거나, VoIP를 통해 가져오거나, 웹 위젯을 연결할 수 있습니다.

***

## 다음 단계

<CardGroup cols={2}>
  <Card title="전화번호 받기" icon="phone" href="/ko/guides/get-a-phone-number">
    몇 초 만에 데모 번호를 받거나 VoIP를 통해 자체 번호를 가져오세요.
  </Card>

  <Card title="통화 시뮬레이션" icon="flask" href="/ko/guides/simulate-a-call">
    AI 발신자가 에이전트와 실제 대화를 나눕니다.
  </Card>

  <Card title="통화 검토" icon="headset" href="/ko/guides/review-calls">
    대화 기록, 녹음, 실시간 청취 및 속삭임.
  </Card>

  <Card title="Agents API 참조" icon="code" href="/api-reference/agents">
    프로그래밍 방식으로 에이전트를 생성하고 관리하세요.
  </Card>
</CardGroup>