> For the complete documentation index, see [llms.txt](https://kakaowork.gitbook.io/kakao-work/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kakaowork.gitbook.io/kakao-work/workservice/ai/undefined-1/undefined.md).

# 지식베이스 관리

## 지식베이스란?

카카오워크AI 지식베이스란, 카카오워크 내 지식검색에 사용되는 기반 데이터입니다. 지식베이스 내에 쌓인 데이터를 기반으로 메신저에서 카카오워크AI가 사용자 질의에 따른 답변을 제공합니다.

## 지식베이스 목록

지식베이스 관리 페이지는 아래 권한에 따라 접근 및 등록이 가능합니다.

※ 지식베이스 등록은 '봇 개발자' 권한이 있어야 가능합니다.  '[봇(Bot) 관리](https://kakaowork.gitbook.io/kakao-work/basic/admin/work-service/bot)' 메뉴를 참고해주세요. 

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

<table><thead><tr><th width="228.0078125">구분</th><th>설명</th></tr></thead><tbody><tr><td>⓵ 지식베이스 탭</td><td><p>사내검색 설정에 필요한 기능 탭</p><ul><li>default : 지식베이스 목록</li><li>제공 목록 : 지식베이스 목록, 기본 정보, 검색 설정, 답변 설정</li></ul></td></tr><tr><td>⓶ 지식베이스 검색</td><td><p>지식베이스명으로 검색</p><ul><li>검색 결과 목록 하단 노출</li></ul></td></tr><tr><td>⓷ 지식베이스 등록</td><td>클릭 시 등록 화면으로 이동</td></tr><tr><td>⓸ 지식베이스 목록 ▼</td><td>등록된 지식베이스 목록</td></tr><tr><td>지식베이스 명</td><td><p>등록된 지식베이스의 이름</p><ul><li>클릭 시 상세 화면으로 이동</li></ul></td></tr><tr><td>등록자</td><td>지식베이스를 등록한 사용자 계정</td></tr><tr><td>등록일</td><td>지식베이스가 등록된 날짜</td></tr><tr><td>카테고리</td><td>MCP가 속한 카테고리 표시<br>- 카테고리 유형 : 전자결재, 캘린더, 이메일, 프로젝트 관리, 기타</td></tr><tr><td>관리</td><td><p>지식베이스 관리 기능</p><ul><li>'수정' 버튼 클릭 시 수정 화면으로 이동</li><li>'삭제' 버튼 클릭 시 컨펌메시지 노출 및 삭제 가능</li></ul></td></tr><tr><td>사용 여부</td><td><p>지식베이스 사용/미사용 처리 토글 버튼</p><ul><li>사용 여부 on/off 가능</li><li>사용 여부 'on' 시 지식베이스 포함</li><li>사용 여부 'off' 시 지식베이스 포함하지 않음</li></ul></td></tr></tbody></table>

## 지식베이스 등록

지식베이스 등록하기 버튼을 클릭하여 신규 지식베이스를 등록할 수 있습니다.

{% stepper %}
{% step %}

### Step.1 지식베이스 정보 입력

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

| 구분                 |                                                              |
| ------------------ | ------------------------------------------------------------ |
| ⓵ 기본 정보 입력         | 지식베이스의 기본 정보 입력 영역                                           |
| 지식베이스 명            | <p>등록할 지식베이스의 이름 입력 (필수)</p><ul><li>최대 50자까지 입력 가능</li></ul> |
| 지식베이스 설명 (Summary) | <p>지식베이스의 주요 내용을 간략히 설명</p><ul><li>최대 100자까지 입력 가능</li></ul> |
| 등록자                | <p>지식베이스를 등록하는 사용자 계정</p><ul><li>로그인 계정 기반 자동 노출</li></ul>   |
| 연결 대상              | 지식베이스가 연결될 대상                                                |
| {% endstep %}      |                                                              |

{% step %}

### Step.2 지식베이스 정보 입력

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

<table><thead><tr><th width="343">구분</th><th>설명</th></tr></thead><tbody><tr><td>⓵ 데이터 등록</td><td>지식베이스에 등록할 데이터 업로드 영역</td></tr><tr><td>파일 업로드</td><td><p>지식베이스로 사용할 파일 업로드 (필수)</p><ul><li>클릭하여 파일 선택 또는 드래그 앤 드롭으로 업로드 가능</li><li>지원 형식 : PDF, DOCX, XLSX, PPTX, HTML, CSV, TXT, JSON</li><li>단일 파일 크기 제한 : 10MB</li><li>1회당 업로드 가능 개수 : 30개</li></ul></td></tr><tr><td>텍스트 분할 설정</td><td>업로드한 문서를 청크 단위로 분할하는 설정 영역</td></tr><tr><td>⓶ 데이터 분할 방식</td><td><p>문서를 청크로 나누는 전략 선택</p><ul><li>분할 방식 유형 : Fixed Length Chunking 등</li></ul></td></tr><tr><td> 청크 크기(Chunk Size)</td><td><p>한번에 자르는 글자(토큰) 단위 설정</p><ul><li>설정 범위 : 100 ~ 2000</li><li>크기가 클수록 풍부한 문맥을 포함하지만, 검색 시 불필요한 정보가 섞일 수 있음</li></ul></td></tr><tr><td>오버랩(Overlap)</td><td><p>인접한 청크 간 겹치는 토큰 수 설정</p><ul><li>설정 범위 : 0 ~ 512</li><li>문맥 연속성을 유지하는 데 도움이 됨</li></ul></td></tr></tbody></table>
{% endstep %}
{% endstepper %}

## 지식베이스 정보

목록에서 지식베이스를 클릭할 경우, 해당 지식베이스에 대한 상세 정보를 볼 수 있는 페이지로 이동합니다.

<figure><img src="/files/7tyzIXMOU15Jr3h0LjFE" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="228.0078125">구분</th><th>설명</th></tr></thead><tbody><tr><td>⓵ 지식베이스명</td><td>심조회 중인 지식베이스의 이름 노출</td></tr><tr><td>⓶ 기본 정보</td><td>지식베이스의 기본 정보 영역</td></tr><tr><td>지식베이스명</td><td>등록된 지식베이스의 이름</td></tr><tr><td>소스타입</td><td>지식베이스 데이터 소스 유형</td></tr><tr><td>등록자</td><td>지식베이스를 등록한 사용자 계정</td></tr><tr><td>등록일자</td><td>지식베이스가 등록된 일시</td></tr><tr><td>최근 수정 일자</td><td>지식베이스가 마지막으로 수정된 일시</td></tr><tr><td>사용 여부</td><td>지식베이스의 현재 사용 상태 표시</td></tr><tr><td>⓷ 데이터 정보</td><td>지식베이스에 포함된 데이터 정보 영역</td></tr><tr><td>전체 파일 개수</td><td>지식베이스에 등록된 전체 파일 수</td></tr><tr><td>전체 용량</td><td>지식베이스에 등록된 전체 파일의 용량</td></tr><tr><td>총 청크 개수</td><td>지식베이스 내 생성된 전체 청크 수</td></tr><tr><td>⓸ 목록으로</td><td>클릭 시 지식베이스 목록 화면으로 이동</td></tr></tbody></table>

## 기본 정보 탭

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

<table><thead><tr><th width="228.0078125">구분</th><th>설명</th></tr></thead><tbody><tr><td>⓵ 호출 명령어 설정</td><td><p></p><p>사용자가 지식검색AI를 호출할 때 사용할 명칭을 설정</p><ul><li>예 : '사내검색 AI', '지식큐' 등</li></ul></td></tr></tbody></table>

## 검색 설정 탭

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

<table><thead><tr><th width="228.0078125">구분</th><th>설명</th></tr></thead><tbody><tr><td>⓵ 하이브리드 검색 설정</td><td>키워드와 의미 사이 검색 비율을 조절하는 영역</td></tr><tr><td>검색 비중 조절</td><td><p>키워드 검색과 의미 검색 간의 가중치 설정</p><ul><li>설정 범위 : 0 (키워드) ~ 1.0 (의미)</li><li>0에 가까울수록 키워드 기반 검색, 1에 가까울수록 의미 기반 검색</li></ul></td></tr><tr><td>검색 문서 수(Top-K)</td><td><p>검색 시 반환할 최대 문서 개수</p><ul><li>설정 범위 : 0 ~ 100 EA</li></ul></td></tr><tr><td>검색 점수 임계값(Threshold)</td><td><p>검색 결과의 정밀도 설정</p><ul><li>설정 범위 : 0.00 ~ 1.00</li><li>값을 높일수록 질문과 가장 관련이 깊은 문서만 까다롭게 골라냄</li><li>값을 낮추면 더 폭넓은 결과를 보여줌</li></ul></td></tr><tr><td>⓶ 리랭킹 설정</td><td>검색된 문서를 재정렬하여 더 관련성 높은 결과를 제공하는 영역</td></tr><tr><td>등록일자</td><td>지식베이스가 등록된 일시</td></tr><tr><td>리랭킹 활성화</td><td><p>리랭킹 기능 사용 여부 토글 버튼</p><ul><li>on/off 가능</li><li>'on' 시 리랭킹 기능 적용</li><li>'off' 시 리랭킹 기능 미적용</li></ul></td></tr><tr><td>최종 문서 수(Top-N)</td><td><p>리랭킹 후 최종적으로 반환할 문서의 개수 (Top-K 이하)</p><ul><li>설정 범위 : 0 ~ 20 EA</li></ul></td></tr></tbody></table>

## 답변 설정 탭

<figure><img src="/files/29WDhBRNrGuo49NiaeNY" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="228.0078125">구분</th><th>설명</th></tr></thead><tbody><tr><td>⓵ 언어 모델 설정</td><td>답 생성에 사용될 LLM 모델과 파라미터를 설정하는 영역</td></tr><tr><td>LLM 모델 선택</td><td><p></p><p>답변 생성에 사용할 LLM 모델 선택</p><ul><li>드롭다운에서 제공되는 모델 중 선택 (gemini-3.1-flash-lite 고정)</li></ul></td></tr><tr><td>답변 온도(Temperature)</td><td><p>답변 생성 시 일관성과 창의성 조절</p><ul><li>설정 범위 : 0.0 ~ 1.0</li><li>낮을수록 일관된 답변, 높을수록 창의적인 답변 생성</li></ul></td></tr><tr><td>답변 길이 제한(maxOutputTokens)</td><td><p>한 번의 답변에서 생성될 최대 길이 설정</p><ul><li>설정 범위 : 1,000 ~ 20,000 tokens</li><li>값이 너무 작으면 답변이 도중에 끊길 수 있음</li><li>값이 너무 크면 답변 속도가 느려질 수 있음</li></ul></td></tr><tr><td>⓶ 시스템 프롬프트</td><td><p>LLM의 답변 스타일과 방식을 결정하는 지침 입력 영역</p><ul><li>지식검색AI의 역할과 행동을 정의하는 시스템 프롬프트 입력</li><li>최대 2,000자까지 입력 가능</li><li>예 : "당신은 친절한 IT 기술 지원 전문가입니다. 전문 용어는 쉽게 풀어서 설명해 주세요."</li></ul></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://kakaowork.gitbook.io/kakao-work/workservice/ai/undefined-1/undefined.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.