# 프롬프트 관리

## 프롬프트 관리

프롬프트 관리는 프로젝트 내 모든 LLM 프롬프트를 중앙에서 관리하는 기능입니다. 이번 업데이트(2026년 4월)로 프롬프트 관리 메뉴가 좌측 네비게이션(LNB) 1depth 메뉴로 승격되었으며, 에이전트 프롬프트의 그룹 관리와 복사 편집, 앱별 프롬프트 분리가 가능해졌습니다.

<figure><img src="https://1004557443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhfOaW8xkP2ul7rAY1EBF%2Fuploads%2FkXa9EdSXqAChMtBXhpP6%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202026-03-30%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%201.47.44.png?alt=media&#x26;token=fe4c9188-74bf-4250-9a32-e9db8c902311" alt=""><figcaption></figcaption></figure>

***

### 무엇이 바뀌었나요?

#### 에이전트 프롬프트를 복사하여 자유롭게 편집할 수 있습니다

기존에는 RAG Agent, Table Agent 등 에이전트의 기본(Default) 프롬프트를 수정하면 프로젝트 전체에 영향이 미쳤습니다. 이제 기본 프롬프트를 **복사**하여 앱별로 다른 variation을 만들 수 있습니다. 원본은 그대로 유지되므로 안전합니다.

#### 에이전트별로 프롬프트가 카테고리로 묶여 관리됩니다

기본 프롬프트들이 에이전트 단위(RAG, Table, Research 등)로 **그룹화**되어 표시됩니다. 어떤 에이전트에 어떤 프롬프트가 속하는지 한눈에 파악할 수 있습니다.

#### 프롬프트 관리 메뉴가 독립 메뉴로 승격되었습니다

기존 설정 하위에 있던 프롬프트 관리가 좌측 네비게이션(LNB) **1depth 메뉴**로 이동하여 더 빠르게 접근할 수 있습니다.

#### 새로운 권한이 추가되었습니다

프롬프트 관리 페이지 접근을 위한 **읽기 권한(Prompt Management Read)**&#xACFC;, 공용 프롬프트를 생성 수정 삭제할 수 있는 **쓰기 권한(Project Scope Prompt Write)**&#xC774; 추가되었습니다.

***

### 1. 앱 빌더에서 프롬프트 활용하기 (콘텐츠 관리자)

대화형 앱 빌더에서 노드를 구성하는 콘텐츠 관리자는 프롬프트 관리의 내부 구조를 이해할 필요 없이, 노드 안에서 바로 프롬프트를 선택하고 편집할 수 있습니다.

#### 답변 생성(GA) 노드에서 에이전트 프롬프트 선택

<figure><img src="https://1004557443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhfOaW8xkP2ul7rAY1EBF%2Fuploads%2F0fGc4AFLaF9bl6xB6Yi3%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202026-03-30%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%201.49.25.png?alt=media&#x26;token=9ee08015-b3ad-4c19-a531-74b77ad8e138" alt=""><figcaption></figcaption></figure>

1. 답변 생성 노드의 편집 패널에서 **에이전트** 드롭다운을 클릭합니다.
2. 카테고리 배지(`RAG`, `Table` 등)와 프롬프트 이름을 참고하여 원하는 에이전트를 선택합니다.
3. **적용** 버튼을 클릭합니다.

> 공용 프롬프트와 해당 앱의 프롬프트가 **한 목록에 함께 표시**되므로, 별도로 스코프를 선택할 필요가 없습니다.

#### 기본 프롬프트를 복사하여 편집하기 (Copy & Edit)

기본 에이전트 프롬프트(예: 고급 RAG)를 앱에 맞게 커스터마이징하고 싶다면, 노드에서 바로 복사 편집할 수 있습니다.

1. 노드에서 공용 프롬프트를 선택한 상태에서 **편집 버튼**을 클릭합니다.
2. "앱 스코프로 복사 후 편집된다"는 안내가 표시됩니다. 확인하면 해당 앱 전용 사본이 자동으로 생성됩니다.
3. 복사된 프롬프트를 자유롭게 수정합니다. 원본 공용 프롬프트에는 영향이 없으므로 다른 앱에 영향을 주지 않습니다.
4. 이후에는 앱 스코프 프롬프트로 저장되어 직접 편집이 가능합니다.

| 선택한 프롬프트의 스코프  | 편집 시 동작                                                                                |
| -------------- | -------------------------------------------------------------------------------------- |
| **공용** (기본 포함) | <p>앱 스코프로 <strong>자동 복사 후 편집</strong> <br>- "복사 후 편집된다"는 안내가 표시됩니다. 원본은 변경되지 않습니다.</p> |
| **앱 스코프**      | **직접 편집**                                                                              |

#### LLM 실행 노드에서 에이전트 프롬프트 사용

1. LLM 실행 노드의 **에이전트** 탭을 선택합니다.
2. **에이전트** 드롭다운을 클릭하면 **시스템 기반** / **에이전트 빌더에서 생성** 탭으로 구분된 목록이 표시됩니다.
3. 원하는 에이전트를 선택합니다.

<figure><img src="https://1004557443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhfOaW8xkP2ul7rAY1EBF%2Fuploads%2FJz4Sy4YeCSwgMVa6kaUF%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202026-03-30%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%201.53.09.png?alt=media&#x26;token=058113f6-741d-487a-ad61-7998c817f7b3" alt=""><figcaption></figcaption></figure>

#### LLM 실행 노드에서 단일 프롬프트 사용

앱 편집 화면의 LLM 실행 노드에서도 프롬프트를 직접 추가할 수 있습니다.

1. LLM 실행 노드의 **프롬프트** 탭에서 프롬프트 드롭다운을 엽니다.
2. 기존 프롬프트를 선택하거나, **+ 추가** 버튼으로 새 프롬프트를 생성합니다.
3. 프롬프트 내용을 작성하고 저장합니다.

> 노드에서 작성한 프롬프트는 즉시 반영됩니다.

***

### 2. 프롬프트 관리 페이지에서 관리하기 (프로젝트 관리자)

좌측 네비게이션(LNB)의 **프롬프트 관리** 메뉴를 클릭하여 접근합니다.

<figure><img src="https://1004557443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhfOaW8xkP2ul7rAY1EBF%2Fuploads%2FUfKEpZjGYYBb4MIw5o9X%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202026-03-30%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%202.06.23.png?alt=media&#x26;token=90055216-77f3-4a26-a67d-1bcc7281f703" alt=""><figcaption></figcaption></figure>

#### 페이지 구조

페이지 상단에 두 가지 축으로 프롬프트를 탐색할 수 있습니다.

**스코프 전환: 공용 / 앱**

| 스코프               | 설명                                         | 적합한 경우                      |
| ----------------- | ------------------------------------------ | --------------------------- |
| **공용** (프로젝트 스코프) | 프로젝트 전체에서 공유되는 프롬프트입니다. 여러 앱에서 동일하게 사용합니다. | 표준 프롬프트를 여러 앱에 공통 적용하고 싶을 때 |
| **앱** (앱 스코프)     | 특정 앱에만 귀속되는 프롬프트입니다. 해당 앱에서만 사용 편집됩니다.     | 특정 앱에 맞춤형 프롬프트를 적용하고 싶을 때   |

**프롬프트 유형 탭: 에이전트용 프롬프트 / 단일 프롬프트**

| 탭              | 설명                                | 사용되는 노드                                             |
| -------------- | --------------------------------- | --------------------------------------------------- |
| **에이전트용 프롬프트** | 여러 프롬프트가 하나로 묶여 동작하는 에이전트 프롬프트 그룹 | <p>답변 생성(GA) 노드, Deep Research 노드,<br>LLM 실행 노드</p> |
| **단일 프롬프트**    | 하나의 프롬프트만으로 동작하는 기본 유형            | LLM 실행 노드                                           |

#### 공용 > 에이전트용 프롬프트 관리

시스템이 기본 제공하는 에이전트 프롬프트 그룹이 카테고리별로 표시됩니다.

**기본 제공 카테고리:**

| 카테고리        | 기본 에이전트        | 설명                     |
| ----------- | -------------- | ---------------------- |
| RAG         | 고급 RAG, 기본 RAG | 문서 검색 기반 답변 생성         |
| Table       | 테이블 에이전트       | 테이블 데이터 분석 처리          |
| Research    | 딥 리서치 에이전트     | 심층 리서치                 |
| Assistant   | 앱 마켓 에이전트      | 앱 마켓 연동 (구버전, 일부만 제공)  |
| App Creator | 싱글 액션 크리에이터    | 싱글 액션 생성 (구버전, 일부만 제공) |
| Confluence  | 컨플루언스 에이전트     | Confluence 연동          |

**에이전트 프롬프트 그룹 상세 보기:**

목록에서 에이전트 이름을 클릭하면 상세 화면으로 이동합니다.

<figure><img src="https://1004557443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhfOaW8xkP2ul7rAY1EBF%2Fuploads%2FGKM7AkfzKS3uXAJegPWh%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202026-03-30%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%202.06.54.png?alt=media&#x26;token=0818a9c2-0eeb-4cd6-a29e-8de953bccc97" alt=""><figcaption></figcaption></figure>

* **좌측**: 에이전트에 포함된 개별 프롬프트 목록 (섹션별로 그룹화, 예: WEB, DOCUMENT, WORK\_ASSISTANT)
* **우측**: 선택한 프롬프트의 설명 및 시스템 프롬프트 내용
* **우상단**: 복사, 편집, 삭제 아이콘

**에이전트 프롬프트 그룹 복사하기:**

1. 목록의 **복사 아이콘** 또는 상세 화면 우상단의 복사 아이콘을 클릭합니다.
2. **공용 프롬프트** 또는 **앱 프롬프트**로 복사할 위치를 선택합니다.
3. 복사된 에이전트가 생성되고 편집 페이지로 이동합니다.

> * 이름은 자동으로 부여됩니다 (예: `고급 RAG_1`, `고급 RAG_2`).
> * 그룹에 포함된 모든 개별 프롬프트가 함께 복사됩니다.

|                       | 복사 | 편집          | 삭제 |
| --------------------- | -- | ----------- | -- |
| **기본 에이전트** (`기본` 배지) | O  | X           | X  |
| **복사된 에이전트**          | O  | O           | O  |
| **그룹 내 개별 프롬프트**      | X  | O (그룹 편집 시) | X  |

#### 공용 > 단일 프롬프트 관리

직접 생성, 수정, 삭제가 가능한 프롬프트를 관리합니다.

<figure><img src="https://1004557443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhfOaW8xkP2ul7rAY1EBF%2Fuploads%2FhGokrCEtjcqywV2RDcsx%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202026-03-30%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%202.07.51.png?alt=media&#x26;token=20e9f0ef-b3c9-4037-90ce-b0788c1bdb98" alt=""><figcaption></figcaption></figure>

**프롬프트 추가:**

1. 우측 상단의 **+ 프롬프트 추가** 버튼을 클릭합니다.
2. 프롬프트 이름, 설명, 시스템 프롬프트, 유저 프롬프트를 입력합니다.
3. 필요시 다이나믹 인풋(변수)을 설정합니다.
4. **저장** 버튼을 클릭합니다.

> 프롬프트 내에서 동적 인풋을 사용하려면 중괄호 `{변수명}` 형식을 사용합니다.

#### 앱 프롬프트 관리

**앱** 탭을 클릭하면 프로젝트 내 대화형 앱 목록이 표시됩니다.

앱을 클릭하면 해당 앱에 귀속된 프롬프트 목록이 표시됩니다.

**앱 프롬프트에서 가능한 작업:**

* 앱에 편집 권한이 있는 경우: 프롬프트 생성, 수정, 삭제, 복사 가능
* 앱에 열람 권한만 있는 경우: 다른 앱으로 복사하거나 공용 프롬프트로 복사만 가능
* 앱에서 사용 중인 프롬프트는 직접 수정할 수 없으며, 복사 후 수정하는 방식으로 진행

**바로가기 버튼:** 앱 목록에서 바로가기 아이콘을 클릭하면, 해당 프롬프트가 사용되는 앱 빌더 화면으로 바로 이동합니다.

#### 프롬프트 스코프 간 복사

프롬프트는 스코프 간 자유롭게 복사할 수 있습니다.

| 복사 방향        | 설명                    | 필요 권한                      |
| ------------ | --------------------- | -------------------------- |
| **공용 → 앱**   | 공용 프롬프트를 특정 앱 전용으로 복사 | 대상 앱 Editor 권한             |
| **앱 → 공용**   | 앱 프롬프트를 프로젝트 전체에 공유   | Project Scope Prompt Write |
| **앱 → 다른 앱** | 앱 프롬프트를 다른 앱으로 복사     | 대상 앱 Editor 권한             |

***

### 3. 상세 정책

#### 권한

프롬프트 관리에 적용되는 권한은 **프로젝트 설정 > 멤버 > 그룹 권한 설정**에서 관리합니다.

<figure><img src="https://1004557443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhfOaW8xkP2ul7rAY1EBF%2Fuploads%2FUwAVQBpY0sAkJIOknZdw%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202026-03-30%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%202.08.53.png?alt=media&#x26;token=317ffc97-824c-41da-8445-80b02c563c27" alt=""><figcaption></figcaption></figure>

**프로젝트(공용) 프롬프트 권한:**

| 권한                               | 설명                                                   |
| -------------------------------- | ---------------------------------------------------- |
| **프롬프트 관리 > 페이지 접근**             | 프롬프트 관리 페이지 접근 권한. 이 권한이 없으면 LNB에서 메뉴 자체가 표시되지 않습니다. |
| **프롬프트 관리 > 프로젝트 프롬프트 추가/수정/삭제** | 공용 프롬프트의 생성, 수정, 삭제 권한.                              |

**앱 프롬프트 권한:**

| 작업                   | 필요 권한                                                                                                                        |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| **프롬프트 관리 페이지에서 보기** | <p><strong>프롬프트 관리 > 페이지 접근</strong> AND <br><strong>앱 마켓, 앱 관리 > 페이지 접근</strong> AND<br><strong>해당 앱 Viewer 권한</strong></p> |
| **노드 내에서 보기**        | 앱 Viewer 권한만으로 가능                                                                                                            |
| **편집**               | 앱 Editor 권한                                                                                                                  |

#### 기본(Default) 프롬프트 정책

* 시스템이 제공하는 기본 에이전트 프롬프트는 **편집 삭제할 수 없습니다.** 복사만 가능합니다.
* 기본 단일 프롬프트(예: 문서 분석 중 문서 내 이미지 설명 생성)는 `기본` 배지가 표시되며, 편집은 가능하지만 삭제는 불가합니다.
* 기본 프롬프트의 체크박스는 비활성화되어 일괄 삭제 대상에서 제외됩니다.

#### 사용 중인 프롬프트 보호

* 앱에서 현재 **사용 중인 프롬프트는 삭제할 수 없습니다.** 먼저 해당 앱에서 다른 프롬프트로 변경해야 합니다.
  * 공용 프롬프트의 경우, 리스트 우측의 더 보기(...) 버튼을 클릭해, "이를 사용하는 앱"을 선택하면 해당 프롬프트가 사용되고있는 앱을 확인할 수 있습니다.
* 앱에서 사용 중인 프롬프트를 수정하면, 해당 프롬프트를 사용하는 **모든 노드에 즉시 반영**됩니다.

#### 이름 중복 정책

* 프롬프트 그룹 복사 시 이름이 중복되면 자동으로 넘버링됩니다 (예: `고급 RAG`, `고급 RAG_1`, `고급 RAG_2`).
* 같은 스코프(공용/같은 앱) 내에서 동일한 이름은 허용되지 않습니다.

#### 에이전트 프롬프트 그룹 구조

에이전트 프롬프트 그룹은 내부적으로 **섹션(Subsection)**&#xBCC4;로 개별 프롬프트가 분류됩니다.

예를 들어 고급 RAG 에이전트의 경우:

* **WEB**: 웹 검색 관련 프롬프트 (메인 오케스트레이터, 결과 선택기)
* **DOCUMENT**: 문서 분석 관련 프롬프트 (메인 오케스트레이터, 요약, 번역)
* **WORK\_ASSISTANT**: 답변 생성 관련 프롬프트 (메인 오케스트레이터 등)

각 섹션은 접어서 보거나 펼칠 수 있으며, 개별 프롬프트를 클릭하면 우측에 시스템 프롬프트 내용이 표시됩니다.

#### 다이나믹 인풋(변수)

프롬프트 내에서 중괄호 `{}`를 사용하여 다이나믹 인풋을 삽입할 수 있습니다.

| 타입         | 설명                   | 예시                      |
| ---------- | -------------------- | ----------------------- |
| **시스템 변수** | Alli 시스템과 자동 연동되는 변수 | `{EMAIL}`, `{LANGUAGE}` |
| **앱 변수**   | 사용자가 직접 정의하는 변수      | 커스텀 입력값, 컨텍스트 정보        |

앱 변수 추가 시 설정 항목:

* **변수 이름**: 프롬프트에서 참조할 이름
* **변수 타입**: Conversation(대화 중에만 유지) / User(대화 종료 후에도 유지)
* **변수 종류**: 11가지 종류 중 선택
* **토큰 자르기**: 긴 변수값의 토큰 수를 제한 (선택사항)

#### 지원 프로젝트 타입

프롬프트 관리 메뉴는 **Answerbot & LLM**, **LLM Apps**, **Works** 타입 프로젝트에서 사용 가능합니다.

#### 주의사항

* 신규 에이전트 프롬프트 그룹의 **직접 생성은 지원되지 않습니다.** 기본 에이전트를 복사하여 사용하세요.
* Single Action App과 Agent 타입 App의 프롬프트는 프롬프트 관리 페이지에 표시되지 않습니다.