ThunderPhone v3가 출시되었습니다.셀프서비스로, 분당 2¢부터.출시 소식 보기

Using the dashboard

프롬프트 스타일 가이드

ThunderPhone 음성 에이전트의 프롬프트를 작성하고 편집하는 방법입니다. 가이드라인은 프롬프트 검토 검사를 안내하며, 검사 결과에서 참조하는 ID를 포함합니다.

이 가이드는 빌더에서, Copilot에서 또는 API를 통해 작업하는 코딩 에이전트로서 음성 에이전트의 프롬프트를 작성하거나 편집하는 모든 사용자를 위한 것입니다. 프롬프트 검토 도구는 이를 평가 기준으로 사용하며 가이드라인 ID(P1, W2 등)를 인용합니다.

발신자는 자연스러운 말 속도로 에이전트의 말을 한 번 듣고, 이전으로 스크롤할 수 없습니다. 에이전트는 매 대화 차례마다 프롬프트를 읽고 그 문구를 거의 그대로 따릅니다. 이 두 가지 사실이 아래의 모든 내용을 결정합니다.

구성

P1. 사람이 새 접수 담당자에게 브리핑하듯 작성합니다. 짧은 도입부에서 에이전트가 누구이며 어느 조직을 위해 일하는지 설명합니다. 이후 통화는 실제 진행 순서를 따릅니다. 즉, 어떻게 시작하는지, 무엇을 확인해야 하는지, 무엇을 확인받아야 하는지, 어떻게 마무리하는지 순서입니다. 각 규칙은 적용되는 통화 단계에 배치합니다. 독자는 모든 단락을 보고 "이 업체를 운영하는 사람이 직접 입력했을까?"라고 물을 수 있어야 합니다. 확인할 내용에는 발신자가 누구이고 어떻게 연락할 수 있는지만이 아니라, 업체가 요청을 처리하기 위해 필요한 정보도 포함됩니다.

P2. 간결한 제목, 그 아래에 본문을 작성하세요. "당신은 누구인가", "통화", "사실", "인계"와 같은 제목이 도움이 됩니다. 번호가 매겨진 규칙 매뉴얼, camelCase 또는 코드 같은 제목, 긴 대시 글머리표 규칙 목록, 앞부분의 도구 참조, "아래 4절 참조" 같은 상호 참조처럼 기계적인 구조는 도움이 되지 않습니다. 에이전트가 조회하는 데이터(영업시간, 가격, 주소)에는 목록을 사용해도 됩니다.

P3. 말하는 방식은 한 번만, 간단히 설명합니다. 통화 전체에서 에이전트가 말하는 방식(짧은 1인칭 발화, 따뜻하고 쉬운 표현, S2 참조)은 상단의 짧은 단락 하나에 담습니다. 특정 단계에만 해당하는 내용은 해당 단계에 배치합니다.

P4. 사실과 행동을 분리하세요. 영업시간, 가격, 위치, 정책 및 기타 사실은 통화 흐름 전체에 흩어 놓지 말고 프롬프트의 사실 섹션이나 지식 베이스에 넣습니다. 긴 카탈로그와 FAQ는 지식 베이스에 넣습니다. 에이전트는 제공받은 사실만 말할 수 있습니다.

콘텐츠

C1. 대본이 아니라 원칙과 사실을 작성합니다. 에이전트가 달성하려는 목표와 알아야 하는 내용을 설명합니다. "발신자가 X라고 말하면 Y라고 말합니다"와 같은 분기, 예상 질문에 대한 대본식 답변, 정형화된 문구는 제외합니다. 구성된 시작 인사만 대본으로 작성하는 요소입니다.

C2. 수정은 일반 원칙을 명시합니다. 프롬프트 변경이 관찰된 실패에 대응하는 경우, 그 변경은 일반 원칙이나 누락된 사실을 추가하며 해당 한 사례를 위한 임시방편을 추가하지 않습니다. 실패한 통화의 구체적인 내용(이름, 번호, 정확한 표현)은 프롬프트에 포함하지 않습니다.

C3. 추가보다 제거를 우선합니다. 실패 원인이 지나치게 구체적이거나 광범위하거나 잘못 배치된 기존 규칙에 있는 경우, 그 옆에 반대 규칙을 추가하기보다 해당 규칙을 변경하거나 제거합니다.

C4. 일부 사항은 프롬프트가 아니라 설정으로 결정합니다. 다음은 에이전트 설정이며, 이에 관한 프롬프트 텍스트는 무시되거나 설정과 충돌합니다. 도구 실행 중 말하는 내용(도구 시작 문구, 채우기 문구), 침묵 중 확인 안내와 침묵 후 최종 작업, 다시 읽기의 속도, 언어 전환 방식, 녹음 안내, 에이전트와 발신자 중 누가 먼저 말하는지입니다. 프롬프트는 결과를 지시하도록 작성하고("저장하기 전에 이메일 주소를 확인합니다"), 설정을 구성합니다. 시작 인사 자체는 프롬프트에 작성합니다.

C5. 예시는 에이전트가 말할 문장입니다. 에이전트는 예시 문구를 거의 그대로 따라 하므로, 모든 예시는 완전하고 자연스러운 구어 문장이어야 하며 하나보다 다양한 예시 몇 개가 더 효과적입니다. 이를 필수 문구가 아니라 예시로 소개합니다("예를 들어, 다음과 같이 말할 수 있습니다..."). "여전히 정확한가요?"와 같은 짧게 끊긴 문구는 실제로 말하면 간결하게 들립니다.

C6. 자체 고객 통화의 예시를 사용하지 않습니다. 예시는 일반적인 상황을 설명하거나 가상의 사업체를 사용합니다.

C7. 프롬프트는 구축에 관한 내용이 아니라 발신자를 위한 것입니다. 프롬프트가 배포되면 발신자는 그 내용을 그대로 듣게 되므로, 구축, 테스트 또는 규정 준수 상태에 관한 메모("이 버전은 테스트용입니다", 예약 이름의 "TEST", "계약이 체결될 때까지")는 포함하지 않습니다. 또한 요금제를 수락해도 무엇이 성립하지 않는지 또는 아직 확인되지 않은 사항의 요약처럼, 비즈니스가 요청하지 않은 면책 조항, 책임 제한 고지 및 마무리 요약도 포함하지 않습니다. 에이전트는 발신자가 요청한 내용에 답하고 종료하며, 비즈니스는 필요할 때 주의 사항을 추가합니다. 누락된 사실이나 시스템 제한은 제공되지 않았다는 메모나 요청 기록 방식에 관한 설명이 아니라 에이전트의 행동으로 작성합니다("가격은 사무실에서 다시 연락드리도록 안내합니다"). 또한 초안 작성 과정에서 남은 이름이나 제목 같은 내용도 남기지 않습니다.

표현

W1. 수행할 작업을 한 번만 명확하게 말합니다. 원하는 동작을 일상적인 표현의 지시로 작성합니다. "발신자가 수정할 수 있도록 주문 번호를 한 자리씩 다시 읽어 주세요." 적용되는 위치에 한 번만 작성합니다.

W2. 강조하지 않습니다. 중요, 참고, 위험 같은 레이블, 강도를 위해 사용하는 대문자 단어, 느낌표, "나쁜 예:"와 "좋은 예:" 쌍, 하지 말아야 할 일을 모아 둔 블록을 사용하지 않습니다. 강도를 위해 사용하는 "절대", "항상", "반드시" 같은 단어도 여기에 해당합니다. 강조는 모델의 주의를 하나의 규칙으로 끌어가 통화의 나머지 부분을 처리하는 능력을 떨어뜨립니다. 에이전트가 지시를 무시하면 지시를 더 크게 표현하지 말고 더 명확하고 구체적으로 작성하거나 더 적절한 위치에 배치합니다.

W3. 동작을 유발하는 구조를 수정합니다. 에이전트가 하는 어떤 행동을 금지하는 규칙을 추가하기 전에, 그 행동으로 이어지는 표현이나 구조를 찾습니다. 모델이 문자 그대로 채우는 템플릿, 두 가지 의미를 가진 용어, 빠른 모델이 느슨하게 읽는 if-else 분기가 원인일 수 있습니다. 이를 변경합니다.

W4. 일반적인 표현보다 구체적인 표현이 낫습니다. "가장 이른 빈 시간 두 개를 제안한 다음 어느 시간이 적합한지 묻습니다"는 "일정 조정을 지원합니다"보다 낫습니다. 모호한 지시는 모호한 동작을 만듭니다.

W5. 질문하기 전에 조회합니다. 발신자가 읽기 전용 조회 도구로 확인할 수 있는 항목(제품, 주문, 기존 예약)을 언급하면, 에이전트는 발신자가 제공한 표현으로 조회한 후 결과에 추가 질문이 필요한 경우에만 후속 질문을 합니다. "발신자가 언급한 제품의 재고를 확인하고 찾은 내용을 알려 주세요"가 "브랜드, 크기, 옵션을 확인한 후 재고를 조회하세요"보다 낫습니다. 먼저 확인하라는 지시를 받은 에이전트는 계속 질문하게 되어 조회가 실행되지 않습니다. 이는 조회에만 적용됩니다. 예약, 변경, 취소 또는 저장을 수행하는 도구를 사용하기 전에는 에이전트가 여전히 발신자와 세부 정보를 확인합니다.

음성

S1. 한 차례에 질문은 하나만 하고, 질문으로 차례를 마칩니다. 질문 뒤에 말하는 내용은 발신자의 답변 위로 겹쳐집니다. 설명이 필요하면 질문 전에 둡니다.

S2. 짧은 턴으로, 완전한 구어 문장으로 말합니다. 발신자가 자세한 내용을 요청하지 않는 한 짧은 문장 한두 개로 말합니다. 말로 제시하는 선택지는 몇 가지로 제한합니다. 짧다는 것은 말을 잘라 한다는 뜻이 아니라 단어 수가 적다는 뜻입니다. 에이전트는 전화로 응대하는 유능한 접수 담당자처럼 1인칭 완전한 문장으로 말합니다. 예: "지금 예약해 드리겠습니다." 또는 "월요일 열 시로 예약해 두었습니다." 메모식 단편("예약해 드립니다.", "완료.", "기록함.")은 소리 내어 말하면 무뚝뚝하게 들리고, 이메일식 표현("참고해 주세요 ...", "부디 ...", "도움이 되었기를 바랍니다")은 말하는 것보다 읽어 주는 것처럼 들립니다. 프롬프트의 말하는 방식 단락에는 이를 명확히 요청합니다. 예: "각 턴은 한두 문장으로 유지하고, 전화로 응대하는 접수 담당자처럼 1인칭으로 말하세요."

S3. 귀로 듣기 좋게 작성합니다. 에이전트가 말하는 내용에는 음성이 어색하게 읽을 수 있는 마크다운, 기호, 표기법(슬래시, 앰퍼샌드, "@", ".com", 천 단위 구분 기호, 공백 없는 전화번호)을 사용하지 않습니다. 이메일 주소나 계정 번호처럼 에이전트가 도구에 전달하는 사실과 값은 정확한 표기 형태를 유지합니다. 이 내용을 소리 내어 말해야 하는 경우에는 다시 작성하지 말고 옆에 발음 방법을 추가합니다. 흔하지 않은 이름이나 약어의 발음은 풀어서 작성하고, 새 용어는 유지하기 전에 에이전트 음성으로 들어 봅니다.

S4. 잘못 처리하면 비용이 큰 내용은 확인합니다. 숫자, 이메일, 주소, 코드는 제공받은 형식 그대로 한 번 다시 읽습니다. 발신자가 제공한 직후, 다음 질문 전에 답변에서 다시 읽으며, 한 번에 하나의 값만 확인합니다. 기본적으로 이름은 들은 대로 받아들이며 다시 읽지 않습니다. 이름이 낯설거나 불분명한 경우에만 철자를 한 번 묻습니다. 기록 대조 또는 해당 이름으로 예약을 처리하는 등 사업체에서 정확한 이름이 필요한 경우에는 프롬프트에 이를 명시하고 에이전트가 이름의 철자를 다시 말합니다. 다시 읽기는 값을 수정할 기회이지 통과 관문이 아닙니다. 발신자가 수정하지 않고 다음 정보를 답하거나 계속 진행하면 해당 값을 승인한 것이며, 승인된 값은 다시 묻지 않습니다. 사업체에서 다시 전화하거나 문자 메시지를 보낼 전화번호는 예외입니다. 이 번호를 다시 읽은 뒤에는 턴을 끝내고 발신자의 답변을 기다립니다. 한 자리씩 읽도록 요청하는 프롬프트는 그렇게 읽을 값(전화번호, 코드)만 지정합니다. 번지수, 가격, 시간 또는 날짜는 사람들이 일반적으로 말하는 방식으로 말합니다. 프롬프트는 확인할 내용을 지정하고, 플랫폼은 다시 읽기의 속도를 조절합니다.

반복 개선

I1. 변경 사항을 유지하기 전에 테스트합니다. 수정한 초안에서 에이전트의 개발 세트를 재생하고 현재 버전과 비교합니다. 변경으로 어떤 예시가 수정되었고 어떤 예시가 깨졌는지 확인합니다. 발신자가 듣는 방식으로 응답을 읽습니다. 발신자가 알아차릴 수 있는 모든 것은 세부 사항이 아니라 문제입니다.

I2. 홀드아웃 세트는 한 번만 확인합니다. 개발 세트에서만 조정합니다. 변경 사항이 준비되면 테스트 세트를 실행하고 결과를 있는 그대로 보고합니다. 테스트 결과를 확인한 후 변경했다면 새로운 테스트 예시가 필요합니다.

I3. 임시 수정이 쌓이면 리팩터링합니다. 작은 수정이 많이 누적된 프롬프트는 P1에서 벗어납니다. 규칙이 반복되거나 충돌하거나, 적용되는 단계와 멀리 떨어져 있게 됩니다. 이 경우 요청한 모든 동작을 유지하면서 다음 구조로 다시 작성합니다. 각 동작을 유지됨, 병합됨, 문구 변경됨 또는 제거됨으로 나열하고, 아무것도 알리지 않고 제거하지 않습니다. 전후로 개발 세트를 재생합니다. 리팩터링은 동작이 아니라 문구를 변경해야 합니다.

I4. 프롬프트보다 먼저 구성을 확인합니다. 일부 실패는 프롬프트 문제가 아닙니다. 철자 단위로 말한 글자를 잘못 듣는 것은 음성 인식 한계일 수 있습니다(Plus 음성 인식을 사용해 보세요). 응답이 느린 경우에는 지능 또는 음성 인식 티어, 혹은 발화 종료 감지 설정이 원인일 수 있습니다. 텍스트를 다시 작성하기 전에 구성 문제를 먼저 배제합니다.