> 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.6/basic-tutorials/guides/data/auto_ingestion.md).
# 벡터 DB 자동 적재
### 자동 적재 생성
1. **데이터** 메뉴로 이동합니다.
2. 하위 메뉴 **자동 적재**를 선택합니다.
3. **자동 적재 추가** 버튼을 클릭합니다.
4. 생성 양식에 필요한 정보를 입력합니다.
* **1단계**
* **제목**: 자동 적재 이름을 입력합니다.
* **상세 설명**: 자동 적재 용도를 설명합니다.
* **관리 그룹:** 자동적재를 관리할 그룹을 선택합니다.
* **임베딩 서빙:** 데이터 적재에 사용할 임베딩 서버를 선택합니다.
* **배치 크기:** 한번에 처리할 데이터의 배치 크기를 설정합니다.
* **데이터 원천:** 데이터를 적재할 위치를 선택합니다.
* **벡터 DB:** 데이터를 저장할 벡터 DB를 선택합니다.
* **디렉토리 경로:** 데이터 파일이 위치한 디렉토리 경로를 입력합니다. 확인 버튼을 클릭하여 해당 경로를 체크합니다. 경로가 없으면 그 자리에서 디렉토리를 만들 수 있습니다. 아래 「디렉토리 경로 확인과 생성」을 참고하세요.
* **문서 전처리 모듈:** 데이터 적재 시 사용할 전처리 방식을 선택합니다.
* **파라미터:** 데이터 처리 시 사용할 파라미터 값을 입력합니다.
* **2단계**
* **매일 특정 시간에(다중 선택 지원):** 데이터 적재가 자동으로 실행될 시간을 설정합니다. 여러 개의 시간을 다중 선택이 가능합니다.
5. **생성** 버튼을 눌러 완료합니다.
6. 생성된 적재 항목을 확인할 수 있습니다. 설정된 일정에 따라서 자동 적재가 실행됩니다.
### 디렉토리 경로 확인과 생성
데이터 원천이 **내장 디렉토리** 일 때 1단계에 **디렉토리 경로** 입력란이 나옵니다. 경로는 입력란 앞에 표시된 `/nfs-root/autoIngestion/` 아래 경로로 입력합니다(예: `hr/2026/rules`).
입력한 경로가 아직 없으면 NFS에 직접 들어가지 않고 이 화면에서 바로 디렉토리를 만들 수 있습니다.
#### 입력 규칙
입력하는 즉시 검사합니다. 규칙에 맞지 않으면 입력란 아래에 문구가 표시되고 `[확인]` 버튼이 비활성으로 바뀝니다.
| 입력 | 표시 문구 |
| -------------------------------------------------- | ------------------------------------------------- |
| `[` `]` `*` `?` `\` 가 들어간 경우 | 경로에 \[ ] \* ? \ 는 사용할 수 없습니다. |
| 앞뒤에 `/` 가 있거나 `/` 가 연속된 경우 (예: `/etc`, `hr//2026`) | 경로 앞뒤의 / 와 연속된 / 는 사용할 수 없습니다. |
| `.` 만으로 된 이름 (예: `hr/../2026`) | . 만으로 된 디렉토리 이름은 사용할 수 없습니다. |
| 디렉토리 이름 앞뒤에 공백이 있는 경우 | 디렉토리 이름 앞뒤의 공백은 사용할 수 없습니다. |
| 보이지 않는 문자나 특수 공백이 들어간 경우 | 경로에 보이지 않는 문자나 특수 공백이 들어 있습니다. 경로를 직접 다시 입력해 주세요. |
| 디렉토리 이름(`/` 사이 한 칸)이 85자를 넘는 경우 | 디렉토리 이름은 최대 85자까지 입력할 수 있습니다. |
| 경로 전체가 1,000자를 넘는 경우 | 디렉토리 경로는 최대 1,000자까지 입력할 수 있습니다. |
* 보이지 않는 문자는 문서나 메신저에서 경로를 복사해 붙여 넣을 때 섞여 들어오는 경우가 많습니다. 문구가 뜨면 경로를 직접 다시 입력하세요.
* 맥에서 복사한 한글처럼 자모가 분리된 글자는 입력란에서 자동으로 완성형 한글로 바뀝니다.
#### 확인 결과
`[확인]` 을 누르면 경로를 검사합니다.
| 결과 | 화면 |
| ----------------------- | ------------------------------------------ |
| 이미 있는 디렉토리 | 버튼이 `[확인됨]` 으로 바뀝니다. `[다음]` 으로 넘어갈 수 있습니다. |
| 없는 경로 | 「디렉토리 경로 생성」 팝업이 뜹니다. 아래 「디렉토리 생성」을 참고하세요. |
| 디렉토리가 아니라 파일인 경우 | 해당 경로는 디렉토리가 아닙니다. |
| 중간 경로에 같은 이름의 파일이 있는 경우 | 같은 이름의 파일이 있어 디렉토리 경로를 생성할 수 없습니다. (파일 경로) |
| 링크가 포함된 경로 | 링크가 포함된 경로는 사용할 수 없습니다. |
| 디렉토리를 만들 수 없는 위치 | 이 경로에는 디렉토리 경로를 생성할 수 없습니다. 관리자에게 문의해 주세요. |
* 오류는 토스트 없이 입력란 아래에만 표시됩니다.
* `[확인됨]` 상태에서 경로를 고치면 다시 확인해야 합니다. 2단계에서 `[이전]` 으로 돌아와도 경로가 같으면 `[확인됨]` 이 유지됩니다.
* 확인을 거치지 않은 채 `[다음]` 을 누르면 「경로를 확인하세요.」가 표시됩니다.
#### 디렉토리 생성
없는 경로를 확인하면 「디렉토리 경로 생성」 팝업에 「해당 경로가 없습니다. 새로 만들까요?」와 만들 전체 경로가 표시됩니다.
* `[예]`: 없는 상위 디렉토리까지 한 번에 만들고 「디렉토리 경로를 생성했습니다.」 토스트가 뜹니다. 버튼은 `[확인됨]` 으로 바뀝니다.
* `[아니오]` (또는 팝업 바깥 클릭 · Esc): 디렉토리를 만들지 않고 입력란 아래에 「해당 경로가 없습니다. 경로를 고치거나 확인을 다시 눌러 새로 만들 수 있습니다.」가 표시됩니다. 이 상태에서는 `[다음]` 으로 넘어갈 수 없습니다.
* 팝업이 열려 있는 동안에는 경로를 고칠 수 없습니다.
* 디렉토리는 `[예]` 를 누른 순간 만들어집니다. 이후 자동 적재 생성을 취소해도 만든 디렉토리는 남습니다.
* 디렉토리 생성 권한은 1단계에서 고른 **관리 그룹** 의 자동 적재 생성 권한으로 판단합니다. 관리 그룹을 고르지 않았으면 「관리 그룹을 선택하세요.」 토스트가 뜹니다. 디렉토리 생성에 따로 필요한 권한은 없습니다.
#### 생성할 때 다시 검사
2단계에서 `[생성]` 을 누르면 경로를 한 번 더 검사합니다. 1단계에서 확인한 뒤에 디렉토리가 지워졌거나 파일 · 링크로 바뀌었으면 오류 토스트가 뜨고 자동 적재는 만들어지지 않습니다. 이때는 `[이전]` 으로 돌아가 경로를 다시 확인하세요.
### 자동 적재 수동 실행
1. **실행 버튼:** 클릭 시, 자동 적재를 수동으로 실행 가능합니다.
2. **실행 이력:** 실행 이력 항목 및 상태를 확인할 수 있습니다.
## 자동 적재 상세
* **기본 정보 탭**
* 생성한 자동 적재 기본 정보를 확인할 수 있습니다.
* 제목, 상세설명, 일정을 수정할 수 있습니다.
* **실행 버튼:** 클릭 시, 해당 자동 적재를 수동으로 실행시킬 수 있습니다.
* **삭제 버튼:** 클릭 시, 해당 자동 적재를 삭제할 수 있습니다.
* **실행 이력 탭**
* ID, 추가항목, 실행방식, 시작일시, 종료일시, 상태를 확인할 수 있습니다.
* ID, 실행방식, 상태로 검색을 할 수 있습니다.
### 자동 적재 목록
* **속성:**
* **ID:** 각 자동 적재의 고유 식별자. 시스템 내에서 자동 적재를 구분하는데 사용됩니다.
* **제목:** 자동 적재의 이름을 나타냅니다.
* **유형:** 적재하는 데이터의 유형을 나타냅니다.
* **일정:** 자동 적재가 실행되는 시간을 나타냅니다.
* **최근 실행:** 해당 자동 적재 작업이 마지막으로 실행된 날짜 및 시간을 나타냅니다.
* **제작자:** 해당 자동 적재를 생성한 관리자 계정 정보를 나타냅니다.
* **관리 그룹:** 자동 적재를 관리할 수 있는 관리 그룹을 나타냅니다.
* **등록일시:** 자동적재가 시스템에 등록된 날짜와 시간을 나타냅니다.
* **상태:** 자동 적재의 현재 상태를 나타냅니다.
* **자동 적재 목록 화면 설명:**
* **자동적재 목록:** 시스템에 등록된 모든 자동 적재 목록이 표시됩니다. 각 자동 적재는 ID, 제목, 유형, 일정, 최근 실행, 제작자, 관리 그룹, 등록일시, 상태의 정보를 포함합니다.
* **자동적재 검색:** 자동 적재를 빠르게 찾기 위해 검색 기능을 사용할 수 있습니다.
* **자동적재 추가:** 새로운 자동 적재를 생성할 수 있는 버튼이 제공됩니다.
---
# 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 by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://genos-docs.gitbook.io/default/v1.9.6/basic-tutorials/guides/data/auto_ingestion.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.
.png?alt=media)
