> 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.2/basic-tutorials/guides/data/vectordb.md).

# DB 문서 적재

벡터 DB는 문서나 FAQ를 임베딩해 저장하고 검색에 활용하는 기능입니다. 데이터 형식으로 문서, FAQ, 자동적재를 지원하며, 데이터 형식에 따라 상세 화면의 구성이 달라집니다.

## 벡터 DB 생성

<figure><img src="/files/8j6BFhmxSrFZKSxhVrvW" alt="벡터 DB 생성"><figcaption><p>벡터 DB 생성</p></figcaption></figure>

1. **데이터** 메뉴에서 **벡터 DB**를 선택합니다.
2. **벡터 DB 생성** 버튼을 클릭합니다.
3. 생성 양식에 정보를 입력합니다.
   * **제목**: 벡터 DB의 이름을 입력합니다.
   * **상세 설명**: 벡터 DB의 용도를 설명합니다.
   * **관리 그룹**: 벡터 DB를 관리할 그룹을 선택합니다.
   * **데이터 형식**: 문서, FAQ, 자동적재 중에서 선택합니다. (QA는 Deprecated)
   * **수동 스키마**: 켜면 속성 스키마를 직접 정의할 수 있습니다.
4. **생성** 버튼을 눌러 완료합니다.

## 벡터 DB 상세

<figure><img src="/files/Il6HTtB4aWoKGIrCEPiX" alt="벡터 DB 상세"><figcaption><p>벡터 DB 상세 화면</p></figcaption></figure>

* 목록에서 항목을 더블 클릭하면 상세 페이지로 이동합니다.
* 상단 탭은 **기본 정보**, **문서 목록**(FAQ 형식은 **FAQ 목록**), **인증 키**로 구성됩니다.
* **기본 정보**에서 제작자, 관리 그룹, 등록일시, 벡터 차원 수, 벡터 DB 종류, 데이터 형식, 이용 현황, 워크플로우 아이디, 제목, 상세 설명, 수동 스키마 여부를 확인할 수 있습니다.
* 기본 정보 하단의 **속성 목록**에서 벡터 DB에 저장되는 속성을 확인하고 생성할 수 있습니다.

## 문서 적재 (문서 형식)

문서 형식의 벡터 DB는 **문서 목록** 탭에서 **업로드** 버튼을 눌러 문서를 추가합니다. 문서 추가는 두 단계로 진행됩니다.

### 1단계: 임베딩과 전처리 설정

<figure><img src="/files/y7HKL0KGjcjQK1HOJdkL" alt="문서 추가 1단계"><figcaption><p>문서 추가 1단계</p></figcaption></figure>

* **임베딩 서빙**: Direct Serving 또는 Service Router를 고른 뒤 사용할 임베딩 서빙(모델 리비전)을 선택합니다.
* **배치 크기**: 한 번에 처리할 데이터의 배치 크기를 설정합니다.
* **문서 유형(전처리기)**: File첨부 RAG용, 기본 전처리기 등 전처리기를 선택합니다. 전처리기마다 지원하는 문서 확장자가 다릅니다.
* **파라미터**: 전처리 시 사용할 파라미터를 입력합니다.

<figure><img src="/files/pXEiY3gaiVjwSIvgM4jr" alt="임베딩 서빙 선택"><figcaption><p>임베딩 서빙 선택</p></figcaption></figure>

### 2단계: 파일 업로드

<figure><img src="/files/yVNkvg89bmlguHjD61av" alt="파일 업로드"><figcaption><p>파일 업로드</p></figcaption></figure>

* 파일을 끌어다 놓거나 클릭하여 선택합니다. 지원 확장자는 1단계에서 선택한 전처리기에 따라 달라집니다.
* **생성** 버튼을 누르면 적재가 시작됩니다.

### 적재 확인

<figure><img src="/files/eLPtTWi2kZS9TS1ph7ZS" alt="문서 목록"><figcaption><p>문서 목록과 적재 상태</p></figcaption></figure>

* 문서 목록에 파일 이름, 전처리기, 커넥트 타입, 임베딩 서빙, 벡터 개수, 제작자, 등록일시, 상태가 표시됩니다.
* 상태는 적재가 진행 중이면 실행 중, 완료되면 완료됨으로 표시되고 적재된 벡터 개수를 확인할 수 있습니다.

<figure><img src="/files/bx6KAJctdWYvhjXsJXIK" alt="문서 목록"><figcaption><p>적재된 문서 목록</p></figcaption></figure>

* 파일을 열면 문서 뷰어에서 적재된 청크 데이터와 상세 정보를 확인할 수 있습니다.

<figure><img src="/files/LHPeRnBWsv2M2enc98GC" alt="문서 뷰어 청크 데이터"><figcaption><p>문서 뷰어 청크 데이터</p></figcaption></figure>

<figure><img src="/files/wxXuVs0K4SApOaRAnBGL" alt="문서 뷰어 상세"><figcaption><p>문서 뷰어 상세</p></figcaption></figure>

## FAQ 적재 (FAQ 형식)

<figure><img src="/files/Q3twwaYEO8pHEifYWDqp" alt="FAQ 목록"><figcaption><p>FAQ 목록</p></figcaption></figure>

* FAQ 형식의 벡터 DB는 상세 화면에 **FAQ 목록** 탭이 표시됩니다.
* 질문과 답변 쌍을 등록해 관리하며, 목록에서 ID, 커넥트 타입, 서빙 제목, 질문, 답변, 제작자, 등록일시를 확인할 수 있습니다.

## 속성 관리

기본 정보 탭 하단의 **속성 목록**에서 속성을 생성하고 관리합니다. 속성은 벡터 DB에 저장되는 데이터의 메타 정보를 정의합니다.

<figure><img src="/files/Bfsbd0L2r67mFDrWCtFY" alt="속성 생성"><figcaption><p>속성 생성</p></figcaption></figure>

* **속성 생성** 버튼을 눌러 다음을 입력합니다.
  * **제목**: 속성의 이름 (예: n\_words, n\_lines)
  * **상세 설명**: 속성의 용도
  * **데이터 타입**: blob, boolean, date, int, number, text 및 각 배열 타입에서 선택

<figure><img src="/files/qrVLAByqhMB5Nmi6YlHu" alt="속성 상세"><figcaption><p>속성 상세와 인덱스 생성</p></figcaption></figure>

* 속성 상세에서 인덱스 생성 옵션을 설정할 수 있습니다.
  * **필터 인덱스**: 값이 정확히 일치하는 데이터를 빠르게 찾아 대용량 데이터의 필터 속도를 높입니다.
  * **검색 인덱스**: 텍스트 문장이나 단어를 빠르게 찾아 텍스트 검색 성능을 높입니다.
  * **범위 필터 인덱스**: 범위 조건 필터 속도를 높입니다.
* doc\_id, text, summary 등 기본 제공 속성도 속성 목록에서 함께 확인할 수 있습니다.


---

# 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.2/basic-tutorials/guides/data/vectordb.md?ask=<question>&goal=<endgoal>
```

`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.