수동 문서
지식 상세 화면에서 텍스트를 직접 입력해 수동 문서를 만듭니다. 저장한 내용은 입력한 문서 조각 단위로 검색과 AI 채팅에 사용됩니다.
영역: 수동 문서의 기본 정보와 청크 내용·메타데이터를 함께 입력하는 화면. 예제 텍스트만 사용합니다.
새 수동 문서 생성
지식 상세 페이지의 문서 탭에서 문서 추가 → 수동 문서를 선택합니다.
입력 항목
| 항목 | 필수 | 설명 |
|---|---|---|
| 이름 | 필수 | 메타데이터와 API에서 사용할 문서 식별자 |
| 별칭 | 선택 | 목록에 표시되는 이름. 비우면 이름과 동일하게 설정됩니다. |
| 설명 | 선택 | 문서에 대한 설명 |
| 태그 | 선택 | 분류·검색용 태그 |
| 초기 청크 | 선택 | 첫 번째 청크로 등록될 초기 텍스트 |
별칭·설명·태그는 이름을 입력한 뒤 각 필드의 AI 자동 생성 버튼으로 채울 수 있습니다.
초기 청크를 입력하면 문서를 만들 때 첫 번째 청크가 함께 생성됩니다. 비워두고 만든 뒤 상세 페이지에서 청크를 추가해도 됩니다.
문서 만들기 버튼을 누르면 문서가 만들어지고 상세 페이지로 이동합니다.
수동 문서 상세
문서 목록에서 수동 문서를 선택해 상세 정보와 청크를 관리합니다.
문서 정보
상단 영역에 문서의 기본 정보가 표시됩니다.
| 항목 | 설명 |
|---|---|
| 유형 | 수동 태그 |
| 청크 | 총 청크 수 |
| 생성일 | 생성 일시 |
| 설명 | 현재 화면에서 수정할 수 있는 문서 설명 |
설명은 편집 버튼을 눌러 현재 화면에서 수정합니다.
청크 목록
문서에 포함된 청크가 테이블 형태로 표시됩니다.
| 컬럼 | 설명 |
|---|---|
| 체크박스 | 다중 선택 (일괄 삭제용) |
| # | 청크 순번 |
| 내용 | 청크 내용 두 줄 미리보기 |
| 토큰 | 추정 토큰 수 |
| 작업 | 수정·삭제 버튼 |
청크는 20개씩 페이지로 나눠 표시합니다. 청크가 20개를 넘으면 아래쪽에 페이지 이동 버튼이 나타납니다.
청크 상세 보기
테이블에서 청크 행을 클릭하면 오른쪽에 청크 내용 뷰어 사이드 패널이 열립니다.
- 이동: 이전·다음 청크로 이동합니다. 키보드 화살표 키도 지원합니다.
- 내용: 청크 전체 텍스트를 확인하고 복사합니다.
- 메타데이터: 키와 값으로 저장된 메타데이터를 확인합니다.
- 연결한 청크: 현재 청크에서 다른 청크로 연결한 링크를 표시합니다. 연결 방법은 청크 링크에서 확인합니다.
- 정보: 청크 ID, 저장 위치, 생성·수정 시각을 표시합니다.
청크 관리
청크 추가
청크 추가를 선택하면 청크 편집 창이 열립니다.
창에는 다음 항목이 표시됩니다.
| 항목 | 설명 | 제한 |
|---|---|---|
| 내용 | 청크 텍스트 내용 | 최대 10,000자 |
| 메타데이터 | 키와 값 쌍으로 된 메타데이터 | 필요에 따라 추가·삭제 가능 |
창 아래쪽에는 현재 텍스트의 추정 토큰 수가 표시됩니다.
메타데이터 편집
메타데이터는 키와 값 쌍으로 구성됩니다.
- 메타데이터 추가를 눌러 새 항목을 추가합니다.
- 각 항목의 키와 값을 입력합니다.
- 항목 오른쪽의 삭제 버튼을 누르면 해당 항목이 삭제됩니다.
- 값의 타입은 입력 형태에 따라 자동으로 판별됩니다. 예를 들어
true/false는 참·거짓 값으로, 숫자는 숫자 값으로, JSON 형식의 문자열은 목록이나 구조화된 값으로 인식됩니다.
메타데이터 섹션 헤더의 메타데이터 자동 생성을 누르면 AI가 청크 내용을 바탕으로 주제·키워드·요약을 생성합니다. 청크 내용이 비면 버튼이 비활성화되고 “청크 내용을 먼저 입력하세요”가 표시됩니다. 생성 결과는 아래 병합 방식에 따라 기존 항목에 합쳐집니다.
기존 청크를 수정하거나 AI로 메타데이터를 생성하면 새 항목을 기존 메타데이터에 합칩니다. 기존 키에 새 값을 지정하면 값을 덮어쓰고, 새로운 키는 추가합니다.
청크 수정
청크 테이블이나 청크 내용 뷰어에서 편집을 선택하면 기존 내용과 메타데이터가 입력된 창이 열립니다. 저장한 변경 내용은 검색 색인에 반영됩니다.
내용을 바꾸면 의미 벡터가 다시 만들어집니다.
청크 삭제
청크는 개별 또는 일괄로 삭제합니다.
- 개별 삭제: 청크 행에서 삭제 버튼을 누르고 확인 창에서 작업을 확정합니다.
- 일괄 삭제: 확인란으로 여러 청크를 선택한 뒤 **삭제 (N개)**를 누릅니다.
삭제한 청크는 검색 결과에서 제거됩니다. 이 작업은 되돌릴 수 없습니다.
청크 링크 (연결한 청크)
수동 문서 청크는 같은 지식 안의 다른 수동 문서 청크와 링크로 연결합니다. 청크 내용 뷰어의 연결한 청크 섹션에서 링크를 관리합니다.
- 방향: 링크는 단방향입니다. 이 섹션에는 현재 청크가 가리키는 링크만 표시됩니다. 이 청크를 가리키는 다른 청크의 링크는 표시되지 않습니다.
- 링크 목록: 각 링크 행에는 관계 이름 배지, 대상 청크 내용 미리보기, 속성이 표시됩니다. 오른쪽 삭제 버튼으로 링크를 제거합니다. 대상 청크가 삭제된 경우 "대상 청크를 찾을 수 없습니다"가 표시됩니다.
- 링크 추가: 링크 추가를 선택하면 청크 링크 연결 창이 열립니다.
- 검색 탭: 검색어로 같은 지식의 청크를 찾아 선택합니다.
- 문서 찾아보기 탭: 문서를 고른 뒤 청크 목록에서 선택합니다.
- 대상 청크를 고른 다음 관계 이름(필수, 예:
참고,원인-결과)과 선택적 속성(note,weight등 키와 값)을 입력하고 링크 추가를 누릅니다.
링크 대상은 같은 지식 안의 수동 문서 청크로 제한됩니다. 웹 크롤링·파일 업로드 문서의 청크는 재인덱싱 시 ID가 바뀔 수 있어 대상 후보에서 제외됩니다. 링크는 수동 문서 화면에서만 편집합니다.
청크 링크는 관련 청크를 사람이 직접 연결해 정리하는 기능입니다. 검색·RAG 결과를 자동으로 확장하거나 지식 그래프를 구성하지는 않습니다.
문서 삭제
상세 페이지 헤더에서 삭제를 누르면 수동 문서 전체가 삭제됩니다.
문서를 삭제하면 문서에 포함된 모든 청크가 함께 영구 삭제됩니다. 이 작업은 되돌릴 수 없습니다.
사용 사례
수동 문서는 다음 상황에 사용합니다.
- FAQ 데이터 등록: 질문과 답변을 각각의 청크로 등록합니다.
- 내부 규정·정책 입력: 별도 파일 없이 정책 내용을 직접 입력합니다.
- 기존 시스템의 텍스트 등록: 다른 시스템에서 복사한 텍스트를 청크 단위로 등록합니다.
- AI 채팅 응답 보관: 필요한 응답을 복사해 수동 문서 청크로 등록합니다.
- 짧은 텍스트 보완: 파일로 처리하기 어려운 짧은 메모를 추가합니다.
수동 문서는 소규모 텍스트 데이터에 적합합니다. 대량의 문서 데이터는 파일 업로드로 추가합니다.
다음 단계
- 지식 관리 검색 테스트 — 등록한 청크가 예상대로 검색되는지 확인합니다.
- 지식 관리 AI 채팅 — 검색된 청크를 근거로 질문하고 인용을 확인합니다.