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

> 에이전트의 확장 설정을 관리합니다. 시스템 프롬프트, 넛지 질문, 속성 세팅 등 에이전트의 동작을 세밀하게 제어할 수 있습니다

# Agent settings

# Agent 확장 설정

## 개요

에이전트의 확장 설정을 관리합니다. 시스템 프롬프트, 넛지 질문, 속성 세팅 등 에이전트의 동작을 세밀하게 제어할 수 있습니다.

## 경로

**경로**: Console → **Agent Ops** → **Agent** → 에이전트 상세 → 우측 상단 햄버거 메뉴

## 상단 메뉴 접근

에이전트 상세 페이지 우측 상단 아이콘을 클릭하면 확장 설정 메뉴가 표시됩니다.

<img src="https://mintcdn.com/dnotitia-328335e7/pi5a4xJA1fTcDZ9m/.gitbook/assets/admin__AgentOpsDR.png?fit=max&auto=format&n=pi5a4xJA1fTcDZ9m&q=85&s=5e6dbf02ee61dc120ffad5fe30a21193" alt="상단 메뉴 접근" width="982" height="804" data-path=".gitbook/assets/admin__AgentOpsDR.png" />

## System Prompts (시스템 프롬프트 연결)

`Select System Prompts to use with this Agent.`

상세 페이지 상단 메뉴의 **System Prompts** 아이콘 클릭 → 팝업으로 관리.

<img src="https://mintcdn.com/dnotitia-328335e7/pi5a4xJA1fTcDZ9m/.gitbook/assets/admin__AgentOpsDRSP.png?fit=max&auto=format&n=pi5a4xJA1fTcDZ9m&q=85&s=d052d14f4d27092bb66fd131f182b0ae" alt="System Prompts 팝업" width="982" height="804" data-path=".gitbook/assets/admin__AgentOpsDRSP.png" />

### 팝업 구성

| 요소                                | 설명                                                                                |
| --------------------------------- | --------------------------------------------------------------------------------- |
| **`N connected` 뱃지**              | 이 에이전트에 연결된 System Prompt 수                                                       |
| **Manage System Prompts** 버튼 (🔗) | [System Prompt 관리 화면](/console/agent-ops/system-prompts) 으로 이동 (새 탭) — 프롬프트 생성·수정 |
| **Refresh** (↻)                   | 목록 재조회                                                                            |
| 프롬프트 목록                           | 체크박스로 다중 선택 — 이름 + **Auto Select 뱃지**(있는 경우) + 설명                                 |

### Auto Select

`Auto Select` 뱃지가 붙은 프롬프트는 에이전트가 **런타임에 상황에 맞는 프롬프트를 자동 선택** 합니다. 여러 역할을 하나의 에이전트로 운영할 때 유용.

### 동작

* 프롬프트는 [System Prompt](/console/agent-ops/system-prompts) 에서 별도로 생성해둔 것 중 선택하는 방식
* 연결된 프롬프트는 **모든 대화의 첫 메시지로 LLM에 전달** 됩니다
* 변경 시 이후 새 세션부터 적용 (진행 중 세션은 기존 프롬프트 유지)
* 0 개 연결도 가능 — 그 경우 기본 프롬프트 사용

<Info>
  프롬프트 자체의 작성·관리는 이 팝업이 아니라 [System Prompt 관리](/console/agent-ops/system-prompts) 에서 수행합니다. 팝업은 **"어떤 프롬프트를 이 에이전트에 붙일지"** 만 선택.
</Info>

## Nudge Questions (넛지 질문)

`Manage suggested questions shown to users at the start of conversation`

사용자가 **Agent Chat 을 처음 열었을 때 카드 형태로 제안되는 예시 질문** 을 미리 등록합니다. 주요 사용 시나리오를 안내하는 용도.

<img src="https://mintcdn.com/dnotitia-328335e7/pi5a4xJA1fTcDZ9m/.gitbook/assets/admin__AgentOpsDRNg.png?fit=max&auto=format&n=pi5a4xJA1fTcDZ9m&q=85&s=4f516d10beae091c18e58bd8ccd71adf" alt="Nudge Questions 팝업" width="982" height="804" data-path=".gitbook/assets/admin__AgentOpsDRNg.png" />

### 팝업 구성

| 요소                     | 설명                                                            |
| ---------------------- | ------------------------------------------------------------- |
| **`N questions` 뱃지**   | 등록된 질문 수                                                      |
| **정렬/최대 카운트** (예: `3`) | 채팅 시작 시 노출될 질문 개수 제한                                          |
| **+ Add Question**     | 새 질문 추가 입력                                                    |
| **Refresh** (↻)        | 목록 재조회                                                        |
| 빈 상태                   | 💬 아이콘 + `No nudge questions configured` + **+ Add Question** |

### 관리

* **추가** — **+ Add Question** 버튼으로 문장 입력
* **수정** — 기존 질문 텍스트 직접 편집
* **삭제** — 질문 옆 삭제 아이콘

### 동작

* 에이전트 채팅 화면 로드 시 **카드(칩) 형태** 로 첫 화면에 노출
* 사용자가 카드 클릭 → 해당 질문이 **입력창에 자동 입력** 후 전송
* 신규 사용자의 첫 질문 장벽을 낮추는 **온보딩 보조 장치**

<img src="https://mintcdn.com/dnotitia-328335e7/pi5a4xJA1fTcDZ9m/.gitbook/assets/admin__AgentOps2net2.png?fit=max&auto=format&n=pi5a4xJA1fTcDZ9m&q=85&s=d1d12b75f30908f71222abcaaccc7d96" alt="채팅 화면 렌더 예시" width="982" height="804" data-path=".gitbook/assets/admin__AgentOps2net2.png" />

<Info>
  **넛지 질문 작성 팁**

  * 에이전트 **대표 시나리오 3\~5 개** 를 짧고 구체적으로 (예: `연차 규정 알려줘`, `법인카드 한도는?`).
  * 너무 길면 카드가 잘려 보입니다. **한 줄 25 자 이내** 권장.
  * 답변 실패율이 높은 질문은 등록을 피하세요 — 첫인상이 "모른다"로 끝나면 이탈률이 올라갑니다.
</Info>

## 속성 세팅 (Attribute Settings)

에이전트의 세부 동작 속성을 설정합니다.에이전트의 카테고리로 작동합니다.

<img src="https://mintcdn.com/dnotitia-328335e7/pi5a4xJA1fTcDZ9m/.gitbook/assets/admin__AgentOpsDRKey.png?fit=max&auto=format&n=pi5a4xJA1fTcDZ9m&q=85&s=aeade37011a0de91894d11dc2fb5fdce" alt="속성 세팅 (Attribute Settings)" width="982" height="804" data-path=".gitbook/assets/admin__AgentOpsDRKey.png" />

## Export Conversations (대화 이력 내보내기)

에이전트 상세 페이지 우측 상단의 **Export Conversations** 버튼을 클릭하면 대화 이력을 파일로 내보내는 팝업이 열립니다.

**팝업 구성**

| 항목                          | 타입 | 기본     | 설명                                |
| --------------------------- | -- | ------ | --------------------------------- |
| **Date Range**              | 토글 | OFF    | ON 시 시작·종료 날짜 선택 가능 — 기간 필터       |
| **Message Count Filter**    | 토글 | OFF    | ON 시 세션당 최소 메시지 수 등 필터 — 짧은 세션 제외 |
| **Enable Encryption**       | 토글 | OFF    | ON 시 Export 파일 암호화 — 비밀번호/키 입력    |
| **Include System Messages** | 토글 | **ON** | 시스템 메시지(프롬프트·도구 호출 로그) 포함 여부      |

**Export Preview** — 현재 필터 기준의 요약이 실시간 표시됩니다.

| 지표                    | 의미                |
| --------------------- | ----------------- |
| **Total Sessions**    | 해당 에이전트의 전체 세션 수  |
| **Filtered Sessions** | 위 필터 조건을 통과한 세션 수 |
| **Total Messages**    | 선택된 세션의 총 메시지 수   |

하단 **Cancel** / **Export** — Export 클릭 시 파일 다운로드.

<Warning>
  * **민감 대화가 포함될 수 있습니다.** Enable Encryption 를 켜고 내보내거나, 내보낸 파일을 안전한 저장소에 보관하세요.
  * **Include System Messages** 를 켜면 System Prompt·Tool 호출 인자까지 모두 내보내집니다. 외부 공유용이라면 OFF 권장.
  * 대용량 에이전트의 경우 Export 에 시간이 걸릴 수 있습니다. Message Count Filter / Date Range 로 범위를 좁히세요.
</Warning>

<Info>
  감사·분석 목적의 정기 Export 는 [Events 감사](/internal/system-admin/operations/events) 에서 추적할 예정입니다. 현재는 본 Export 기능으로 수동 백업하세요.
</Info>

### TIP/주의

<Info>
  . **시스템 프롬프트 작성**: 명확하고 구체적인 지시문을 작성하면 에이전트의 응답 품질이 향상됩니다.
  . **넛지 질문 활용**: 사용자가 에이전트의 기능을 빠르게 파악할 수 있도록 대표적인 질문을 등록하세요.
</Info>

<Warning>
  * **시스템 프롬프트 변경 시 주의**
    **프롬프트 변경은 모든 사용자의 새 대화에 즉시 영향을 미칩니다.** 운영 중인 에이전트의 프롬프트를 변경할 때는 충분한 테스트 후 적용하세요.
</Warning>