파일 업로드
지식 상세 화면에서 PDF·DOCX 같은 문서 파일을 업로드합니다. 처리가 끝나면 문서 내용이 검색과 AI 채팅에 사용됩니다.
지원 파일 형식
| 형식 | 확장자 |
|---|---|
.pdf | |
| Word | .docx |
| PowerPoint | .pptx |
| Excel | .xlsx |
| CSV | .csv |
| HTML | .html |
| 텍스트 | .txt |
| 마크다운 | .md |
지원하지 않는 확장자의 파일은 업로드 목록에 추가되지 않습니다.
업로드 화면
지식 상세 페이지의 문서 탭에서 문서 추가 → 파일 업로드를 선택합니다.
업로드는 3단계 절차로 진행합니다.
| 단계 | 이름 | 설명 |
|---|---|---|
| 1단계 | 파일 업로드 | 파일을 선택하고 파싱 옵션을 설정합니다. |
| 2단계 | 청킹 설정 | 청킹 전략과 값을 설정합니다. |
| 3단계 | 검토 및 제출 | 인덱싱 옵션을 확인하고 파일을 제출합니다. |
1단계: 파일과 메타데이터 입력하기
파일 선택 영역에 파일을 끌어다 놓거나 영역을 눌러 파일을 선택합니다.
- 다중 파일 업로드: 여러 파일을 동시에 선택하거나 끌어 추가합니다.
- 파일 제거: 추가한 파일은 목록에서 개별로 제거합니다.
- 형식 필터링: 지원하지 않는 파일 형식은 목록에서 제외됩니다.
- 파일별 메타데이터: 문서 메타데이터 영역에서 파일별 이름(필수), 별칭, 설명, 태그를 입력합니다. 별칭·설명·태그의 AI 제안 버튼을 누르면 초안이 표시됩니다. 입력한 메타데이터는 문서 목록에 표시됩니다.
이 단계에서는 파일별 메타데이터와 함께 공용 파싱 옵션을 설정합니다.
단계 간 옵션 보존
1~3단계를 이동해도 파싱 옵션, 청킹 옵션, 파일별 메타데이터 입력값이 유지됩니다. 이전 단계에서 청킹 설정을 바꾸면 미리보기에 변경 결과가 표시됩니다.
처리 옵션
파싱 옵션 (1단계)
파싱 옵션은 문서에서 텍스트를 추출하는 방법을 제어합니다.
| 옵션 | 설명 | 기본값 | 비고 |
|---|---|---|---|
| 테이블 구조 파싱 | 문서 안의 표 구조를 유지해 추출합니다. | 활성화 | 켜기/끄기 |
| 테이블 모드 | 표 추출 방식을 선택합니다. | 빠름 | 빠름 또는 정확 |
| OCR 활성화 | 이미지 속 글자를 인식합니다. | 비활성화 | 켜기/끄기 |
| OCR 엔진 | 사용할 글자 인식 엔진을 선택합니다. | 자동 | 아래 표 참조 |
| 타임아웃 (초) | 파싱을 기다릴 최대 시간을 지정합니다. | 90 | 10~600 |
OCR 엔진 옵션
글자 인식(OCR)에 사용할 엔진을 선택합니다. 자동은 파일 형식에 따라 엔진을 선택합니다.
| 엔진 | 설명 |
|---|---|
| 자동 | 파일 형식에 따라 처리 엔진을 선택합니다. |
| Tesseract | Tesseract 엔진을 사용합니다. |
| EasyOCR | EasyOCR 엔진을 사용합니다. |
| RapidOCR | RapidOCR 엔진을 사용합니다. |
청킹 옵션 (2단계)
청킹 옵션은 추출된 텍스트를 검색 단위인 청크로 나누는 방식을 정합니다. 전략과 값의 선택 기준은 청킹 및 검색 옵션에서 확인합니다.
2단계의 청크 미리보기 패널에는 현재 설정으로 나눈 결과가 표시됩니다. 인덱싱하기 전에 청크 크기와 분할 위치를 확인합니다.
인덱싱 옵션 (3단계)
인덱싱 옵션에서 문서에 적용할 검색 모드를 설정합니다.
표시되는 검색 방식은 지식 설정에 따라 달라집니다. 각 방식의 차이는 청킹 및 검색 옵션에서 확인합니다.
업로드 후 상태 모니터링
파일을 제출하면 파싱, 청킹, 인덱싱이 시작됩니다. 문서 목록에서 각 문서의 현재 상태를 확인합니다.
문서 상태
| 상태 | 색상 | 설명 |
|---|---|---|
| 대기 중 | 파랑 | 처리를 기다립니다. |
| 준비 중 | 파랑 | 처리를 준비합니다. |
| 처리 중 | 파랑(애니메이션) | 파싱·청킹·인덱싱을 진행합니다. |
| 완료 | 초록 | 인덱싱이 끝났습니다. |
| 일시 정지 | 노랑 | 처리가 일시 정지된 상태입니다. |
| 실패 | 빨강 | 오류로 처리가 중단되었습니다. |
| 취소됨 | 회색 | 사용자가 처리를 취소했습니다. |
| 재인덱싱 중 | 파랑(애니메이션) | 재인덱싱을 진행합니다. |
진행 중인 상태(대기 중·준비 중·처리 중·재인덱싱 중)의 문서는 5초 간격으로 최신 상태를 자동 갱신합니다.
상태별 작업
- 처리 중: 중지 버튼이 표시됩니다.
- 일시 정지: 재인덱싱 버튼이 표시됩니다.
- 완료: 재인덱싱 버튼이 표시됩니다.
- 실패: 오류 메시지와 재인덱싱 버튼이 표시됩니다.
- 취소됨: 재인덱싱 버튼이 표시됩니다.
문서 상세 페이지
업로드가 완료된 문서를 클릭하면 상세 페이지가 열립니다. 이 페이지에는 다음 정보와 작업이 표시됩니다.
- 인덱싱 상태 카드: 현재 처리 상태와 진행 정보를 표시합니다.
- 청크 목록: 생성된 청크를 페이지 단위로 표시합니다.
- 파일 다운로드: 원본 파일을 내려받습니다.
- 재인덱싱: 저장된 옵션으로 문서를 다시 처리합니다.
표가 있거나 이미지로 된 문서는 청크 미리보기에서 빠름과 정확, OCR 적용 결과를 비교한 뒤 설정을 선택합니다.
처리가 제한 시간을 넘겨 실패하면 타임아웃 (초) 값을 늘린 뒤 다시 업로드합니다.
다음 단계
- 지식 관리 수동 문서 — 텍스트를 직접 입력해 문서를 추가합니다.
- 지식 관리 웹 수집 — URL에서 문서를 수집합니다.
- 지식 관리 검색 테스트 — 인덱싱된 문서가 예상대로 검색되는지 확인합니다.