> For the complete documentation index, see [llms.txt](https://genos-docs.gitbook.io/default/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://genos-docs.gitbook.io/default/v1.9.0/admin-management/settings/resource/preprocessor.md).
# 전처리기 관리
## 전처리기 관리
이 화면에서는 **전처리기(Preprocessor)** 를 등록하고 관리할 수 있습니다. 전처리기는 원본 데이터를 AI 모델의 **학습 및 추론에 적합한 형태로 변환**하는 역할을 하며, 데이터 품질과 AI 성능에 직접적인 영향을 미칩니다.
본 메뉴를 통해 전처리 스크립트를 체계적으로 관리함으로써 비정형 데이터의 **일관성·신뢰성**을 확보하고, AI 모델이 안정적으로 동작하도록 지원합니다.
전처리기 화면은 좌측 내비게이션의 **문서 전처리 > 전처리기** 메뉴에서 진입합니다. 전처리기 메뉴 위치가 **문서 전처리** 그룹으로 이동했으므로, 이전 경로를 가리키는 북마크는 갱신해 주시기 바랍니다.
> 전처리기 내부 구현 로직(일명 *facade code*)에 대한 설명은 [**전처리 facade 코드**](/default/v1.9.0/admin-management/settings/resource/basic_preprocessor_for_rag/intro.md) 문서를 참고하시기 바랍니다.
### 주요 속성
전처리기는 다음 속성으로 구성됩니다.
* **ID:** 전처리기의 고유 식별자입니다. 시스템 내에서 전처리기를 구분하는 데 사용됩니다.
* **제목:** 전처리기의 이름입니다. 예를 들어 “기본 전처리기”와 같이 지정합니다.
* **상세설명:** 전처리기에 대한 상세 설명입니다. 예를 들어 “md, txt, json 등의 기본 파일”과 같이 작성합니다.
* **확장자:** 해당 전처리기가 처리할 파일 형식입니다. 예를 들어 “json, html”과 같이 입력합니다.
* **제작자:** 전처리기를 생성한 관리자 계정 정보입니다.
* **관리 그룹:** 전처리기를 관리할 수 있는 그룹입니다.
* **등록일시:** 전처리기가 시스템에 등록된 날짜와 시간입니다.
### 이 페이지에서 가능한 주요 작업
* **전처리기 생성:** 새로운 전처리기를 생성하고 코드 및 파라미터를 설정합니다.
* **전처리기 삭제:** 목록에서 체크박스로 전처리기를 선택하여 삭제합니다.
* **전처리기 배포 및 배포 중지:** 생성한 전처리기를 실행 환경에 배포하거나, 배포된 전처리기의 실행을 중지합니다.
## 전처리기 목록 화면
**문서 전처리 > 전처리기** 메뉴에서 등록된 전처리기 목록을 확인합니다. 목록에는 ID, 제목, 확장자, 출처, 연결 상태, 컨테이너 상태가 표시되며, 검색과 정렬을 사용해 원하는 전처리기를 빠르게 찾을 수 있습니다.
전처리기 목록 화면
* **검색:** 검색 기준을 선택한 뒤 검색어를 입력해 목록을 조회합니다.
* **배포된 전처리기만 보기:** 스위치를 켜면 현재 배포되어 있는 전처리기만 목록에 남습니다.
* **컨테이너 상태 배지:** 배포 컨테이너의 현재 상태가 배지로 표시되며, 화면을 열어 둔 상태에서 자동으로 갱신됩니다.
* **생성:** 새 전처리기를 등록합니다. 생성 권한이 없는 계정에서는 버튼이 비활성화됩니다.
* **카탈로그 보기:** 다른 사용자가 게시한 전처리기를 검색·복제할 수 있는 카탈로그 패널을 엽니다.
## 전처리기 생성 다이얼로그
목록 화면의 **\[생성]** 버튼을 누르면 생성 다이얼로그가 열립니다.
전처리기 생성 다이얼로그
입력 항목은 다음과 같습니다.
* **제목 · 상세 설명 · 관리 그룹:** 전처리기의 이름과 설명, 관리 주체가 되는 그룹을 지정합니다.
* **확장자:** 이 전처리기가 처리할 파일 형식을 입력합니다. 업로드 정책에 맞는지 검증됩니다.
* **타입:** 부착 · 지능형 · 변환 중에서 선택합니다. 타입을 선택하면 해당 타입의 **기본 코드가 자동으로 입력**되므로, 이를 그대로 사용하거나 필요에 맞게 수정하면 됩니다.
* **코드 · 기본 파라미터:** 전처리 과정에서 실행할 코드와 실행 시 사용할 기본 입력 변수를 설정합니다.
* **GPU 할당:** 전처리기 실행에 GPU를 사용할 경우 할당량을 지정합니다. GPU를 할당하면 복제본 수는 1로 고정됩니다.
* **환경변수:** 코드 실행 시 주입할 환경변수를 등록합니다.
저장하면 전처리기가 등록되고 목록이 갱신됩니다.
## 전처리기 상세 화면 탭 구성
목록에서 전처리기를 클릭하면 상세 화면으로 이동합니다. 상세 화면은 다섯 개 탭으로 구성됩니다.
| 탭 | 내용 |
| ----------- | ------------------------------------------------------ |
| **기본정보** | 제목·설명·확장자·코드·파라미터·환경변수와 배포 상태, 코드서빙 기반 여부를 확인하고 수정합니다. |
| **리비전 이력** | 게시 시점마다 고정된 리비전(스냅샷) 목록을 확인합니다. |
| **배포 이력** | 과거 배포 기록을 확인합니다. |
| **컨테이너 상태** | 배포 컨테이너의 이벤트 로그와 실시간 컨테이너 로그를 확인합니다. |
| **리소스 목록** | 전처리기에 귀속된 리소스 파일을 확인합니다. |
> 코드 서빙에서 자동 생성된 전처리기는 원본 코드 서빙이 리비전과 리소스를 관리하므로 **리비전 이력 · 리소스 목록 탭이 표시되지 않습니다.**
### 기본정보
**전처리기 > 상세 > 기본정보** 탭에서 등록 정보와 배포 상태를 확인하고 수정합니다.
전처리기 상세 화면의 기본정보 탭
* **수정할 수 없는 항목:** 제작자 · 관리 그룹 · 등록일시가 표시됩니다. 코드 서빙에서 자동 생성된 전처리기는 코드 서빙 기반 여부도 함께 표시됩니다.
* **수정할 수 있는 항목:** **\[수정]** 을 누르면 제목 · 상세설명 · 확장자 · 코드 · 기본 파라미터 · 환경변수 입력칸이 활성화되며, 내용을 변경한 뒤 **\[저장]** 을 누르면 수정 내용이 반영됩니다.
* **배포:** **\[배포]** 를 누르면 배포 다이얼로그가 열립니다. 도커 이미지 · 인스턴스 타입 · 복제본(1\~10, GPU 할당 시 1로 고정) · 실행 인자를 지정해 배포를 시작합니다.
### 리비전 이력
**전처리기 > 상세 > 리비전 이력** 탭에서 과거 리비전 목록을 확인합니다. 리비전은 게시 시점의 전처리기 상태(코드·파라미터·환경변수·GPU 설정)를 스냅샷으로 고정한 기록입니다. 리소스 파일도 리비전 생성 시점의 내용이 해당 리비전에 함께 귀속되므로, 이후 작업본을 수정해도 과거 리비전의 내용은 그대로 유지됩니다.
* **컬럼:** ID · 확장자 · 제작자 · 등록일시
* **검색:** ID 또는 제작자 기준으로 검색합니다.
* **정렬:** ID · 제작자 · 등록일시 기준으로 정렬합니다.
* **리비전 상세:** 목록의 행을 클릭하면 리비전 상세 화면으로 이동하며, 해당 리비전 시점의 코드·파라미터·환경변수·GPU 설정을 확인할 수 있습니다.
### 배포 이력
**전처리기 > 상세 > 배포 이력** 탭에서 과거 배포 기록을 확인합니다.
전처리기 상세 화면의 배포 이력 탭
* **ID:** 배포 이력의 고유 식별자입니다.
* **리비전 ID:** 해당 배포가 **어느 리비전 스냅샷으로 실행되었는지**를 나타냅니다. 문제가 발생한 배포가 어떤 코드로 동작했는지 추적할 때 사용합니다.
* **인스턴스 타입 · 도커 이미지 · 복제본 · GPU:** 배포에 사용된 실행 환경 설정입니다. 인스턴스 타입에 마우스를 올리면 CPU · 메모리 정보가 함께 표시됩니다.
* **배포자 · 배포일시 · 중지자 · 중지일시:** 배포와 중지를 수행한 계정과 시각입니다.
> 배포 이력은 해당 전처리기에 대한 수정 권한이 있는 계정에서만 조회할 수 있습니다.
### 컨테이너 상태
**전처리기 > 상세 > 컨테이너 상태** 탭은 **이벤트 로그**와 **컨테이너 로그** 두 개의 하위 탭으로 나뉩니다.
전처리기 상세 화면의 컨테이너 상태 탭
* **이벤트 로그:** 미배포 → 승인 대기 → 배포 중 → 실행 준비 → 배포 완료로 이어지는 상태 변화를 시간 순으로 보여 줍니다.
* **컨테이너 로그:** 실행 중인 컨테이너의 표준 출력·오류 로그를 실시간으로 확인합니다. 전처리 코드에서 발생한 예외를 확인할 때 사용합니다.
> 컨테이너 로그 역시 해당 전처리기에 대한 수정 권한이 있는 계정에서만 조회할 수 있습니다.
**배포가 실패한 경우**
1. 목록과 상세 화면의 상태 배지가 빨강으로 표시됩니다.
2. 배지에 마우스를 올리면 실패 사유가 툴팁으로 표시됩니다.
3. 사유를 확인한 뒤 배포를 중지하고, 도커 이미지·인스턴스 타입·복제본 설정 또는 전처리 코드를 수정해 다시 배포합니다.
## 컨테이너 상태 배지
전처리기 배포 컨테이너의 상태는 다음과 같은 배지로 표시됩니다.
| 상태 | 배지 색 | 의미 |
| -------------------- | ---- | ------------------------------ |
| 미배포 | 회색 | 아직 배포하지 않은 상태입니다. |
| 승인 대기 · 배포 중 · 실행 준비 | 파랑 | 배포 요청 이후 컨테이너가 생성·초기화되는 중입니다. |
| 배포 완료 | 녹색 | 컨테이너가 정상적으로 실행 중입니다. |
| 배포 거부 · 오류 | 빨강 | 배포가 거부되었거나 컨테이너 생성에 실패한 상태입니다. |
| 종료됨 | 회색 | 배포가 중지되어 컨테이너가 종료된 상태입니다. |
## 전처리기 카탈로그
전처리기 목록 화면의 **\[카탈로그 보기]** 를 누르면 카탈로그 패널이 열립니다. 이미 등록된 전처리기를 검색해 그대로 복제하여 재사용할 수 있습니다.
전처리기 카탈로그 패널
* **검색:** 제목 · 설명 · 확장자 · 제작자 기준으로 검색하고 정렬할 수 있습니다.
* **카드 정보:** 각 카드에 평점과 복제 수가 표시되어 활용도가 높은 전처리기를 고르는 데 참고할 수 있습니다.
* **상세 확인:** 카드를 클릭하면 카탈로그 상세 화면으로 이동합니다. 상세에는 **게시 버전(고정된 리비전)** 과 게시 일시가 표시되며, 카탈로그는 원본 전처리기의 특정 리비전 스냅샷을 게시 버전으로 고정해 노출합니다.
* **사용하기:** **\[사용하기]** 를 누르면 게시된 리비전을 기준으로 새 전처리기가 복제 생성됩니다.
## 사용 시나리오: 전처리기 생성부터 배포까지
1. **문서 전처리 > 전처리기** 목록에서 **\[생성]** 을 누릅니다. 생성 권한이 없으면 버튼이 비활성화되어 있습니다.
2. 생성 다이얼로그에서 제목 · 상세 설명 · 관리 그룹 · 확장자 · 타입(부착/지능형/변환)을 입력합니다. 타입을 선택하면 기본 코드가 자동으로 입력됩니다.
3. 이어서 코드 · 기본 파라미터 · GPU 할당 · 환경변수를 설정하고 저장합니다. 등록이 완료되면 목록이 갱신됩니다.
4. 목록에서 생성한 전처리기를 클릭해 상세로 진입한 뒤 **\[배포]** 를 누르고 도커 이미지 · 인스턴스 타입 · 복제본(1\~10, GPU 할당 시 1로 고정) · 실행 인자를 지정합니다.
5. 배포는 비동기로 진행되며, 상태 배지가 **배포 중 → 실행 준비 → 배포 완료** 순으로 전환됩니다.
6. **컨테이너 상태 > 컨테이너 로그** 탭에서 실시간 로그를 확인해 전처리기가 정상적으로 기동했는지 점검합니다.
## 관련 문서
* [파이프라인 관리](/default/v1.9.0/admin-management/settings/resource/pipeline.md)
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://genos-docs.gitbook.io/default/v1.9.0/admin-management/settings/resource/preprocessor.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.