vox.ai에서 음성 에이전트를 만드는 방법은 두 가지입니다. vox CLI와 코딩 에이전트로 대화하며 만들거나, 대시보드에서 직접 빌드할 수 있습니다.
vox CLI를 설치하면 Claude Code, Codex 같은 코딩 에이전트가 대화만으로 에이전트를 만들고 관리합니다. 에이전트 정의가 파일로 남아 리뷰하고 롤백할 수 있습니다.
vox CLI 설치와 프로젝트 생성
CLI를 설치하고 로그인한 뒤, 작업할 디렉토리에서 프로젝트를 만드세요. npm install -g @vox-ai/cli vox auth login vox init --agent main --type flow
vox init은 Claude Code와 Codex가 자동으로 인식하는 스킬 파일을 프로젝트에 만듭니다.
에이전트 생성
같은 프로젝트에서 코딩 에이전트를 열고 자연어로 에이전트를 만드세요: 고객 상담 에이전트를 만들어줘. 회사 이름은 "ABC 쇼핑몰"이고, 주문 조회와 반품 접수를 처리할 수 있어야 해.
AI가 vox.ai에 에이전트를 자동으로 생성합니다. 생성 후 대화로 바로 수정할 수 있습니다: 방금 만든 에이전트에 인사말을 추가해줘. "안녕하세요, ABC 쇼핑몰입니다. 무엇을 도와드릴까요?"로 시작하게 해줘.
테스트 통화
에이전트가 준비되면 바로 테스트 통화를 실행하세요: 방금 만든 에이전트로 010-1234-5678에 테스트 전화 걸어줘.
또는 vox.ai 대시보드 에서 에이전트를 선택하고 테스트 버튼을 클릭하세요. vox.ai 대시보드에서 직접 에이전트를 빌드하고 테스트할 수 있습니다.
에이전트 생성
대시보드에서 새 에이전트 를 클릭하고 생성 마법사에서 프롬프트 에이전트 를 선택하세요. 이름, 첫 메시지 등 기본 정보를 입력하면 편집 화면으로 이동합니다. 프롬프트 에이전트 는 단일 프롬프트로 동작하며 빠르게 시작하기에 적합합니다. 복잡한 분기가 필요하면 나중에 플로우 에이전트 로 전환할 수 있습니다.
프롬프트 작성
편집 화면의 프롬프트 영역에서 에이전트의 역할, 규칙, 처리할 업무를 정의하세요. 당신은 ABC 쇼핑몰의 고객 상담 에이전트입니다. ## 역할 고객의 문의에 친절하고 정확하게 응대합니다. ## 처리 가능한 업무 - 주문 상태 확인 - 반품/교환 접수 - 배송 일정 안내 - 자주 묻는 질문 응대 ## 규칙 - 항상 존댓말을 사용합니다. - 답변은 간결하게 2-3문장으로 제공합니다. - 처리할 수 없는 문의는 담당자 연결을 안내합니다. - 개인정보(카드번호, 비밀번호)는 절대 요청하지 않습니다.
기본 설정
설정 영역에서 에이전트의 기본 동작을 구성하세요:
음성 끼어들기 감지 — 사용자가 말하는 중에 에이전트가 멈추는 민감도 조절 높은 품질의 음성과 모델은 응답 시간이 길어질 수 있습니다. 용도에 따라 품질과 속도의 균형을 맞추세요.
지식 베이스 추가
지식 베이스 영역에서 에이전트에 도메인 지식을 제공하세요.
URL — 웹 페이지, 도움말 문서파일 — PDF, Word, 텍스트 파일직접 입력 — FAQ, 정책 문서 등
에이전트 테스트
테스트 영역에서 에이전트와 대화해 보세요. 고객 입장에서 질문을 던지고, 프롬프트를 조정하면서 원하는 품질이 나올 때까지 반복하세요.
통화 후 분석 설정 에이전트의 대화 품질을 자동으로 분석하거나 필요한 값을 추출하려면 통화 후 분석 기준을 설정하세요.
평가 기준 추가
통화 후 분석 설정에서 대화 성공 기준을 정의하세요. 예시 — 고객_문의_해결: 에이전트가 고객의 문의를 성공적으로 해결했거나, 적절한 담당자에게 연결했는지 판단하세요. 성공 기준: - 고객의 질문에 정확한 답변을 제공함 - 또는 적절한 부서로 연결을 안내함
모든 통화 스크립트가 LLM에 전달되어 성공, 실패, 판단 불가 중 하나로 평가됩니다.
통화 기록 확인
통화 기록 통화 기록을 정기적으로 검토하면 자주 발생하는 문제를 파악하고 에이전트를 개선할 수 있습니다.
다음 단계 에이전트를 프로덕션에 배포하려면:
도움이 필요하면
vox.ai 디스코드 커뮤니티 궁금한 점이나 막히는 부분이 있다면 디스코드에서 직접 물어보세요. 다른 사용자의 사례와 vox 팀의 빠른 답변을 받을 수 있어요.
빠른 시작, quickstart, 시작 가이드, 첫 에이전트, 에이전트 만들기, 에이전트 생성, 튜토리얼, getting started, 온보딩
