문서 관리

GenD의 문서 관리 기능은 문서 프로세서 설정을 통해 업로드된 문서의 처리 방식을 제어합니다. 로컬 프로세서와 GenOS 프로세서 중 선택하여 문서를 처리할 수 있습니다.

주요 기능

• 프로세서 설정 관리: 문서 처리에 사용할 프로세서 유형과 설정을 정의합니다
• 로컬 프로세서: GenD 내장 파서를 사용한 문서 처리 (PDF, DOCX, HWP 등)
• GenOS 프로세서: GenOS Document Processing 서비스와 연동한 고급 처리
• 프로세서 테스트: 설정이 올바르게 동작하는지 사전 테스트할 수 있습니다

프로세서 유형

유형	설명	사용 시나리오
local	GenD 내장 파서 사용	기본 문서 처리
genos	GenOS 서비스 연동	고급 AI 기반 문서 분석

사용 방법

:::caution 문서 프로세서 설정에는 UI 가 없습니다 사이드바 어디에도 「문서 프로세서」 메뉴는 없습니다. 설정은 API 로만 관리합니다 (#3310 — UI 제공 여부는 IA 결정 대기). :::

1. 설정 생성 — POST /api/v1/document-processor/configs (admin)

   curl -X POST "$GEND/api/v1/document-processor/configs" \
     -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
     -d '{
       "name": "pdf-local",
       "provider_type": "local",
       "file_types": ["pdf"],
       "priority": 10,
       "include_chunking": true,
       "include_embedding": false,
       "enabled": true
     }'

   provider_type 은 local(내장) 또는 genos(GenOS API) 만 허용됩니다. 프로세서별 세부 옵션은 config_json 에 넣습니다.

2. 설정 확인 — GET /api/v1/document-processor/configs 로 등록된 구성을 조회합니다.

3. 시험 실행 — POST /api/v1/document-processor/test 에 파일을 multipart 로 올려 실제 파싱·청킹 결과를 확인합니다. chunk_size(10010000) · overlap(0500) 은 쿼리 파라미터입니다.

   curl -X POST "$GEND/api/v1/document-processor/test?chunk_size=1000&overlap=100" \
     -H "Authorization: Bearer $TOKEN" -F "file=@sample.pdf"

4. 파일 업로드 시 file_types · priority 에 따라 해당 프로세서 설정이 자동 선택됩니다.

API 엔드포인트

Method	Path	Description
POST	/api/v1/document-processor/configs	프로세서 설정 생성
GET	/api/v1/document-processor/configs	프로세서 설정 목록 조회
GET	/api/v1/document-processor/configs/{config_id}	프로세서 설정 상세 조회
DELETE	/api/v1/document-processor/configs/{config_id}	프로세서 설정 삭제
POST	/api/v1/document-processor/test	프로세서 테스트

관련 문서

• 파일 업로드
• 외부 파서
• 문서 관리 (RAG)