파일 업로드
GenD 인제스천 모듈은 다양한 형식의 파일을 업로드하여 데이터 파이프라인에 투입하는 기능을 제공합니다. 업로드된 파일은 자동으로 파싱되고, 청킹 정책에 따라 처리됩니다.
지원 파일 형식
- 문서: PDF, DOCX, HWP, TXT
- 스프레드시트: XLSX, CSV
- 이미지: PNG, JPG, TIFF (OCR 처리)
- 오디오: MP3, WAV (STT 변환)
:::caution 이 화면은 사이드바에 없습니다
아래 절차의 화면은 /ingestion/legacy 입니다. 사이드바 데이터 엔지니어링 > 파일·문서 수집
(/ingestion) 은 신형 수집 허브(파이프라인·실행·문서 탭)로 교체되었고, 파일 업로드와
청킹 정책 UI 는 아직 구 화면에만 있습니다. 주소를 직접 입력해 접근하세요
(#3310 — IA 정리 예정).
:::
업로드 절차
/ingestion/legacy의 파일 탭에서 파일 업로드 버튼을 클릭합니다- 업로드할 파일을 선택하거나 드래그 앤 드롭합니다
- 청킹 정책과 메타데이터 태그를 지정합니다(선택사항)
- 업로드 버튼을 클릭합니다
- 파일이 자동으로 파싱되고 처리 상태를 확인할 수 있습니다
파일 처리 흐름
업로드된 파일은 다음 순서로 처리됩니다:
- 파일 저장 (SeaweedFS/Ceph RGW)
- 형식별 파서를 통한 텍스트 추출
- 청킹 정책에 따른 텍스트 분할
- 벡터 임베딩 생성 (RAG 검색용)
API 엔드포인트
| Method | Path | Description |
|---|---|---|
| POST | /api/v1/ingestion/upload | 파일 업로드 |
| GET | /api/v1/ingestion/files | 업로드된 파일 목록 조회 |
| GET | /api/v1/ingestion/files/{file_id} | 파일 상세 조회 |
| DELETE | /api/v1/ingestion/files/{file_id} | 파일 삭제 |