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

# 빠른 시작

> 5분 안에 첫 음성 에이전트를 만들어 보세요.

vox.ai에서 음성 에이전트를 만드는 방법은 두 가지입니다. vox CLI와 코딩 에이전트로 대화하며 만들거나, 대시보드에서 직접 빌드할 수 있습니다.

<Tabs>
  <Tab title="코딩 에이전트로 시작">
    vox CLI를 설치하면 Claude Code, Codex 같은 코딩 에이전트가 대화만으로 에이전트를 만들고 관리합니다. 에이전트 정의가 파일로 남아 리뷰하고 롤백할 수 있습니다.

    <Steps>
      <Step title="vox CLI 설치와 프로젝트 생성">
        CLI를 설치하고 로그인한 뒤, 작업할 디렉토리에서 프로젝트를 만드세요.

        ```bash theme={null}
        npm install -g @vox-ai/cli
        vox auth login
        vox init --agent main --type flow
        ```

        `vox init`은 Claude Code와 Codex가 자동으로 인식하는 스킬 파일을 프로젝트에 만듭니다.

        <Tip>
          Homebrew 설치와 클라이언트별 연결 방법은 [Claude Code·Codex에서 CLI 설치](/docs/ai/clients)에서 확인하세요.
        </Tip>
      </Step>

      <Step title="에이전트 생성">
        같은 프로젝트에서 코딩 에이전트를 열고 자연어로 에이전트를 만드세요:

        ```plaintext theme={null}
        고객 상담 에이전트를 만들어줘.
        회사 이름은 "ABC 쇼핑몰"이고,
        주문 조회와 반품 접수를 처리할 수 있어야 해.
        ```

        AI가 vox.ai에 에이전트를 자동으로 생성합니다. 생성 후 대화로 바로 수정할 수 있습니다:

        ```plaintext theme={null}
        방금 만든 에이전트에 인사말을 추가해줘.
        "안녕하세요, ABC 쇼핑몰입니다. 무엇을 도와드릴까요?"로 시작하게 해줘.
        ```
      </Step>

      <Step title="테스트 통화">
        에이전트가 준비되면 바로 테스트 통화를 실행하세요:

        ```plaintext theme={null}
        방금 만든 에이전트로 010-1234-5678에 테스트 전화 걸어줘.
        ```

        또는 [vox.ai 대시보드](https://www.tryvox.co/dashboard/)에서 에이전트를 선택하고 **테스트** 버튼을 클릭하세요.
      </Step>
    </Steps>
  </Tab>

  <Tab title="대시보드에서 시작">
    vox.ai 대시보드에서 직접 에이전트를 빌드하고 테스트할 수 있습니다.

    <Steps>
      <Step title="vox.ai 로그인">
        [vox.ai 대시보드](https://www.tryvox.co/dashboard/)에 로그인하세요. 계정이 없으면 새로 만드세요.
      </Step>

      <Step title="에이전트 생성">
        대시보드에서 **새 에이전트**를 클릭하고 생성 마법사에서 **프롬프트 에이전트**를 선택하세요. 이름, 첫 메시지 등 기본 정보를 입력하면 편집 화면으로 이동합니다.

        <Info>
          **프롬프트 에이전트**는 단일 프롬프트로 동작하며 빠르게 시작하기에 적합합니다. 복잡한 분기가 필요하면 나중에 [플로우 에이전트](/docs/build/flow/overview)로 전환할 수 있습니다.
        </Info>
      </Step>

      <Step title="프롬프트 작성">
        편집 화면의 프롬프트 영역에서 에이전트의 역할, 규칙, 처리할 업무를 정의하세요.

        ```plaintext 시스템 프롬프트 theme={null}
        당신은 ABC 쇼핑몰의 고객 상담 에이전트입니다.

        ## 역할
        고객의 문의에 친절하고 정확하게 응대합니다.

        ## 처리 가능한 업무
        - 주문 상태 확인
        - 반품/교환 접수
        - 배송 일정 안내
        - 자주 묻는 질문 응대

        ## 규칙
        - 항상 존댓말을 사용합니다.
        - 답변은 간결하게 2-3문장으로 제공합니다.
        - 처리할 수 없는 문의는 담당자 연결을 안내합니다.
        - 개인정보(카드번호, 비밀번호)는 절대 요청하지 않습니다.
        ```

        <Tip>
          프롬프트 작성 가이드는 [시스템 프롬프트 작성](/docs/build/single-prompt/prompt-writing)에서 자세히 확인하세요.
        </Tip>
      </Step>

      <Step title="기본 설정">
        설정 영역에서 에이전트의 기본 동작을 구성하세요:

        * **[음성](/docs/build/voice/voice-select)** — 에이전트의 목소리를 선택
        * **끼어들기 감지** — 사용자가 말하는 중에 에이전트가 멈추는 민감도 조절

        <Note>
          높은 품질의 음성과 모델은 응답 시간이 길어질 수 있습니다. 용도에 따라 품질과 속도의 균형을 맞추세요.
        </Note>
      </Step>

      <Step title="지식 베이스 추가">
        지식 베이스 영역에서 에이전트에 도메인 지식을 제공하세요.

        * **URL** — 웹 페이지, 도움말 문서
        * **파일** — PDF, Word, 텍스트 파일
        * **직접 입력** — FAQ, 정책 문서 등
      </Step>

      <Step title="에이전트 테스트">
        테스트 영역에서 에이전트와 대화해 보세요. 고객 입장에서 질문을 던지고, 프롬프트를 조정하면서 원하는 품질이 나올 때까지 반복하세요.
      </Step>
    </Steps>

    ### 통화 후 분석 설정

    에이전트의 대화 품질을 자동으로 분석하거나 필요한 값을 추출하려면 통화 후 분석 기준을 설정하세요.

    <Steps>
      <Step title="평가 기준 추가">
        통화 후 분석 설정에서 대화 성공 기준을 정의하세요.

        예시 — `고객_문의_해결`:

        ```plaintext 평가 프롬프트 theme={null}
        에이전트가 고객의 문의를 성공적으로 해결했거나,
        적절한 담당자에게 연결했는지 판단하세요.

        성공 기준:
        - 고객의 질문에 정확한 답변을 제공함
        - 또는 적절한 부서로 연결을 안내함
        ```

        모든 통화 스크립트가 LLM에 전달되어 `성공`, `실패`, `판단 불가` 중 하나로 평가됩니다.
      </Step>

      <Step title="통화 기록 확인">
        **[통화 기록](/docs/operate/monitor/history)** 에서 각 통화의 녹음, 스크립트, 평가 결과를 확인하세요.

        <Tip>
          통화 기록을 정기적으로 검토하면 자주 발생하는 문제를 파악하고 에이전트를 개선할 수 있습니다.
        </Tip>
      </Step>
    </Steps>
  </Tab>
</Tabs>

## 다음 단계

에이전트를 프로덕션에 배포하려면:

* [지식 베이스](/docs/build/knowledge/overview)를 추가해 도메인 지식을 제공하세요.
* [도구](/docs/build/tools/overview)를 연결해 CRM, 주문 시스템 등 외부 API를 호출하세요.
* [전화번호를 연결](/docs/operate/deploy/phone-numbers)해 인바운드 통화를 받으세요.
* [플로우 에이전트](/docs/build/flow/overview)로 복잡한 상담 시나리오를 설계하세요.

## 도움이 필요하면

<Card title="vox.ai 디스코드 커뮤니티" icon="discord" iconType="brands" href="https://discord.gg/GKxHxG97u5">
  궁금한 점이나 막히는 부분이 있다면 디스코드에서 직접 물어보세요. 다른 사용자의 사례와 vox 팀의 빠른 답변을 받을 수 있어요.
</Card>

***

<Accordion title="연관 검색어">
  빠른 시작, quickstart, 시작 가이드, 첫 에이전트, 에이전트 만들기, 에이전트 생성, 튜토리얼, getting started, 온보딩
</Accordion>