청크

청크는 Document 컬렉션의 문서를 검색 가능한 크기로 나눈 결과입니다. 문서 상세에서 원문과 청크 목록을 함께 확인합니다.

화면 예시

청킹 방식

방식	설명
Fixed Size	문서를 설정한 글자 수 기준으로 일정한 크기로 나눕니다.
Sentence	문장이 중간에 잘리지 않도록 문장 단위로 나눕니다.
Paragraph	단락의 내용이 함께 유지되도록 단락 단위로 나눕니다.
Markdown	제목 등 마크다운 문서의 구조를 기준으로 나눕니다.
Structured	표의 헤더와 각 데이터 행을 결합해 독립적으로 나눕니다.

Structured는 JSON, XML, YAML/YML처럼 하나의 표로 변환되는 구조화 데이터 전용입니다. 다른 형식의 파일은 오류로 처리하지 않고 해당 적재에서 생략합니다.

청크 오버랩은 Fixed Size와 Sentence에서 필수 입력입니다. 0 이상, 청크 크기 미만의 값을 입력하며 0은 겹침 없음을 의미합니다. Paragraph·Markdown·Structured는 오버랩을 사용하지 않으므로 입력이 비활성화됩니다. 청크 크기는 1000자를 권장하며, 컬렉션을 만든 뒤 실제 질문으로 검색 테스트를 수행해 설정을 조정하세요.

적재 실행 화면에는 컬렉션의 현재 청킹 설정이 읽기 전용으로 표시됩니다. Structured 컬렉션은 선택한 범위에서 .json, .xml, .yaml, .yml 파일만 적재합니다.

문서 상세 작업

작업	설명
보기 전환	원문과 청크를 Markdown 또는 Raw 형태로 확인합니다.
수정	개별 청크 내용을 편집합니다.
분할	하나의 청크를 여러 청크로 나눕니다.
병합	선택한 청크를 하나로 합칩니다.
복사	청크 내용을 클립보드에 복사합니다.

현재 제공 범위

청크 삭제 메뉴는 표시되지만 현재 구현에서는 준비 중 안내가 표시됩니다. 문서 자체의 삭제는 컬렉션의 문서 목록에서 수행할 수 있습니다.

검색 품질 점검

청크가 너무 작으면 필요한 문맥이 흩어지고, 너무 크면 관련 없는 내용이 함께 검색될 수 있습니다. 검색 테스트에서 정답 근거가 포함된 청크가 상위에 나오는지 확인하고 청킹 방식, 크기, 오버랩을 조정하세요.

관련 문서

• 컬렉션
• 검색 테스트
• Rerank 설정