Skip to main content
프롬프트는 음성 에이전트의 품질을 결정하는 핵심 요소입니다. 구조화된 프롬프트를 작성하면 에이전트가 일관되게 동작하고, 예외 상황에서도 안정적으로 응대할 수 있습니다.
vox CLI를 연동하면 Claude Code, Codex 같은 코딩 에이전트가 프롬프트 작성 가이드를 참고해 대화만으로 프롬프트를 만들고 다듬어 줍니다.

프롬프트 구조

음성 에이전트의 프롬프트는 12개 섹션으로 구성됩니다. 각 섹션이 명확한 역할을 가지므로, 수정이 필요할 때 해당 섹션만 변경하면 됩니다.

음성 프롬프트 핵심 규칙

음성 에이전트 프롬프트는 텍스트 기반 AI와 다릅니다. 다음 규칙을 반드시 지키세요.
  • 한 턴에 한 질문만 — 여러 질문을 동시에 하면 사용자가 혼란스러워합니다.
  • 짧은 문장 — 한 문장에 한 가지 사실만 담으세요. TTS가 긴 문장을 부자연스럽게 읽습니다.
  • 메타 발화 금지 — 프롬프트, 정책, 도구, 내부 처리 과정을 사용자에게 언급하지 마세요.
  • 도구 결과 추측 금지 — 도구를 호출하기 전에 결과를 미리 말하지 마세요.
  • 되돌릴 수 없는 행동은 확인 후 실행 — 예약 확정, 결제, 취소 등은 반드시 사용자 동의를 받으세요.
  • 이모지/특수문자 금지 — TTS 품질에 악영향을 줍니다. 표준 문장부호(., ,, ?, !)만 사용하세요.

대화 흐름 설계

대화 흐름은 에이전트가 따라야 할 순서를 정의합니다. 각 단계를 자연스럽게 나열하면, 턴테이킹 규칙(“한 턴에 한 질문”)에 따라 에이전트가 단계별로 진행합니다.
에이전트가 여러 단계를 한꺼번에 진행하는 경우, 턴테이킹 섹션의 “한 턴에 한 질문” 규칙이 제대로 적용되고 있는지 확인하세요. 각 단계의 지시를 더 명확하고 구체적으로 작성하면 에이전트가 단계별로 진행합니다.

변수 활용

vox.ai에서는 통화 시작 전에 동적 변수를 주입해 에이전트를 개인화할 수 있습니다.
  • {{변수}} — 프롬프트 본문에서 실제 값으로 치환되는 변수 표기입니다.
  • {변수} — 규칙이나 설명 문장에서 변수 이름을 가리킬 때만 사용할 수 있습니다. 실제 값으로 치환되지는 않습니다.
  • 빈 값 폴백 — 변수가 비어있거나 주입에 실패한 경우를 대비해 대체 표현을 지정합니다.
변수 값이 빈 문자열("")이거나 {{customer_name}}처럼 괄호가 그대로 보이면 주입 실패로 간주하고 폴백 규칙을 적용하세요.

발음 제어

음성 에이전트가 전화번호, 이메일, 코드 등을 정확하게 발음하려면 프롬프트에 발음 규칙을 명시해야 합니다. 자세한 내용은 발음 가이드를 참고하세요.

전화번호

이메일

날짜/시간

금액

코드/ID

예시 프롬프트

아래는 온라인 쇼핑몰 고객 상담 에이전트의 전체 프롬프트 예시입니다. 12개 섹션 구조를 그대로 따릅니다.

마무리

프롬프트는 한 번에 완성되지 않습니다. 실제 통화를 테스트하면서 에이전트가 기대와 다르게 동작하는 부분을 찾고, 해당 섹션을 반복적으로 수정하세요. 특히 턴테이킹, 도구 실패 처리, 가드레일은 실전에서 문제가 자주 발생하는 영역이므로 집중적으로 점검하는 것이 좋습니다.
프롬프트 작성, prompt writing, 시스템 프롬프트, system prompt, 프롬프트 구조, 프롬프트 템플릿, 대화 흐름, 가드레일, 턴테이킹