> ## 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.

> System Prompts는 에이전트의 동작 방식과 응답 성격을 정의하는 사전 설정 프롬프트 관리 기능입니다. 재사용 가능한 시스템 프롬프트 템플릿을 생성하고, 여러 에이전트에 적용할 수 있습니다

# System prompts

# System Prompts 기능

**경로**: Console → **Agent Ops** → **System Prompts**

System Prompts 는 에이전트의 **역할·답변 스타일·금지 사항** 을 정의하는 사전 설정 프롬프트입니다. 한 번 만들면 여러 에이전트에 재사용할 수 있고, **Activation Mode** 로 자동 선택 동작도 지정할 수 있습니다.

<img src="https://mintcdn.com/dnotitia-328335e7/nH6QAwwQZ-jsIFdi/.gitbook/assets/admin__SystemPromDTLds.png?fit=max&auto=format&n=nH6QAwwQZ-jsIFdi&q=85&s=c950664e5124d21b3eca1744235f7120" alt="System Prompts 기능" width="982" height="804" data-path=".gitbook/assets/admin__SystemPromDTLds.png" />

## 왜 쓰나요?

| 상황                 | System Prompt 로 해결            |
| ------------------ | ----------------------------- |
| 에이전트가 무관한 질문에도 답함  | "범위 외 질문은 거절" 명시              |
| 답변이 너무 장황함         | "200 자 이내·핵심 위주" 지정           |
| 출처 인용이 빠짐          | "답변 끝에 파일명·페이지 인용" 강제         |
| 페르소나 일관성 부족        | "당신은 인사 담당자입니다…" 역할 고정        |
| 민감 답변 (법적 책임·개인정보) | "법률 자문 아님 고지", "개인정보 출력 금지" 룰 |

<Info>
  Cloud 환경에서는 **Agent Rules** 가 비활성(On-prem 전용)이므로, **응답 제약·금칙어·출력 형식 강제는 모두 System Prompt 로** 구현합니다.
</Info>

## 작성 가이드

좋은 System Prompt 의 구조:

<Steps>
  <Step title="역할 정의">
    `당신은 {조직명} 의 {역할} 입니다.` — 한 문장으로 페르소나 명시.
  </Step>

  <Step title="범위 한정">
    답변할 / 거절할 주제를 명확히 구분. 예: `"인사 규정에 한정해 답변. 그 외 질문은 '담당자에게 문의하세요' 로 안내".`
  </Step>

  <Step title="답변 스타일">
    말투(공식/비공식), 길이(요약/상세), 구조(불릿/표/마크다운) 지정.
  </Step>

  <Step title="금칙·고지">
    법적 책임 회피, 민감 정보 마스킹, 출처 인용 강제. 예: `"개인정보·연봉 데이터는 절대 출력하지 말 것"`.
  </Step>

  <Step title="출력 형식">
    원하는 응답 템플릿. 예: `"다음 형식으로: 1) 핵심 답 2) 근거 문서 인용 3) 추가 확인 필요 항목"`.
  </Step>
</Steps>

## Activation Mode

| 값               | 의미                                        | 사용 예                                                  |
| --------------- | ----------------------------------------- | ----------------------------------------------------- |
| **Auto Select** | 에이전트가 런타임에 사용자 질의를 보고 적합한 프롬프트를 **자동 선택** | 한 에이전트가 인사·법무·기술 문의를 모두 받을 때 — 도메인별 프롬프트를 등록해두고 자동 매칭 |
| **Manual**      | 명시적으로 연결한 경우에만 사용                         | 단일 역할 에이전트의 단일 프롬프트                                   |

## 에이전트에 연결

System Prompt 를 만든 뒤에는 [Agent 상세 → System Prompts 팝업](/console/agent-ops/agent/agent-settings#system-prompts-시스템-프롬프트-연결) 에서 다중 선택으로 연결합니다. 본 화면은 **프롬프트 자체의 생성·편집** 에 집중.

## 운영 주의

<Warning>
  * **변경 즉시 영향** — 운영 중 에이전트의 답변이 다음 세션부터 바로 바뀝니다. 프로덕션 변경 전에 별도 테스트 에이전트에 먼저 적용해 검증하세요.
  * **너무 긴 프롬프트는 비용** — System Prompt 는 모든 호출마다 전송되어 입력 토큰을 차지합니다. 핵심만 남기고, 토큰 한도·요금은 [Billing](/billing) 참고.
  * **모순된 규칙** 을 넣으면 모델이 임의로 판단합니다. 규칙끼리 충돌이 없는지 확인.
  * **민감 정보 (API 키·비밀번호) 를 프롬프트에 넣지 마세요** — 로그·분석에 노출됩니다.
</Warning>

## 페이지

<CardGroup cols={2}>
  <Card title="System Prompt 생성" href="/console/agent-ops/system-prompts/prompt-create">
    새로운 시스템 프롬프트 템플릿을 생성합니다
  </Card>

  <Card title="System Prompt 삭제" href="/console/agent-ops/system-prompts/prompt-delete" />

  <Card title="System Prompt 상세" href="/console/agent-ops/system-prompts/prompt-detail">
    시스템 프롬프트의 상세 정보를 확인합니다. Connected Tools, Selection Guides 설정 값을 볼 수 있습니다
  </Card>

  <Card title="System Prompt 목록" href="/console/agent-ops/system-prompts/prompt-list">
    System Prompt 목록 — 등록된 프롬프트의 이름·설명·Activation Mode·생성일을 조회하고 관리
  </Card>

  <Card title="System Prompt 수정" href="/console/agent-ops/system-prompts/prompt-update">
    시스템 프롬프트의 설정 값을 수정합니다. Prompt Content등을 변경할 수 있습니다
  </Card>
</CardGroup>

## 관련 문서

* [Agent Ops Menu Group](/)
* [Agent 기능](/console/agent-ops/agent)
* [Agent Rules 기능](/console/agent-ops/agent-rules)
* [Tool Management](/console/agent-ops/agent-tool)