> 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><tr><td><strong>링크</strong></td><td>페이지 주소(URL)와 이름·설명을 등록</td><td>관련 질문에 링크를 안내합니다. 페이지 내용은 가져오지 않습니다.</td></tr></tbody></table>

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

***

## **2. 문서**

<figure><img src="https://2560922032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyYVX6HW5LNuPHRnSB2po%2Fuploads%2Fvq3MIvBGN1ERyEQZWqkM%2FCS%EC%A7%80%EC%8B%9D%EA%B4%80%EB%A6%AC-%EB%8F%84%EC%9B%80%EB%A7%90-%EB%AC%B8%EC%84%9C-%EB%AA%A9%EB%A1%9D.png?alt=media" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://2560922032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyYVX6HW5LNuPHRnSB2po%2Fuploads%2Fni2GYlPGX5fRhL9uGiIJ%2F3-%EB%AC%B8%EC%84%9C%EB%93%B1%EB%A1%9D.png?alt=media" 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>PDF는 파일당 최대 160MB, 그 외 형식은 10MB</td></tr><tr><td><strong>파일 개수</strong></td><td>한 번에 50개, 전체 300개까지</td></tr><tr><td><strong>이미지</strong></td><td>PDF만 이미지까지 학습합니다. 다른 형식은 이미지를 학습하지 않습니다.</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 형식과 5MB가 넘는 텍스트 계열 파일(TXT·MD·HTML)은 미리볼 수 없으니 다운로드해서 확인해 주세요.
* **다운로드**: 등록한 파일을 내려받을 수 있습니다.
* **삭제**: 삭제하면 목록에서 바로 사라집니다. 답변에 쓰이던 내용이 지워지기까지 수 분이 걸릴 수 있으니, [**검색 미리보기**](https://help.genser.ai/overview/search-preview)에서 확인해 주세요. 삭제한 정보는 되돌릴 수 없습니다.

***

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

<figure><img src="https://2560922032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyYVX6HW5LNuPHRnSB2po%2Fuploads%2FeuzzCvNln6aXNpQYPYPI%2FCS%EC%A7%80%EC%8B%9D%EA%B4%80%EB%A6%AC-%EB%8F%84%EC%9B%80%EB%A7%90-%EC%9B%B9%ED%8E%98%EC%9D%B4%EC%A7%80-%EB%AA%A9%EB%A1%9D.png?alt=media" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2560922032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyYVX6HW5LNuPHRnSB2po%2Fuploads%2FslSDcsoa3ieDGaXqOUJj%2FCS%EC%A7%80%EC%8B%9D%EA%B4%80%EB%A6%AC-%EB%8F%84%EC%9B%80%EB%A7%90-%EC%9B%B9%ED%8E%98%EC%9D%B4%EC%A7%80-%EB%93%B1%EB%A1%9D.png?alt=media" alt=""><figcaption></figcaption></figure>

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

<table><thead><tr><th width="160">항목</th><th>설명</th></tr></thead><tbody><tr><td><strong>URL</strong></td><td>내용을 가져올 페이지 주소입니다. 한 줄에 하나씩 입력하며, URL마다 웹페이지가 하나씩 등록됩니다.</td></tr><tr><td><strong>유효기간</strong></td><td>한시적으로 운영하는 페이지의 답변 참조 기간입니다. 한 번에 등록한 URL에는 같은 기간이 적용됩니다. (선택)</td></tr></tbody></table>

#### **등록 정책**

<table><thead><tr><th width="160">항목</th><th>정책</th></tr></thead><tbody><tr><td><strong>URL 개수</strong></td><td>한 번에 300개, 전체 1,000개까지</td></tr><tr><td><strong>이름</strong></td><td>수집한 페이지에서 자동으로 가져옵니다. 처음 수집할 때 한 번 가져오며, 학습이 끝난 뒤 수정할 수 있습니다.</td></tr><tr><td><strong>등록할 수 없는 URL</strong></td><td>http:// 또는 https://로 시작하지 않는 URL, 이미 등록된 URL, 한도를 넘는 URL이 하나라도 있으면 아무것도 등록되지 않습니다.</td></tr></tbody></table>

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

* 설정하지 않으면 상시 답변에 반영됩니다.
* 설정하면 지정한 기간에만 답변에 반영되고, 종료일이 지나면 자동으로 답변에서 제외됩니다.
* 이벤트·시즌처럼 한시적으로 운영하는 페이지에 사용합니다.
* 기간이 지난 뒤 다시 반영하려면 **유효기간을 수정**해 주세요. 답변 반영 스위치로는 되돌릴 수 없습니다.

#### **수집 범위**

등록한 URL에서 **공개된 텍스트**를 가져옵니다. **화면에 보이는 내용과 실제로 가져온 내용이 다를 수 있으므로, 등록 후 미리보기에서 확인해 주세요.**

가져오는 범위는 **입력한 URL의 페이지까지**입니다. 그 아래 하위 페이지는 가져오지 않으므로, 필요한 페이지는 각각 등록해 주세요.

<table><thead><tr><th width="157.18359375">구분</th><th>해당하는 경우</th></tr></thead><tbody><tr><td><strong>가져오지 못하는 페이지</strong></td><td><ul><li>로그인이 필요한 페이지</li><li>사람 확인(캡차) 절차가 있는 페이지</li><li>없는 페이지(주소가 잘못됐거나 삭제된 페이지)</li><li>내용 없이 빈 화면만 나오는 페이지</li></ul></td></tr><tr><td><strong>가져오지 못하는 내용</strong></td><td><ul><li>이미지로 만든 내용(상세 이미지, 사이즈표 등)</li><li>스크롤하거나 더보기를 눌러야 불러오는 내용(무한 스크롤 등)</li><li>다른 서비스에서 불러와 넣은 영역(지도, 동영상 등)</li><li>페이지에 첨부된 파일의 내용</li></ul></td></tr></tbody></table>

가져오지 못하는 페이지는 '반영 실패'로 표시됩니다. 가져오지 못하는 내용이 있는 페이지는 그 내용만 빠진 채 답변에 반영됩니다.

{% hint style="info" %}
이미지는 가져오지 않습니다. 필요한 내용이 빠져 있다면 해당 내용을 PDF로 만들어 **문서** 탭에 등록하거나, **링크** 탭에 링크로 등록해 주세요. PDF는 이미지도 학습합니다.

가져온 내용은 **수집한 시점으로 고정**됩니다. 페이지 내용이 바뀌면 **다시 수집**으로 최신 내용을 가져와 주세요.
{% endhint %}

{% hint style="warning" %}
개인정보가 포함된 페이지(실명 후기, 문의 게시판 등)는 등록하지 않는 것을 권장합니다.

사이트에 보안 솔루션이 적용되어 있거나 특정 지역의 접근이 제한된 경우 페이지 내용을 가져오지 못할 수 있습니다. 이때는 사이트가 봇(자동 수집 프로그램)의 접근을 허용하는지 사이트 담당자에게 확인해 주세요. 확인이 어렵다면 도입 담당자에게 문의해 주세요.
{% 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>처리에 실패했습니다. URL이 올바른지 확인 후 다시 시도해 주세요.</td></tr></tbody></table>

{% hint style="warning" %}
반영 실패가 반복되면 사이트가 봇 접근을 막고 있을 수 있습니다. 봇 접근을 허용하는지 사이트 담당자에게 확인해 주세요.
{% endhint %}

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

웹페이지별로 목록의 **답변 반영 스위치**나 **행 끝 관리 도구**에서 켜고 끌 수 있습니다.

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

### **3-4. 미리보기·다시 수집·수정·삭제**

* **미리보기**: 가져온 내용을 어드민에서 미리볼 수 있습니다.
* **다시 수집**: 페이지 내용이 바뀌었을 때, 같은 URL에서 최신 내용을 다시 가져와 답변에 반영합니다. 목록의 **최근 수집 일시**에서 언제 가져온 내용인지 확인할 수 있습니다. 목록 상단의 **다시 수집**을 누르면 여러 웹페이지를 골라 한 번에 수집할 수 있습니다.
* **수정**: 이름·유효기간을 수정할 수 있습니다. URL은 바꿀 수 없으니 다른 URL은 새로 등록해 주세요.
* **삭제**: 삭제하면 목록에서 바로 사라집니다. 답변에 쓰이던 내용이 지워지기까지 수 분이 걸릴 수 있으니, [**검색 미리보기**](https://help.genser.ai/overview/search-preview)에서 확인해 주세요. 삭제한 정보는 되돌릴 수 없습니다.

***

## **4. 링크**

<figure><img src="https://2560922032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyYVX6HW5LNuPHRnSB2po%2Fuploads%2FvbiNDInRiauxKdwqGE20%2FCS%EC%A7%80%EC%8B%9D%EA%B4%80%EB%A6%AC-%EB%8F%84%EC%9B%80%EB%A7%90-%EB%A7%81%ED%81%AC-%EB%AA%A9%EB%A1%9D.png?alt=media" alt=""><figcaption></figcaption></figure>

링크는 페이지 내용을 가져오지 않고 관련 질문에 페이지 링크를 안내합니다. 로그인이 필요한 페이지나 배송 조회·반품 신청처럼 고객이 직접 확인하거나 진행해야 하는 페이지에 씁니다. 등록하면 바로 답변에 반영됩니다.

### **4-1. 등록**

<figure><img src="https://2560922032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyYVX6HW5LNuPHRnSB2po%2Fuploads%2F7NJuigyMtvlDyAKWlBAG%2FCS%EC%A7%80%EC%8B%9D%EA%B4%80%EB%A6%AC-%EB%8F%84%EC%9B%80%EB%A7%90-%EB%A7%81%ED%81%AC-%EB%93%B1%EB%A1%9D.png?alt=media" alt=""><figcaption></figcaption></figure>

<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 %}

* 최대 300개까지 등록할 수 있습니다.
* 이미 등록된 링크와 URL이나 이름이 같으면 등록할 수 없습니다.

### **4-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></tbody></table>

### **4-3. 답변 반영 관리·수정·삭제**

* **답변에서 제외·답변에 반영**: 목록의 **답변 반영 스위치**나 **행 끝 관리 도구**에서 바꾸며, 바로 반영됩니다.
* **수정**: URL·이름·설명·유효기간을 수정할 수 있고 바로 반영됩니다.
* **삭제**: 삭제하면 목록과 답변에서 바로 빠집니다. 삭제한 정보는 되돌릴 수 없습니다.

***

## **5. 답변 확인**

등록한 지식이 실제 답변에 어떻게 반영되는지는 헤더의 [**검색 미리보기**](https://help.genser.ai/overview/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>

<details>

<summary><strong>Q. 웹페이지를 등록했는데 답변에 그 내용이 나오지 않습니다.</strong></summary>

**미리보기**에서 가져온 내용을 확인해 주세요. 필요한 내용이 이미지나 스크롤·더보기로 불러오는 내용, 다른 서비스에서 불러온 영역에 있으면 가져오지 못합니다. 이 경우 해당 내용을 PDF로 만들어 **문서** 탭에 등록해 주세요. PDF는 이미지도 학습합니다.

</details>