> 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.8.8/basic-tutorials/guides/data/ai-drive.md).

# AI 드라이브

AI 드라이브는 관리 그룹 단위의 문서함을 다루는 기능입니다. 드라이브·폴더·파일을 폴더 구조로 관리하고, 업로드한 문서를 자동으로 RAG용으로 적재해 채팅에서 검색하고 참조할 수 있게 합니다. 여기에 더해 다른 사용자·그룹과 공유하거나, 여러 항목을 zip으로 묶어 내려받고, 삭제한 항목을 휴지통에서 복원하는 기능을 한 화면에서 제공합니다.

**데이터 > AI 드라이브** 메뉴에서 진입하며, 화면은 **그룹 드라이브 · 공유받은 문서함 · 휴지통** 세 개의 탭으로 구성됩니다.

<figure><img src="/files/8kpkpsaKFkG97ytDMEjE" alt=""><figcaption><p>AI 드라이브 목록 — 그룹 드라이브 탭</p></figcaption></figure>

## 주요 개념

| 개념       | 설명                                                                                 |
| -------- | ---------------------------------------------------------------------------------- |
| 그룹 드라이브  | 소속 관리 그룹이 소유한 문서함입니다. 드라이브를 생성하고 관리하는 기본 공간입니다.                                    |
| 폴더       | 드라이브 내부에서 파일을 계층으로 정리하는 단위입니다. 최대 10단계까지 만들 수 있습니다.                                |
| 파일       | 드라이브·폴더 안에 업로드한 문서입니다. 업로드 후 자동으로 적재됩니다.                                           |
| 보안등급     | 파일 단위로 지정하는 열람 등급입니다. 등급이 높을수록 열람 범위가 제한되며 파일 목록에 배지로 표시됩니다. 폴더와 드라이브에는 지정하지 않습니다. |
| 적재       | 업로드한 문서를 임베딩·인덱싱해 검색과 AI 답변 참조 대상으로 만드는 과정입니다.                                     |
| 재적재      | 드라이브 설정(임베딩 모델·전처리기·파라미터)을 바꾼 뒤 기존 문서를 최신 설정으로 다시 적재하는 작업입니다.                      |
| 공유받은 문서함 | 다른 사용자나 그룹으로부터 공유받은 드라이브·폴더·파일을 모아 보는 공간입니다.                                       |
| 휴지통      | 삭제한 항목이 30일간 보관되는 공간입니다. 복원하거나 영구 삭제할 수 있습니다.                                      |
| 관리 그룹    | 드라이브를 소유하고 권한을 부여받는 단위입니다. 권한은 그룹 단위로 부여됩니다.                                       |

## 권한 안내

AI 드라이브의 기능은 관리 그룹 단위로 부여되는 권한에 따라 표시되고 실행됩니다. 권한이 없는 기능의 버튼은 화면에 표시되지 않습니다.

| 권한      | 가능한 작업                                                     |
| ------- | ---------------------------------------------------------- |
| 읽기      | 메뉴 진입, 목록·상세 정보 조회, 다운로드                                   |
| 읽기 및 쓰기 | 위 기능에 더해 드라이브·폴더 생성, 파일 업로드, 삭제, 공유 설정, 재적재 실행, 드라이브 설정 수정 |

* 폴더와 파일의 권한은 상위 드라이브의 권한을 상속받습니다.
* 메뉴 진입 권한이 없으면 화면에 진입할 수 없습니다.
* 드라이브 단건에 대한 읽기 권한이 없으면 상세 진입 시 권한 없음 안내 화면이 표시됩니다.

> 공유받은 파일의 재적재는 예외입니다. AI 드라이브에 쓰기 권한이 없어도, 읽기 권한으로 공유받은 경우에도 재적재할 수 있습니다.

## 드라이브 생성

**그룹 드라이브** 탭에서 `드라이브 생성` 버튼을 눌러 새 문서함을 만듭니다. 생성은 두 단계로 진행됩니다.

<figure><img src="/files/vd7B6mIegqx2Xg5iDLUZ" alt=""><figcaption><p>드라이브 생성 버튼</p></figcaption></figure>

### 1단계 — 기본 정보

* **이름**: 드라이브 이름을 4\~30자로 입력합니다.
* **상세 설명**: 드라이브의 목적이나 용도를 입력합니다.
* **관리 그룹**: 드라이브를 소유할 관리 그룹을 선택합니다.

<figure><img src="/files/wOeUoq5FOUonXr4EYu1e" alt=""><figcaption><p>드라이브 생성 1단계 — 기본 정보 입력</p></figcaption></figure>

### 2단계 — 임베딩 및 전처리기

* **임베딩**
  * 임베딩 서빙: Direct Serving 또는 Service Router를 선택하고 사용할 서빙을 지정합니다.
  * 배치 크기: 한 번에 처리할 데이터의 배치 크기입니다. 기본값은 64입니다.
* **전처리기**
  * 전처리기: 적재 시 사용할 전처리 방식을 선택합니다. 전처리기에 따라 지원하는 문서 확장자가 다릅니다.
  * 파라미터: 문서 분할 기준인 Chunk Size(기본값 1000)와 Chunk Overlap(기본값 100)을 지정합니다.
* **수동 스키마**: 데이터 스키마를 직접 정의할 때 사용합니다. 기본값은 사용하지 않음이며, 활성화하면 벡터 인덱스 등 스키마 설정값을 직접 지정할 수 있습니다.

마지막으로 `생성` 버튼을 눌러 완료합니다.

<figure><img src="/files/lLbJIBm9LLTVRDzRX8HC" alt=""><figcaption><p>드라이브 생성 2단계 — 임베딩 및 전처리기 설정</p></figcaption></figure>

> 같은 관리 그룹 안에 동일한 이름의 드라이브는 만들 수 없습니다. `다음`을 누르는 시점에 이름 중복을 검사합니다.

## 폴더 및 파일 관리

목록에서 드라이브 항목을 더블 클릭하면 내부로 진입합니다. 드라이브 내부에서는 폴더와 파일을 폴더 구조로 관리하며, 폴더는 최대 10단계까지 만들 수 있습니다.

<figure><img src="/files/oDBHyjSxBvl1GH1bsZ9B" alt=""><figcaption><p>드라이브 내부 — 폴더·파일 목록</p></figcaption></figure>

### 폴더 생성

1. 드라이브 내부에서 `+ 새 폴더` 버튼을 클릭합니다.
2. 폴더 이름을 4\~30자로 입력합니다.
3. `생성` 버튼을 눌러 완료합니다.

<figure><img src="/files/ZHu1CggMLxDEBvqHk6p8" alt=""><figcaption><p>새 폴더 — 폴더 이름 입력 모달</p></figcaption></figure>

### 파일 업로드

1. 드라이브 또는 폴더 내부에서 `업로드` 버튼을 클릭하고 `파일 업로드`를 선택합니다.
2. 업로드 영역에 파일을 끌어다 놓거나 클릭해 파일을 선택합니다.
3. **보안등급**을 선택합니다. 이 등급은 이번 업로드로 확정되는 모든 파일에 일괄 적용됩니다. 기본값은 가장 낮은 등급이며, 선택 목록에는 본인의 유효 등급 이하만 표시됩니다.
4. `생성`을 클릭하면 확인 모달이 표시되며, `예`를 선택하면 업로드가 시작됩니다.

여러 파일을 한 번에 업로드할 수 있고, 화면 하단의 진행률 표시줄에서 전체 진행 상태를 확인할 수 있습니다. 업로드 시 지정한 보안등급은 개별 파일의 기본 정보에서 다시 변경할 수 있습니다.

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

<figure><img src="/files/4HvgBnsB7MZqJyUIq0kh" alt=""><figcaption><p>파일 업로드 진행률 표시</p></figcaption></figure>

> * 동일한 파일명이 이미 있으면 덮어쓰기 여부를 선택하는 확인 모달이 표시됩니다. 사본으로 저장하거나 덮어쓸 수 있습니다.
> * 파일명 비교는 유니코드 정규화 기준으로 이뤄져, 겉보기에 같은 이름이 우회로 중복되는 것을 막습니다.
> * 그룹 용량이 가득 찬 경우 업로드 시점에 차단되고 안내 메시지가 표시됩니다.

### 이름 입력 규칙

이름은 앞뒤 공백을 제거한 뒤 길이를 검증하며, `\ / : * ? " < > |` 문자는 사용할 수 없습니다.

| 대상                    | 길이      |
| --------------------- | ------- |
| 드라이브 이름               | 4\~30자  |
| 폴더 이름                 | 4\~30자  |
| 파일 이름(확장자 포함, 저장 기준)  | 4\~255자 |
| 파일 이름(확장자 제외, 편집 입력란) | 최대 250자 |

파일 이름을 편집할 때 입력란에는 확장자를 제외한 부분만 표시되고, 확장자는 별도로 표시된 뒤 저장할 때 다시 합쳐집니다. 긴 확장자가 붙으면 전체 이름이 저장 한도를 넘지 않도록 허용 길이가 자동으로 줄어듭니다.

## 문서 적재 및 상태 확인

업로드한 파일은 별도의 버튼 조작 없이 자동으로 적재됩니다. 적재 진행 상태는 목록의 **상태 컬럼**에서 확인합니다.

<figure><img src="/files/ZPrmOWsuSE63QkjH13AT" alt=""><figcaption><p>적재 상태 — 목록 상태 컬럼</p></figcaption></figure>

| 상태     | 의미                                  |
| ------ | ----------------------------------- |
| 대기중    | 적재 대기 상태입니다.                        |
| 실행 중   | 적재가 진행 중입니다.                        |
| 완료     | 적재가 완료되어 검색과 AI 참조가 가능합니다.          |
| 오류발생   | 적재에 실패했습니다. 상태 버튼을 클릭해 재시작할 수 있습니다. |
| 재적재 대상 | 설정 변경 등으로 재적재가 필요한 상태입니다.           |

* **오류발생**과 **재적재 대상** 상태의 항목은 상태 버튼을 클릭해 재시작할 수 있습니다. 오류 상태는 상태 라벨에 마우스를 올리면 실패 사유가 툴팁으로 표시됩니다.
* 대기중이거나 실행 중인 항목이 있으면 목록이 약 5초 간격으로 자동 갱신되어 상태 변화를 반영합니다.
* 진행 중인 문서는 상태 라벨을 눌러 적재를 중지할 수 있습니다.
* 파일을 더블 클릭하면 상세 화면으로 이동합니다.

## 파일 보안등급

파일 단위로 열람 등급을 지정해 접근 범위를 제한할 수 있습니다. 폴더와 드라이브에는 보안등급이 적용되지 않습니다.

### 지정 방법

* **업로드 시 일괄 지정**: 업로드 모달에서 선택한 보안등급이 이번 업로드로 확정되는 모든 파일에 적용됩니다.
* **개별 파일 수정**: 파일을 선택해 **기본 정보**를 열고 보안등급을 다시 선택해 저장합니다. 선택 목록에는 본인의 유효 등급 이하만 표시되어 자신보다 높은 등급으로는 올릴 수 없습니다.

### 목록 표시

* 파일 목록에는 보안등급 컬럼이 있으며, 지정된 파일은 등급명 배지로 표시됩니다. 폴더와 등급을 지정하지 않은 파일은 `-`로 표시됩니다.
* 등급명이 길면 배지에서 말줄임 처리되고, 마우스를 올리면 전체 등급명이 툴팁으로 표시됩니다.
* 보안등급 컬럼은 정렬을 지원합니다.

### 동기화 상태

보안등급을 지정하거나 변경하면 벡터 DB에 반영되며, 반영이 끝나기 전까지 배지에 동기화 대기 중 또는 동기화 중 표시가 함께 붙습니다. 동기화 중인 파일이 있으면 목록이 약 5초 간격으로 자동 조회되어, 완료되면 안내 표기가 사라집니다.

## 문서 재적재

드라이브 설정(임베딩 모델·전처리기·파라미터 등)을 바꾸면 기존 문서를 최신 설정으로 다시 적재해야 합니다.

1. 드라이브 기본 정보 패널에서 설정을 수정하고 저장합니다.
2. 드라이브 내부 목록에서 **재적재 대상** 상태로 표시된 항목을 확인합니다.
3. 항목을 선택하고 `재적재` 버튼을 클릭합니다.
4. 확인 모달에서 `재적재`를 선택하면 최신 설정이 적용되어 다시 적재됩니다.

<figure><img src="/files/zZ8F8UmUTgki6WmhvAtx" alt=""><figcaption><p>재적재 대상 상태 표시</p></figcaption></figure>

> * 재적재가 진행 중인 문서는 완료 전까지 검색 및 AI 답변 참조에서 자동으로 제외됩니다.
> * 그룹 드라이브의 `재적재` 버튼은 AI 드라이브에 쓰기 권한이 있는 경우에만 사용할 수 있습니다.
> * 공유받은 문서함의 파일은 쓰기 권한이 없어도 재적재할 수 있습니다.

## 다운로드

다운로드는 대상 개수에 따라 두 경로로 나뉩니다. 읽기 권한 이상이 필요합니다.

<figure><img src="/files/b9eC5X50qWzwUKxpuy1l" alt=""><figcaption><p>목록의 다운로드 메뉴</p></figcaption></figure>

* **단일 항목**: 목록에서 해당 행 우측의 **더보기(⋮) 메뉴 > 다운로드**를 사용합니다. 파일은 원본 그대로, 폴더와 드라이브는 zip 파일로 내려받습니다. 이 메뉴에는 다운로드 외에 **기본 정보**와 **공유**가 함께 들어 있습니다.
* **다중 항목**: 여러 항목의 체크박스를 선택한 뒤 상단 툴바의 `다운로드` 버튼을 사용합니다. 폴더가 포함되거나 여러 항목을 함께 받는 경우 서버가 zip으로 묶어 준비하며, 준비가 완료되면 자동으로 내려받아집니다. 상단 툴바에는 선택 대상의 `재적재`·`삭제` 버튼도 함께 제공되며, 한 항목만 선택했을 때는 `공유` 버튼도 표시됩니다.

zip 다운로드는 서버에서 묶이므로 요청 직후 백그라운드에서 준비 상태가 추적됩니다. 준비 중에 페이지를 새로고침해도 진행 중인 다운로드 작업은 유지되어 준비가 끝나면 이어서 내려받아집니다.

## 공유하기

드라이브·폴더·파일을 다른 관리 그룹, 역할, 사용자에게 공유할 수 있습니다. 공유는 한 번에 한 항목만 지정할 수 있으며 여러 항목을 함께 공유하는 것은 지원되지 않습니다.

1. 공유할 항목 행 우측의 **더보기(⋮) 메뉴 > 공유**를 클릭합니다. 한 항목만 선택한 경우 상단 툴바의 `공유` 버튼으로도 진입할 수 있습니다. 공유 메뉴는 쓰기 권한이 있는 본인 소유 항목에서만 표시되며, 공유받은 항목에는 표시되지 않습니다.
2. 공유 모달에서 **관리 그룹 · 역할 · 사용자** 탭 중 하나를 선택해 공유 대상을 추가합니다.
3. 대상별로 **읽기** 또는 **쓰기** 권한을 지정합니다.
4. `저장` 버튼을 누르고 확인 모달에서 `예`를 선택합니다.

<figure><img src="/files/ZUlgiHdvuyLooWm9yF1l" alt=""><figcaption><p>항목 선택 후 공유 진입</p></figcaption></figure>

<figure><img src="/files/7AH7tYD2UmsEMWNxtJCw" alt=""><figcaption><p>리소스 공유 모달 — 관리 그룹·역할·사용자</p></figcaption></figure>

> * 폴더를 공유하면 하위 폴더와 파일 전체에 동일한 권한이 부여되고, 파일을 공유하면 해당 파일 한 건만 공유됩니다.
> * 공유받은 항목의 재공유는 지원되지 않습니다.
> * 공유, 회수, 권한 변경, 원본 삭제 시 수신자에게 알림이 발송됩니다.

## 공유받은 문서함

다른 사용자나 그룹으로부터 공유받은 항목을 확인하는 공간입니다. 드라이브·폴더·파일이 한 목록에 섞여 표시됩니다.

<figure><img src="/files/retSu1fP7gldUpEVpPXS" alt=""><figcaption><p>공유받은 문서함 목록</p></figcaption></figure>

* 항목을 더블 클릭하면 내부로 진입해 조회하고 다운로드할 수 있습니다.
* 부여받은 권한이 쓰기인 경우 기본 정보 수정과 재적재를 할 수 있습니다.
* `제거` 버튼으로 본인의 문서함에서만 항목을 제거할 수 있으며 원본에는 영향을 주지 않습니다.
* 공유받은 파일은 본인의 용량에 포함되지 않습니다.

<figure><img src="/files/DOGOxCy3xL7kRySdnYFQ" alt=""><figcaption><p>공유받은 문서함 — 항목 선택 후 제거</p></figcaption></figure>

> 공유받은 문서함에서의 수정·생성·재적재는 공유받은 권한을 기준으로 판정합니다. 그룹 드라이브 탭과 달리 AI 드라이브 쓰기 권한이 없어도 공유받은 쓰기 권한만 있으면 해당 항목을 수정할 수 있습니다.

## 휴지통

삭제한 드라이브·폴더·파일이 보관되는 공간입니다. 항목이 한 목록에 섞여 표시됩니다.

<figure><img src="/files/Ps7uBRZpzOFIzSGt5jZZ" alt=""><figcaption><p>휴지통 — 복원과 영구 삭제</p></figcaption></figure>

* **복원**: 항목을 선택하고 `복원` 버튼을 클릭한 뒤 확인 키를 입력하면 원래 위치로 복원됩니다. 같은 이름이 이미 있으면 이름 뒤에 `(n)`이 덧붙습니다.
* **영구 삭제**: 확인 키를 입력한 뒤 삭제하며, 영구 삭제된 항목은 복원할 수 없습니다.

> 휴지통으로 이동된 항목은 30일 후 자동으로 영구 삭제됩니다. 이 안내는 휴지통 화면 상단의 안내 바에 표시됩니다.

## 파일 상세와 벡터 정보

파일을 더블 클릭하면 파일 상세 화면으로 이동합니다.

* PDF 파일은 좌측에 뷰어가 함께 표시됩니다.
* 상세 정보·문서 공통 정보와 함께, 적재 결과로 생성된 벡터(청크) 목록을 확인할 수 있습니다. 벡터 목록은 청크 ID·속성·벡터·등록일시 컬럼으로 구성됩니다.

## AI 드라이브 활용

* **문서 참조**: 적재된 문서를 채팅에서 검색하고 참조할 수 있습니다. AI 드라이브는 채팅의 파일 참조 플러그인의 소스가 됩니다.
* **협업**: 공유 기능으로 관리 그룹이나 팀원과 문서를 공유해 함께 활용할 수 있습니다.

## 사용자 시나리오

### 새 문서함을 만들고 문서를 적재하기

그룹 드라이브 탭에서 드라이브를 생성하고 관리 그룹을 지정한 뒤 임베딩과 전처리기를 설정합니다. 드라이브에 진입해 폴더를 만들고 파일을 업로드하면 자동으로 적재가 시작되며, 상태 컬럼에서 진행 상황을 확인합니다.

### 설정을 바꿔 문서를 다시 적재하기

임베딩 모델이나 전처리기를 변경하면 기존 문서가 재적재 대상으로 표시됩니다. 해당 항목을 선택해 재적재하면 최신 설정으로 다시 적재됩니다. 재적재 중인 문서는 완료 전까지 검색과 AI 참조에서 제외됩니다.

### 공유만 받은 사용자

그룹 드라이브에 대한 권한이 없어도 공유받은 항목은 **공유받은 문서함** 탭에서 확인할 수 있습니다. 읽기로 공유받으면 조회와 다운로드가, 쓰기로 공유받으면 수정과 재적재가 가능합니다. 필요 없으면 제거로 본인 문서함에서만 정리할 수 있고 원본은 영향받지 않습니다.

### 삭제한 항목을 복원하기

휴지통 탭에서 삭제한 드라이브·폴더·파일을 확인합니다. 복원으로 원래 위치에 되돌리며, 같은 이름이 있으면 `(n)`이 붙어 복원됩니다. 30일이 지나면 자동으로 영구 삭제되므로 필요한 항목은 그 전에 복원합니다.

## 함께 보기

* [DB 문서 적재](/default/v1.8.8/basic-tutorials/guides/data/vectordb.md)
* [벡터 DB 자동 적재](/default/v1.8.8/basic-tutorials/guides/data/auto_ingestion.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.8.8/basic-tutorials/guides/data/ai-drive.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.