> ## Documentation Index
> Fetch the complete documentation index at: https://manual.seahorse.dnotitia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> Prompt Settings — Agent Chat 에서 사용할 사용자 정의 프롬프트 생성·관리. 프롬프트 본문 + 허용 도구 패키지로 구성

# Prompt settings

# Prompt Settings

**경로**: 좌측 사이드바 상단 **⋯ 메뉴** → **Prompt settings**

Agent Chat 에서 사용자가 직접 등록·활성화하는 **사용자 정의 프롬프트 (User Prompt)** 관리 화면입니다. 프롬프트 본문과 함께 **해당 프롬프트 활성 시 노출될 도구 집합** 을 함께 지정하므로, 역할(페르소나) 별로 프롬프트·도구 세트를 한 번에 전환할 수 있습니다.

<Frame>
  <img src="https://mintcdn.com/dnotitia-328335e7/3mgjFAVO5t1rKplH/images/image-43.png?fit=max&auto=format&n=3mgjFAVO5t1rKplH&q=85&s=3c9b651fdb59ece257753b93716cf67c" alt="Image" width="1364" height="568" data-path="images/image-43.png" />
</Frame>

<Info>
  * **에이전트 전역에 연결되는 System Prompt** 는 이 화면이 아니라 [Console → Agent Ops → System Prompts](/console/agent-ops/system-prompts) 에서 관리자가 관리합니다.
  * 본 화면은 **개별 사용자가 자기 세션에 적용할 프롬프트** 를 관리하는 곳입니다.
</Info>

## 프롬프트 목록

| 요소                      | 설명                             |
| ----------------------- | ------------------------------ |
| **+ Create New Prompt** | 신규 프롬프트 작성 다이얼로그               |
| 프롬프트 카드                 | 이름·상태(Active/Inactive)·허용 도구 수 |
| 행 동작                    | 클릭 시 편집 · 🗑 삭제 · 상태 토글        |

## Create New Prompt (생성)

`Create New Prompt` 다이얼로그의 필드:

| 필드                    | 설명                                            | 필수              |
| --------------------- | --------------------------------------------- | --------------- |
| **Name**`*`           | 프롬프트 식별 이름                                    | Y               |
| **Prompt Status**     | `Active` / `Inactive` — 저장 직후 활성화 여부          | N (기본 Inactive) |
| **Description**       | 용도 메모                                         | N               |
| **Prompt Content**`*` | 시스템 프롬프트 본문 — AI 동작 가이드                       | Y               |
| **Available Tools**   | **Select Tools** 버튼으로 이 프롬프트가 활성일 때 노출될 도구 선택 | N               |

하단 안내: `Prompt will be inactive after saving` — 생성 직후 기본은 Inactive.

### Prompt Status

| 값            | 의미                                                      |
| ------------ | ------------------------------------------------------- |
| **Active**   | 현재 세션의 Agent Chat 에 즉시 적용 — 다음 메시지부터 이 프롬프트 + 허용 도구로 동작 |
| **Inactive** | 저장만, 적용 안 됨. 추후 토글로 활성화                                 |

한 사용자가 **동시에 Active 로 유지 가능한 프롬프트 수는 운영자 정책에 따라 제한** 될 수 있습니다.

### Available Tools — Select Tools

`Select tools that should be available when this prompt is active`

프롬프트가 Active 일 때 에이전트가 호출 가능한 도구를 **카테고리별로 다중 선택** 합니다. 빈 상태일 때는 `No tools selected. Click "Select Tools" to add tools.` 안내가 표시됩니다.

<Info>
  **프롬프트 + 도구 패키지 = 페르소나**

  * 예: "법무 검토 프롬프트" 에는 `search_documents` · `docx` 도구만 허용 → 외부 API 호출 차단.
  * "코드 리뷰 프롬프트" 에는 `GitHub MCP` · `code_read` 도구만 허용 → Slack 발송 차단.
  * 프롬프트 전환만으로 동시에 도구 세트가 바뀌므로 역할별 전환이 간편합니다.
</Info>

## 프롬프트 계층

사용자가 받는 최종 프롬프트는 **여러 계층이 합쳐진 결과** 입니다. 우선순위는 아래에서 위로 덮어씌워집니다.

| 계층                             | 설정 위치                                                         | 변경 가능자       |
| ------------------------------ | ------------------------------------------------------------- | ------------ |
| **에이전트 기본 System Prompt**      | [Console → System Prompts](/console/agent-ops/system-prompts) | 관리자          |
| **사용자 프롬프트** (본 화면의 Active 항목) | Prompt settings                                               | 사용자 본인       |
| **세션 프롬프트**                    | 채팅 입력창의 인라인 시스템 메시지                                           | 사용자 본인 (일회성) |

## 작성 팁

좋은 프롬프트의 5 요소 (자세한 가이드: [System Prompt 작성 가이드](/console/agent-ops/system-prompts#작성-가이드)):

1. **역할 정의** — `당신은 {역할} 입니다.`
2. **범위 한정** — 답변/거절 주제 명확히
3. **답변 스타일** — 말투·길이·구조
4. **금칙·고지** — 민감 정보 마스킹, 출처 강제
5. **출력 형식** — 원하는 템플릿

## 운영 주의

<Warning>
  * **변경 즉시 적용** — Active 프롬프트 수정 시 다음 메시지부터 반영. 진행 중인 대화 맥락과 충돌할 수 있음.
  * **민감 정보 금지** — 프롬프트는 모든 LLM 호출마다 전송됩니다. API 키·비밀번호·개인정보를 프롬프트에 넣지 마세요.
  * **긴 프롬프트는 비용** — 입력 토큰 누적. 핵심만 유지하고 한도·요금은 [Billing](/billing) 참고.
  * **Allowed Tools 누락 체크** — 도구 없이 "검색해줘" 같은 지시를 하면 모델이 할루시네이션으로 답변을 지어낼 수 있음. 도구가 필요한 역할이면 반드시 포함.
  * **조직 기본 프롬프트와 충돌** — 사용자 프롬프트가 관리자 기본 프롬프트의 금칙(예: 개인정보 출력 금지) 를 덮을 수 없도록 정책적으로 협의.
</Warning>

## 관련 문서

* [Console → System Prompts](/console/agent-ops/system-prompts) — 에이전트 기본 프롬프트 (관리자)
* [Agent 설정 → System Prompts 연결](/console/agent-ops/agent/agent-settings#system-prompts-시스템-프롬프트-연결) — 에이전트에 프롬프트 붙이기
* [MCP Tools](/agent-chat/toolbar/mcp-tools) — Allowed Tools 의 실제 도구들
* [Memory facts](/agent-chat/user-menu/memory-facts) — 세션별 기억 (프롬프트와 구분되는 장기 기억)