문서·청크 관리

문서·청크 관리 (Manage Knowledge Content)

문서(Documents) 관리

지식 베이스에서 가져온 각 항목 — 로컬 파일이든, Notion 페이지든, 웹페이지든 — 은 하나의 문서(document) 가 돼요.

문서 목록에서 이 모든 문서를 조회·관리해서 지식이 정확하고 관련성 있으며 최신 상태를 유지하게 할 수 있어요.

작업 설명
Add(추가) 새 문서를 가져와요.
Modify Chunk Settings(청크 설정 수정) 문서의 청킹 설정을 수정해요(청크 구조는 제외). 각 문서는 자신만의 청킹 설정을 가질 수 있지만, 청크 구조는 지식 베이스 전체가 공유하며 만들고 나면 바꿀 수 없어요.
Delete(삭제) 문서를 영구 삭제해요. 삭제는 되돌릴 수 없어요.
Enable / Disable(활성/비활성) 문서를 검색에서 일시적으로 포함하거나 제외해요. 일정 기간 업데이트되거나 검색되지 않은 문서는 성능 최적화를 위해 자동으로 비활성화돼요. 비활성 기간은 플랜별로 달라요 — Sandbox: 7일, Professional & Team: 30일. Professional·Team 플랜에서는 비활성화된 문서를 한 번의 클릭으로 다시 활성화할 수 있어요.
Archive / Unarchive(보관/보관 해제) 검색에 더 필요 없지만 보관하고 싶은 문서를 보관해요. 보관된 문서는 읽기 전용이며 언제든 보관을 해제할 수 있어요.
Edit(편집) 청크를 편집해 문서 콘텐츠를 수정해요. 자세한 내용은 아래 '청크 관리'를 참고해요.
Rename(이름 변경) 문서 이름을 바꿔요.

청크(Chunks) 관리

청크 설정에 따라 모든 문서는 검색의 기본 단위인 콘텐츠 청크로 분할돼요.

문서 안의 청크 목록에서 모든 청크를 조회·관리해 검색 효율과 정확도를 높일 수 있어요.

작업 설명
Add(추가) 새 청크를 하나 또는 여러 개(배치) 추가해요. Parent-child 모드로 분할된 문서에서는 새 부모·자식 청크를 모두 추가할 수 있어요. 청크 추가는 Professional·Team 플랜에서만 가능해요.
Delete(삭제) 청크를 영구 삭제해요. 삭제는 되돌릴 수 없어요.
Enable / Disable(활성/비활성) 청크를 검색에서 일시적으로 포함하거나 제외해요. 비활성화된 청크는 편집할 수 없어요.
Edit(편집) 청크 콘텐츠를 수정해요. 편집된 청크는 Edited로 표시돼요. Parent-child 청크 모드에서는: 부모 청크를 편집하면 자식 청크를 재생성하거나 그대로 둘지 선택할 수 있고, 자식 청크를 편집해도 부모 청크는 갱신되지 않아요.
Add / Edit / Delete Keywords(키워드) 청크의 키워드(최대 10개)를 추가하거나 수정해서 검색 가능성을 높여요. Economical 인덱스 방법을 쓰는 지식 베이스에서만 사용할 수 있어요.
Add / Delete Image Attachments(이미지 첨부) 문서에서 추출된 이미지를 제거하거나 해당 청크에 새 이미지를 업로드해요. 추출된 이미지의 URL은 청크 텍스트에 남지만 안전하게 제거할 수 있어요 — 추출된 이미지에는 영향이 없어요. 각 청크는 최대 10개의 이미지 첨부를 가지며, 검색 시 함께 반환돼요. 한도를 넘는 이미지는 추출되지 않아요. 멀티모달 임베딩 모델(Vision 아이콘)을 선택하면 추출된 이미지도 임베딩·인덱싱되어 검색에 사용돼요.
Add / Edit / Delete Summary(요약) 청크의 요약을 추가·수정·제거해요. 요약도 임베딩·인덱싱되어 검색에 사용돼요. 요약이 쿼리와 매칭되면 해당 청크도 함께 반환돼요. 여러 청크에 동일한 요약을 추가하면 그룹 검색이 가능해져 관련 청크들이 함께 반환돼요(Top K 한도 적용).

모범 사례(Best Practices)

요약으로 쿼리-콘텐츠 간극 메우기

High-Quality 인덱싱이 의미 검색을 가능하게 하지만, 원본 청크가 너무 특정적이거나 노이즈가 많거나 구조가 복잡해 사용자 쿼리와 잘 매칭되지 않을 때는 여전히 검색이 어려울 수 있어요.

요약(summary) 은 청크의 핵심 의도를 명시적으로 드러내는 압축된 의미 계층을 제공해 이 간극을 메워 줘요.

  • 원본 텍스트가 비-텍스트적일 때: 청크가 주로 코드·표·로그·대본처럼 의미적으로 매칭하기 어려운 내용이라면, 그 청크가 무엇을 담고 있는지 명확히 설명하는 서술형 요약을 추가해요.

출처: 공식 문서 - Manage Knowledge Content

더 알아보기 (Learn more)