Skip to main content
메뉴얼은 에이전트 편집 화면에서 만들고 프롬프트 옆 탭에서 씁니다. 제목, 언제, 본문 세 칸만 채우면 에이전트가 통화 중 그 절차를 따릅니다. 메뉴얼 탭 — 제목, 언제, 본문과 다른 메뉴얼 참조

메뉴얼 만들기

1

새 메뉴얼 열기

에이전트 편집 화면 설정 패널의 메뉴얼을 펼치고 새 메뉴얼을 누르세요. 새 메뉴얼이라는 이름으로 만들어지고 프롬프트 옆에 탭으로 열립니다.
2

제목과 트리거 쓰기

제목은 목록과 탭에서 메뉴얼을 알아보는 라벨입니다. 언제에는 이 절차를 꺼낼 대화 상황을 씁니다.
3

본문 쓰기

에이전트가 따를 절차를 씁니다. 빈 메뉴얼이면 템플릿이나 가지고 있는 문서로 초안을 채울 수 있습니다.
4

배포하기

편집 내용은 현재 편집본에 자동으로 저장됩니다. 실제 통화에 쓰려면 에이전트를 배포하세요.

트리거 쓰기

언제에는 이 메뉴얼을 꺼낼 대화 상황을 씁니다. 에이전트는 통화 중 대화와 트리거를 대조해 메뉴얼을 불러올지 판단합니다.
고객이 주문한 상품의 환불이나 교환을 요청할 때
  • 발화 상황 담기 — “환불 처리”처럼 업무 이름만 쓰지 말고 실제 대화 상황을 쓰세요. “고객이 환불을 요청하거나 결제 취소를 문의할 때”처럼 구체적일수록 정확하게 불러옵니다.
  • 다른 메뉴얼과 경계 나누기 — 같은 에이전트의 메뉴얼끼리 트리거가 겹치면 엉뚱한 절차를 불러올 수 있습니다.
  • 참조 전용이면 비워 두기 — 목록 카드에 시작 조건 없음으로 표시되고, 다른 메뉴얼이 참조할 때만 불러옵니다.

본문 쓰기

순서가 있는 절차는 번호 목록으로, 단계 안의 조건은 글머리표로 쓰세요. 본문에서 /를 누르면 제목과 단계 서식을 넣을 수 있습니다. 본문에서 / 를 누르면 열리는 메뉴 — 제목, 단계, 도구, 메뉴얼
에이전트는 지시를 해석해 상황에 맞게 말과 순서를 조절합니다. 매번 똑같은 실행을 강제해야 한다면 플로우 에이전트를 쓰세요.

도구와 다른 메뉴얼 참조하기

본문에서 /를 누르고 도구메뉴얼을 고르면 참조할 대상을 검색할 수 있습니다. @tool:이나 @manual:을 직접 입력해도 같은 목록이 열립니다. 고른 참조는 본문에 태그로 표시됩니다. 도구 참조 목록 — 빌트인 도구 종류와 워크스페이스의 API 도구 본문이 기준입니다. 메뉴얼이 쓰는 도구는 본문의 참조가 정합니다. 에이전트의 도구 목록에 따로 연결하지 않아도 됩니다. 상담사 연결처럼 여러 절차가 공유하는 단계는 트리거가 빈 메뉴얼로 따로 만드세요. 그다음 환불과 해지 메뉴얼 양쪽에서 참조합니다. 태그로 표시된 메뉴얼 참조를 누르면 그 메뉴얼이 탭으로 열립니다.

빌트인 도구 추가하기

통화 종료, 통화 전환, 에이전트 전환, SMS 발송, DTMF 전송, 주소 검색은 메뉴얼마다 따로 만듭니다. /에서 도구를 고른 뒤 빌트인 도구 종류를 고르면 설정 창이 열리고, 저장하면 본문에 참조가 들어갑니다. SMS 발송은 워크스페이스에 문자를 보낼 수 있는 번호가 있을 때만 목록에 나옵니다. 메뉴얼의 통화 전환 도구 설정 창 — 함수 이름, 설명, 전환 번호, 전환 타입 만든 빌트인 도구는 메뉴얼 탭 아래쪽에 배지로 모입니다. 배지를 누르면 설정을 고치고, 제거를 누르면 메뉴얼에서 뺍니다. 도구 이름을 바꾸면 본문의 참조도 함께 바뀝니다. 도구별 설정은 통화 종료, 통화 전환, 에이전트 전환 등 빌트인 도구 문서를 참고하세요.

템플릿이나 문서로 시작하기

새로 만든 메뉴얼처럼 내용이 빈 메뉴얼에는 본문 아래쪽에 초안을 채우는 버튼 세 개가 나옵니다. 빈 메뉴얼 — 마크다운 가져오기, 문서로 초안 만들기, 템플릿에서 시작 버튼
  • 템플릿에서 시작 — vox.ai가 준비한 템플릿을 골라 지금 메뉴얼에 채웁니다. 자주 쓰는 절차를 고쳐 쓸 때 고르세요.
  • 문서로 초안 만들기 — 업무 문서를 올리면 제목, 트리거, 본문 초안을 만들어 줍니다. .md, .txt 파일을 올릴 수 있습니다.
  • 마크다운 가져오기.md 파일 내용을 그대로 본문에 넣습니다. 이미 정리된 절차가 있을 때 고르세요.
템플릿에서 시작 창 — 영업시간 확인, 이메일 확인, 주소 검증 템플릿 초안은 열어서 다듬은 뒤 쓰세요. 내용이 이미 있는 메뉴얼에는 초안을 덮어쓰지 않습니다.

실행 대기음

메뉴얼을 불러온 직후 재생할 소리는 메뉴얼 탭 오른쪽 위의 메뉴얼 설정에서 고르세요. 대기음 종류와 동작은 실행 대기음과 같습니다. 메뉴얼 설정 — 실행 대기음 선택

메뉴얼 삭제하기

삭제할 메뉴얼의 탭을 열고 오른쪽 위 삭제 버튼을 누르세요. 다른 메뉴얼이 이 메뉴얼을 참조하고 있으면 확인 창에 참조하는 메뉴얼 수가 나옵니다. 삭제하면 그 참조가 끊어지므로 참조한 메뉴얼도 함께 고치세요.
삭제도 편집과 같이 현재 편집본에만 적용됩니다. 이미 배포한 버전의 메뉴얼은 다음 배포 전까지 그대로 통화에 쓰입니다.

제약 사항

문제가 생겼을 때

탭을 열고 탭 아래쪽에 표시된 항목을 고치세요. 제목이 없거나, 참조 형식이 올바르지 않거나, 만들지 않은 빌트인 도구를 참조하면 표시됩니다. 고치지 않으면 배포가 막힐 수 있습니다.
빈 메뉴얼에서 다시 시도하세요. 작성 중인 내용이 있으면 덮어쓰지 않도록 템플릿과 초안을 넣지 않습니다.
파일 크기와 형식을 확인하세요. 문서로 초안 만들기는 100,000자까지 읽습니다. 마크다운 가져오기는 본문 한도인 8,096자를 넘는 파일을 가져올 수 없습니다.

관련 문서


메뉴얼 작성, 매뉴얼 작성, 트리거, 본문, 도구 참조, 메뉴얼 체이닝, 하위 메뉴얼, 빌트인 도구, 템플릿, 문서로 초안, 마크다운 가져오기, 실행 대기음, manual, playbook