메뉴얼 개요

메뉴얼은 에이전트가 통화 중 따르는 업무 절차 문서입니다. 프롬프트 에이전트 안에서 만들고 에이전트와 함께 배포합니다. 환불 접수, 본인 확인, 해지 방어처럼 업무가 많은 에이전트도 프롬프트 한 곳에 모든 절차를 쌓지 않고 운영할 수 있습니다.

​

방식 고르기

​

대화에 불러오는 방식

프롬프트 에이전트의 시스템 프롬프트는 매 턴 대화 컨텍스트에 통째로 들어갑니다. 절차가 쌓일수록 지금 대화와 무관한 내용까지 토큰을 쓰고 응답을 늦춥니다. 메뉴얼은 평소에 제목과 트리거만 대화에 올라가 있습니다. 대화가 트리거와 맞는 순간 본문을 불러오고, 그 통화가 끝날 때까지 유지합니다.

• 트리거가 있는 메뉴얼 — 대화 상황이 트리거와 맞으면 에이전트가 직접 불러옵니다.
• 트리거가 빈 메뉴얼 — 다른 메뉴얼이 본문에서 참조할 때만 이어서 불러옵니다. 여러 절차가 공유하는 공통 단계를 따로 둘 때 씁니다.
• 메뉴얼이 참조한 도구 — 에이전트에 따로 연결하지 않아도 메뉴얼을 불러오는 순간 함께 쓸 수 있습니다.

​

에이전트와 함께 관리하기

메뉴얼은 그 메뉴얼을 쓰는 에이전트 안에 있습니다. 에이전트 편집 화면 설정 패널의 메뉴얼에서 만들고, 카드를 누르면 프롬프트 옆에 탭으로 열립니다.

• 수정할 때 — 편집 내용은 현재 편집본에 자동으로 저장됩니다. 실제 통화에 반영하려면 에이전트를 배포하세요.
• 배포할 때 — 메뉴얼은 프롬프트, 도구와 함께 같은 버전에 담깁니다. 변경사항 검토 화면의 메뉴얼 항목에서 바뀐 내용을 확인하세요.
• 되돌릴 때 — 이전 버전을 복원하면 그 버전의 메뉴얼도 함께 돌아옵니다.
• 다른 에이전트에서 쓸 때 — 에이전트를 복제하면 메뉴얼도 함께 복사됩니다. 원본을 고쳐도 복사본은 바뀌지 않습니다.

​

API로 관리하기

API에서는 메뉴얼이 에이전트 설정의 data.manuals에 담깁니다. 키는 메뉴얼 UUID입니다. 메뉴얼을 한 건씩 다룰 때는 /agents/{agent_id}/manuals 엔드포인트를 씁니다. 쓰기 요청마다 마지막으로 조회한 head_revision을 expected_head_revision으로 보내세요. 요청과 응답 형식은 API 참조의 메뉴얼 항목을 참고하세요.

​

문제가 생겼을 때

​

관련 문서

• 메뉴얼 작성 — 트리거와 본문을 쓰고 도구를 참조하는 방법
• 에이전트 버전 관리 — 메뉴얼을 포함한 설정을 배포하고 되돌리기
• 실행 대기음 — 메뉴얼을 불러온 직후 재생할 소리

---

연관 검색어

메뉴얼, 매뉴얼, 업무 절차, 트리거, 절차 모듈, manual, playbook, SOP, 프롬프트 분리, 에이전트 메뉴얼, 메뉴얼 이관, 메뉴얼 배포