> For the complete documentation index, see [llms.txt](https://help.genser.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.genser.ai/knowledge/cs.md).

# CS 지식 관리

{% hint style="info" %}
**젠서 디스커버리 전용 기능**입니다.
{% endhint %}

CS 지식 관리는 에이전트가 고객 문의에 답변할 때 활용할 지식을 등록·관리하는 페이지입니다. 문서와 웹페이지로 등록하며, 에이전트는 등록한 지식을 바탕으로 답변합니다.

## **1. 지식 등록 방식**

지식은 두 가지 방식으로 등록하며, 각각 **문서** 탭과 **웹페이지** 탭에서 관리합니다.

<table><thead><tr><th width="160">구분</th><th>무엇을 등록하나</th><th>답변에 어떻게 쓰이나</th></tr></thead><tbody><tr><td><strong>문서</strong></td><td>파일을 업로드</td><td>문서 내용을 답변에 직접 활용합니다.</td></tr><tr><td><strong>웹페이지</strong></td><td>페이지 주소(URL)를 등록</td><td>관련 질문에 링크를 안내하거나(링크 안내), 페이지 내용을 답변에 활용합니다(내용 반영).</td></tr></tbody></table>

{% hint style="warning" %}
등록 한도(문서·웹페이지 각 최대 300개)는 상한일 뿐 권장값이 아닙니다. 답변에 활용되는 자료가 많을수록 에이전트가 골라야 할 후보가 늘어 답변 정확도가 떨어지고 느려질 수 있습니다. 한도 안에서도 답변에 **꼭 필요한 지식만** 등록해 주세요.
{% endhint %}

***

## **2. 문서**

<figure><img src="/files/TFdyZQRrebDI0OljFAZ2" alt=""><figcaption></figcaption></figure>

### **2-1. 등록**

문서를 업로드하면 내용을 처리(학습)한 뒤 답변에 반영됩니다. 처리에는 보통 수 분, 길어도 10분 안팎이 걸립니다.

<figure><img src="/files/czwpTR2DCXnHT6GeQa1k" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="160">항목</th><th>정책</th></tr></thead><tbody><tr><td><strong>파일 형식</strong></td><td>TXT, Markdown, PDF, HTML, DOCX, PPTX, XLSX, XLSM</td></tr><tr><td><strong>파일 용량</strong></td><td>파일당 최대 30MB</td></tr><tr><td><strong>파일 개수</strong></td><td>한 번에 50개, 전체 300개까지</td></tr></tbody></table>

{% hint style="info" %}
같은 파일명·확장자의 파일을 다시 업로드하면 기존 문서를 교체할지 선택할 수 있습니다. (교체하면 중복으로 쌓이지 않습니다.)
{% endhint %}

### **2-2. 상태**

<table><thead><tr><th width="160">상태</th><th>의미</th></tr></thead><tbody><tr><td><strong>학습 중</strong></td><td>내용을 처리하는 중입니다. 아직 답변에 반영되지 않습니다.</td></tr><tr><td><strong>답변 반영</strong></td><td>처리가 끝나 답변에 활용되고 있습니다.</td></tr><tr><td><strong>답변 제외</strong></td><td>답변에 활용하지 않습니다.</td></tr><tr><td><strong>제외 중</strong></td><td>답변에서 제외하는 처리 중입니다. 잠시 후 '답변 제외'로 바뀝니다.</td></tr><tr><td><strong>반영 실패</strong></td><td>처리에 실패했습니다. 다시 시도할 수 있습니다.</td></tr></tbody></table>

### **2-3. 답변 반영 관리**

문서별로 행 끝의 메뉴에서 답변에 활용할지 켜고 끌 수 있습니다.

* **답변에서 제외**: 답변에 활용하지 않습니다. 제외 처리에는 잠시 시간이 걸립니다.
* **답변에 반영**: 제외했던 문서를 다시 활용합니다. 다시 처리(학습)를 거칩니다.
* **다시 시도**: 반영에 실패한 문서를 다시 처리합니다.

### **2-4. 미리보기·다운로드·삭제**

* **미리보기**: 등록한 문서를 어드민에서 미리볼 수 있습니다. DOCX·PPTX·XLSX·XLSM 형식은 미리보기가 제공되지 않습니다.
* **다운로드**: 등록한 파일을 내려받을 수 있습니다.
* **삭제**: 삭제하면 답변에서 바로 제외되며, 되돌릴 수 없습니다.

***

## **3. 웹페이지**

<figure><img src="/files/4N9YIzzPr4bdksQ6TvjC" alt=""><figcaption></figcaption></figure>

### **3-1. 등록**

<figure><img src="/files/EyFkilY3GMxLj5tHtTVN" alt=""><figcaption></figcaption></figure>

#### **등록 유형**

<table><thead><tr><th width="160">구분</th><th>링크 안내</th><th>내용 반영</th></tr></thead><tbody><tr><td><strong>답변 활용 방식</strong></td><td>관련 질문에 링크를 함께 안내합니다(페이지 내용은 답변에 담기지 않습니다).</td><td>페이지 내용을 가져와 답변에 직접 활용합니다.</td></tr><tr><td><strong>한 번에 등록</strong></td><td>한 건씩</td><td>관련 페이지를 한 세트에 최대 5개까지</td></tr><tr><td><strong>답변 반영</strong></td><td>바로 반영됩니다.</td><td>내용을 처리(학습)한 뒤 반영됩니다.</td></tr></tbody></table>

#### **입력 항목**

<table><thead><tr><th width="160">항목</th><th>설명</th></tr></thead><tbody><tr><td><strong>URL</strong></td><td>안내하거나 내용을 가져올 페이지 주소입니다.</td></tr><tr><td><strong>웹페이지명</strong></td><td>페이지를 구분하는 이름으로, 질문과 연결할 때 쓰입니다.</td></tr><tr><td><strong>설명</strong></td><td>페이지의 핵심 주제·키워드입니다. 질문과 연결할 때 쓰입니다. (링크 안내는 필수, 내용 반영은 선택)</td></tr><tr><td><strong>유효기간</strong></td><td>한시적으로 운영하는 페이지의 답변 참조 기간입니다. (선택)</td></tr></tbody></table>

{% hint style="info" %}
링크 안내는 입력한 **웹페이지명·설명**으로만 질문과 연결합니다. 고객이 실제로 쓰는 표현으로 적어 주세요.
{% endhint %}

#### **유효기간**

* 설정하지 않으면 상시 답변에 반영됩니다.
* 설정하면 지정한 기간에만 답변에 반영되고, 종료일이 지나면 자동으로 답변에서 제외됩니다.
* 이벤트·시즌처럼 한시적으로 운영하는 페이지에 사용합니다.

### **3-2. 상태**

<table data-search="false"><thead><tr><th width="160">상태</th><th>의미</th></tr></thead><tbody><tr><td><strong>답변 반영</strong></td><td>답변에 활용되고 있습니다.</td></tr><tr><td><strong>반영 예정</strong></td><td>유효기간 시작일이 되면 자동으로 답변에 반영됩니다.</td></tr><tr><td><strong>학습 중</strong></td><td>내용을 처리하는 중입니다.</td></tr><tr><td><strong>답변 제외</strong></td><td>답변에 활용하지 않습니다.</td></tr><tr><td><strong>제외 중</strong></td><td>답변에서 제외하는 처리 중입니다. 잠시 후 '답변 제외'로 바뀝니다.</td></tr><tr><td><strong>기간 만료</strong></td><td>유효기간이 지나 자동으로 제외되었습니다.</td></tr><tr><td><strong>반영 실패</strong></td><td>처리에 실패했습니다. 다시 시도할 수 있습니다.</td></tr></tbody></table>

{% hint style="info" %}
'학습 중'·'제외 중'·'반영 실패'는 내용을 처리하는 **내용 반영 유형**에서만 나타납니다.
{% endhint %}

### **3-3. 답변 반영 관리**

웹페이지별로 행 끝의 메뉴에서 답변에 활용할지 켜고 끌 수 있습니다.

* **답변에서 제외**: 답변에 활용하지 않습니다. 제외 처리에는 잠시 시간이 걸립니다.
* **답변에 반영**: 제외했던 웹페이지를 다시 활용합니다. 내용 반영은 다시 처리(학습)를 거칩니다.
* **다시 시도**: 내용 반영으로 등록한 페이지가 반영에 실패하면 다시 처리합니다.

### **3-4. 미리보기·내용 업데이트·수정·삭제**

* **미리보기**: 내용 반영으로 등록한 페이지는 가져온 내용을 어드민에서 미리볼 수 있습니다.
* **내용 업데이트**: 내용 반영으로 등록한 페이지의 출처가 바뀌었을 때, 같은 URL의 내용을 다시 가져와 반영합니다. 목록에서 여러 항목을 골라 한 번에 업데이트할 수도 있습니다.
* **수정**: 웹페이지명·설명·유효기간은 바로 반영됩니다. 내용 반영에서 URL을 바꾸면 내용을 다시 가져오므로 처리(학습)를 거칩니다.
* **삭제**: 삭제하면 답변에서 바로 제외되며, 되돌릴 수 없습니다.

***

## **4. 답변 확인**

등록한 지식이 실제 답변에 어떻게 반영되는지는 헤더의 [**검색 미리보기**](https://help.genser.ai/products/search-preview)에서 확인할 수 있습니다.

***

## **자주 묻는 질문**

<details>

<summary><strong>Q. 문서나 웹페이지를 등록했는데 답변에 언제 반영되나요?</strong></summary>

문서와 웹페이지 '내용 반영'은 내용을 처리한 뒤 답변에 반영됩니다. 보통 수 분, 길어도 10분 안팎이 걸립니다. 웹페이지 '링크 안내'는 바로 반영됩니다.

</details>

<details>

<summary><strong>Q. 링크 안내와 내용 반영은 무엇이 다른가요?</strong></summary>

링크 안내는 관련 질문에 페이지 링크를 함께 안내하며, 페이지 내용 자체는 답변에 담기지 않습니다. 내용 반영은 페이지 내용을 가져와 답변에 직접 활용합니다.

</details>

<details>

<summary><strong>Q. 특정 문서·웹페이지를 답변에서 빼고 싶습니다.</strong></summary>

해당 항목을 행 끝의 메뉴에서 답변에서 제외하면 됩니다. 다시 활용하려면 답변에 반영으로 되돌릴 수 있습니다.

</details>

<details>

<summary><strong>Q. 반영 실패로 표시됩니다.</strong></summary>

처리에 실패한 상태입니다. 다시 시도해 주세요. 문서는 같은 문제가 반복되면 다른 파일로, 웹페이지는 URL이 올바른지 확인 후 다시 시도해 주세요.

</details>

<details>

<summary><strong>Q. 등록한 페이지 내용이 바뀌면 자동으로 업데이트되나요?</strong></summary>

자동으로 업데이트되지 않습니다. 내용 반영으로 등록한 페이지는 출처가 바뀌면 내용 업데이트로 직접 다시 가져와 주세요.

</details>