메뉴얼 작성

​

메뉴얼 만들기

​

트리거 쓰기

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

​

본문 쓰기

1. 주문번호를 물어봅니다.
2. 주문 조회 도구로 주문을 확인합니다.
   - 주문이 없으면 번호를 다시 확인합니다.
3. 환불 사유를 확인하고 접수를 안내합니다.

​

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

​

빌트인 도구 추가하기

​

템플릿이나 마크다운으로 시작하기

• 템플릿에서 시작: vox.ai가 준비한 템플릿을 골라 지금 메뉴얼에 채워요. 자주 쓰는 절차를 고쳐 쓸 때 고르세요.
• 마크다운 가져오기: .md 파일 내용을 그대로 본문에 넣어요. 이미 정리된 절차가 있을 때 고르세요.

​

실행 대기음 고르기

​

메뉴얼 삭제하기

​

API로 설정하기

• PATCH에 manuals를 넣으면: 맵 전체를 교체해요. 일부 항목만 보내면 빠진 항목이 제거돼요.
• manuals를 생략하면: 현재 맵을 유지해요.
• 개별 메뉴얼을 다룰 때: /agents/{agent_id}/manuals 하위 경로로 조회하고, 만들고, 고치고, 지우세요. 전역 /manuals 경로는 제공하지 않아요.

{
  "expected_head_revision": 12,
  "data": {
    "manuals": {
      "11111111-1111-4111-8111-111111111111": {
        "name": "환불 안내",
        "trigger": "고객이 환불이나 결제 취소를 요청할 때",
        "content": "환불 사유와 주문 정보를 확인합니다.",
        "built_in_tools": [],
        "config": { "tool_call_sound": "typing" }
      }
    }
  }
}

​

문제가 생겼을 때

​

관련 문서

• 메뉴얼 개요: 메뉴얼을 불러오는 방식과 관리 방법
• 에이전트 버전 관리: 메뉴얼을 포함한 설정을 배포하고 되돌리기
• API 도구: 메뉴얼에서 참조할 도구 만들기