> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryvox.co/llms.txt
> Use this file to discover all available pages before exploring further.

# 메뉴얼 개요

> 하나의 업무 절차를 담아 에이전트에 연결하고, 대화가 트리거와 맞는 순간에만 지시를 불러옵니다.

메뉴얼은 하나의 업무를 처리하는 지시 모듈입니다. 언제 쓸지를 정하는 **트리거**와 무엇을 할지를 담는 **본문**으로 구성되며, 에이전트에 연결해 두면 통화 중 대화가 트리거와 맞는 순간 본문이 대화에 로드됩니다.

환불 접수, 본인 확인, 해지 방어처럼 서로 다른 업무가 많은 에이전트일수록 효과가 큽니다. 업무마다 메뉴얼 하나씩을 만들면 프롬프트 한 곳에 모든 절차를 쌓지 않아도 됩니다.

<img src="https://mintcdn.com/fleek/UR68nrm5Royg5RSB/images/screens/manuals/manual-list.jpg?fit=max&auto=format&n=UR68nrm5Royg5RSB&q=85&s=76d3b1a1e82c940ae2e37446b480853d" alt="빌드 > 메뉴얼 목록 화면" style={{ borderRadius: "0.5rem" }} data-og-width="1670" width="1670" data-og-height="370" height="370" data-path="images/screens/manuals/manual-list.jpg" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/fleek/UR68nrm5Royg5RSB/images/screens/manuals/manual-list.jpg?w=280&fit=max&auto=format&n=UR68nrm5Royg5RSB&q=85&s=7e776626d7c9aa3f805284583afc37cd 280w, https://mintcdn.com/fleek/UR68nrm5Royg5RSB/images/screens/manuals/manual-list.jpg?w=560&fit=max&auto=format&n=UR68nrm5Royg5RSB&q=85&s=3b344e28acb05f02575d126c9197bcee 560w, https://mintcdn.com/fleek/UR68nrm5Royg5RSB/images/screens/manuals/manual-list.jpg?w=840&fit=max&auto=format&n=UR68nrm5Royg5RSB&q=85&s=fbae714a9b83bc472db0dedaf77776f2 840w, https://mintcdn.com/fleek/UR68nrm5Royg5RSB/images/screens/manuals/manual-list.jpg?w=1100&fit=max&auto=format&n=UR68nrm5Royg5RSB&q=85&s=1d9cbb1fea113ab393fe766a5a6d75fc 1100w, https://mintcdn.com/fleek/UR68nrm5Royg5RSB/images/screens/manuals/manual-list.jpg?w=1650&fit=max&auto=format&n=UR68nrm5Royg5RSB&q=85&s=80c9f3afa09c13ca1465cf0859556456 1650w, https://mintcdn.com/fleek/UR68nrm5Royg5RSB/images/screens/manuals/manual-list.jpg?w=2500&fit=max&auto=format&n=UR68nrm5Royg5RSB&q=85&s=feec31f1ada878e41a2b10745c2fef19 2500w" />

## 동작 방식

프롬프트 에이전트의 시스템 프롬프트는 매 턴 전체가 대화 컨텍스트에 상주합니다. 업무 절차가 쌓일수록 프롬프트가 길어지고, 지금 대화와 무관한 절차까지 토큰과 응답 지연을 차지합니다.

메뉴얼은 평소에는 **이름과 트리거만** 대화에 등재됩니다. 본문은 트리거가 맞는 순간에만 로드되므로, 절차가 아무리 많아도 무관한 턴에서는 컨텍스트를 차지하지 않습니다.

<img src="https://mintcdn.com/fleek/UR68nrm5Royg5RSB/images/screens/manuals/manual-context.svg?fit=max&auto=format&n=UR68nrm5Royg5RSB&q=85&s=dc60af9d9fd8fa52303865c2011d1e33" alt="메뉴얼 동작 구조 — 대화 컨텍스트에는 이름과 트리거만 상주하고, 본문은 트리거가 맞는 순간 로드되어 통화 종료까지 유지" style={{ borderRadius: "0.5rem" }} width="880" height="420" data-path="images/screens/manuals/manual-context.svg" />

한 번 로드된 메뉴얼은 그 통화가 끝날 때까지 유지됩니다.

## 조직 리소스

메뉴얼은 도구·지식 베이스와 같은 조직 단위 리소스입니다.

* **여러 에이전트에서 재사용합니다.** 본인 확인 절차를 메뉴얼 하나로 만들어 모든 상담 에이전트에 연결할 수 있습니다.
* **수정이 즉시 반영됩니다.** 메뉴얼을 고치면 그 메뉴얼을 연결해 둔 모든 에이전트에 바로 적용됩니다.
* **도구를 함께 데려갑니다.** 메뉴얼이 참조한 도구는 에이전트에 별도로 설정하지 않아도, 메뉴얼이 로드되는 순간 함께 활성화됩니다.

## 사용 시점

| 상황                                         | 선택                                    | 이유                                             |
| ------------------------------------------ | ------------------------------------- | ---------------------------------------------- |
| 단순한 에이전트, 절차가 한두 개                         | 시스템 프롬프트만                             | 가장 빠르게 만들고 고칠 수 있습니다. 다만 업무가 늘면 프롬프트가 비대해집니다.  |
| 업무가 여러 개이고, 에이전트가 상황에 맞춰 말과 순서를 조절해도 되는 경우 | **메뉴얼**                               | 대화 전체가 하나의 흐름 안에서 이어지므로 예상 밖의 전개에도 유연하게 대응합니다. |
| 정해진 분기와 단계를 매번 똑같이 강제해야 하는 경우              | [플로우 에이전트](/docs/build/flow/overview) | 그래프로 설계한 경로를 그대로 따릅니다.                         |

<Note>
  메뉴얼은 **프롬프트 에이전트 전용**입니다. 플로우 에이전트에는 연결할 수 없습니다.
</Note>

## 관리 표면

| 표면   | 할 수 있는 일                                           |
| ---- | -------------------------------------------------- |
| 대시보드 | **빌드 > 메뉴얼**에서 생성·수정, 에이전트 편집 화면에서 연결·해제           |
| API  | `/manuals` 리소스로 생성·수정·삭제, 에이전트의 `manualIds`로 연결 관리 |

어느 표면에서 만들었든 결과는 동등합니다. 대시보드에서 만든 메뉴얼을 API로 수정해도 됩니다.

## 제약 사항

* 본문은 최대 8,096자입니다. 공백을 포함해 셉니다.
* 메뉴얼은 프롬프트 에이전트에만 연결할 수 있습니다.
* 한 번 로드된 메뉴얼은 통화 중에 내릴 수 없습니다. 통화가 끝나면 초기화됩니다.

작성 방법은 [메뉴얼 작성](/docs/build/manuals/writing)을 참고하세요.
