> 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.1/basic-tutorials/guides/data/ai-drive.md). # AI 드라이브 AI 드라이브는 문서함을 다루는 기능입니다. 드라이브·폴더·파일을 폴더 구조로 관리하고, 업로드한 문서를 자동으로 RAG용으로 적재해 채팅에서 검색하고 참조할 수 있게 합니다. 여기에 더해 다른 사용자·그룹과 공유하거나, 여러 항목을 zip으로 묶어 내려받고, 삭제한 항목을 휴지통에서 복원하는 기능을 한 화면에서 제공합니다. v1.9.x에서는 개인 전용 공간인 **내 드라이브**, 파일 콘텐츠 스냅샷을 관리하는 **버전 관리**, 리소스별 변경 이력을 시간순으로 보여주는 **활동 내역**이 새로 추가되었습니다. **데이터 > AI 드라이브** 메뉴에서 진입하며, 화면은 **그룹 드라이브 · 내 드라이브 · 공유받은 문서함 · 휴지통** 네 개의 탭으로 구성됩니다.

## 주요 개념 | 개념 | 설명 | | -------- | ----------------------------------------------------------------------------------------------- | | 그룹 드라이브 | 소속 관리 그룹이 소유한 문서함입니다. 관리 그룹 정책과 공유로 접근을 통제합니다. | | 내 드라이브 | 본인이 단독으로 소유하는 개인 문서함입니다. 관리 그룹 개념이 적용되지 않으며 용량도 개인 단위로 관리됩니다. | | 폴더 | 드라이브 내부에서 파일을 계층으로 정리하는 단위입니다. 최대 10단계까지 만들 수 있습니다. | | 파일 | 드라이브·폴더 안에 업로드한 문서입니다. 업로드 후 자동으로 적재됩니다. | | 버전 | 파일 콘텐츠의 특정 시점 스냅샷입니다. 최초 업로드 시 v1이 생성되고, 동일한 이름으로 덮어쓰면 버전이 하나 올라갑니다. 파일에만 제공되며 드라이브와 폴더에는 없습니다. | | 영구 보관 | 자동 제거 대상에서 제외하는 버전 지정입니다. 드라이브별로 최대 200개까지 지정할 수 있습니다. | | 활동 | 드라이브·폴더·파일에 발생한 변경을 시간순으로 누적 기록한 이력입니다. 사후 수정과 삭제가 불가능한 영구 기록입니다. | | 보안등급 | 파일 단위로 지정하는 열람 등급입니다. 등급이 높을수록 열람 범위가 제한되며 파일 목록에 배지로 표시됩니다. 폴더와 드라이브에는 지정하지 않습니다. | | 적재 | 업로드한 문서를 임베딩·인덱싱해 검색과 AI 답변 참조 대상으로 만드는 과정입니다. | | 재적재 | 드라이브 설정(임베딩 모델·전처리기·파라미터)을 바꾼 뒤 기존 문서를 최신 설정으로 다시 적재하는 작업입니다. | | 공유받은 문서함 | 다른 사용자나 그룹으로부터 공유받은 드라이브·폴더·파일을 모아 보는 공간입니다. | | 휴지통 | 삭제한 항목이 30일간 보관되는 공간입니다. 복원하거나 영구 삭제할 수 있습니다. | | 관리 그룹 | 그룹 드라이브를 소유하고 권한을 부여받는 단위입니다. 내 드라이브에는 적용되지 않습니다. | ## 권한 안내 AI 드라이브의 기능은 관리 그룹 단위로 부여되는 권한에 따라 표시되고 실행됩니다. 권한이 없는 기능의 버튼은 화면에 표시되지 않습니다. | 권한 | 가능한 작업 | | ------- | ----------------------------------------------------------------------------- | | 읽기 | 메뉴 진입, 목록·상세 정보 조회, 활동 내역 조회, 버전 파일 열기, 다운로드 | | 읽기 및 쓰기 | 위 기능에 더해 드라이브·폴더 생성, 파일 업로드, 삭제, 공유 설정, 재적재 실행, 드라이브 설정 수정, 버전 복원·영구 보관·버전 삭제 | * 폴더와 파일의 권한은 상위 드라이브의 권한을 상속받습니다. * 메뉴 진입 권한이 없으면 화면에 진입할 수 없습니다. * 드라이브 단건에 대한 읽기 권한이 없으면 상세 진입 시 권한 없음 안내 화면이 표시됩니다. * **내 드라이브**는 본인 단독 소유 리소스이므로 관리 그룹 정책의 대상이 아닙니다. 본인이 항상 소유자이며, 타인의 접근은 공유를 통해서만 부여됩니다. > 공유받은 파일의 재적재는 예외입니다. AI 드라이브에 쓰기 권한이 없어도, 읽기 권한으로 공유받은 경우에도 재적재할 수 있습니다. ## 드라이브 생성 **그룹 드라이브** 또는 **내 드라이브** 탭에서 `드라이브 생성` 버튼을 눌러 새 문서함을 만듭니다. 생성은 두 단계로 진행됩니다.

### 1단계 — 기본 정보 * **이름**: 드라이브 이름을 4\~30자로 입력합니다. * **상세 설명**: 드라이브의 목적이나 용도를 입력합니다. * **관리 그룹**: 드라이브를 소유할 관리 그룹을 선택합니다. **내 드라이브에서는 이 항목이 제공되지 않으며** 생성과 동시에 본인이 자동으로 소유자가 됩니다.

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

> 그룹 드라이브는 같은 관리 그룹 안에 동일한 이름의 드라이브를 만들 수 없습니다. `다음`을 누르는 시점에 이름 중복을 검사합니다. ## 내 드라이브 **내 드라이브**는 본인이 단독으로 소유하는 개인 문서함입니다. 그룹 드라이브와 화면·동작이 거의 동일하지만, 관리 그룹 개념이 적용되지 않는 것이 핵심 차이입니다.

| 항목 | 그룹 드라이브 | 내 드라이브 | | ------------- | --------------- | ------------------- | | 소유 단위 | 관리 그룹(그룹 멤버 전체) | 개인(본인 단독) | | 생성 시 관리 그룹 지정 | 필요 | 불필요(본인 자동 소유) | | 권한 모델 | 관리 그룹 정책과 공유 | 본인 단독 권한과 공유 | | 기본 접근자 | 관리 그룹의 모든 멤버 | 본인 1명 | | 관리 그룹 컬럼 | 표시 | 미표시 | | 용량 한도 | 그룹 단위 | 개인 단위 | | 외부 공유 | 가능 | 가능(관리 그룹·역할·사용자 모두) | * **관리 그룹 미제공**: 생성 단계, 목록 컬럼, 검색·필터, 기본 정보 어디에도 관리 그룹 항목이 나타나지 않습니다. * **제작자·수정자 컬럼**: 하위 목록에서는 제작자·수정자 컬럼을 표시하지 않습니다. 다만 공유를 고려해 기본 정보에는 제작자 정보를 표시합니다. * **용량**: 내 드라이브 용량은 개인 단위로 집계됩니다. * **공유받은 문서함 연계**: 내 드라이브의 파일을 타인에게 공유하면 상대의 공유받은 문서함에 표시되며, 개인 드라이브 출처이므로 관리 그룹은 `-`로 표시됩니다. * 표시 차이 외의 모든 동작은 그룹 드라이브와 동일합니다. ## 폴더 및 파일 관리 목록에서 드라이브 항목을 더블 클릭하면 내부로 진입합니다. 드라이브 내부에서는 폴더와 파일을 폴더 구조로 관리하며, 폴더는 최대 10단계까지 만들 수 있습니다.

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

### 파일 업로드 1. 드라이브 또는 폴더 내부에서 `업로드` 버튼을 클릭하고 `파일 업로드`를 선택합니다. 2. 업로드 영역에 파일을 끌어다 놓거나 클릭해 파일을 선택합니다. 3. **보안등급**을 선택합니다. 이 등급은 이번 업로드로 확정되는 모든 파일에 일괄 적용됩니다. 기본값은 가장 낮은 등급이며, 선택 목록에는 본인의 유효 등급 이하만 표시됩니다. 4. `생성`을 클릭하면 확인 모달이 표시되며, `예`를 선택하면 업로드가 시작됩니다. 여러 파일을 한 번에 업로드할 수 있고, 화면 하단의 진행률 표시줄에서 전체 진행 상태를 확인할 수 있습니다. 업로드 시 지정한 보안등급은 개별 파일의 기본 정보에서 다시 변경할 수 있습니다.

> **폴더 업로드.** 파일뿐 아니라 폴더를 통째로 끌어다 놓으면 폴더 안의 하위 파일이 자동으로 펼쳐져 함께 업로드됩니다. 이때 운영체제가 폴더에 남기는 숨김·시스템 파일은 자동으로 제외되어, 그로 인한 지원하지 않는 확장자 안내도 표시되지 않습니다. ### 동일 이름 업로드 옵션 동일한 파일명이 이미 있는 경우 **업로드 옵션** 모달이 표시됩니다. 두 가지 처리 방식 중 하나를 선택할 수 있습니다. * **덮어쓰기**: 기존 파일에 새 콘텐츠를 덮어씁니다. 기존 콘텐츠는 버전 기록으로 보관되고 새 파일은 재적재 대상 상태가 됩니다. * **두 파일 모두 유지**: 기존 파일을 그대로 두고 새 파일을 별개의 사본으로 저장합니다. 사본 이름은 원본 이름 뒤에 `(1)`, `(2)` 형식으로 번호가 붙으며 별개의 리소스로 생성됩니다. > - 파일명 비교는 대소문자를 구분하지 않으며 유니코드 정규화 기준으로 이뤄집니다. 예를 들어 `Work_test`와 `work_test`처럼 대소문자만 다른 이름도 같은 이름으로 보아 업로드 옵션 모달을 표시합니다. > - 사본 이름이 저장 한도를 넘으면 업로드가 차단되고 안내가 표시됩니다. > - 그룹 용량 또는 내 드라이브 용량이 가득 찬 경우 업로드 시점에 차단되고 안내 메시지가 표시됩니다. ### 이름 입력 규칙 이름은 앞뒤 공백을 제거한 뒤 길이를 검증하며, `\ / : * ? " < > |` 문자는 사용할 수 없습니다. | 대상 | 길이 | | --------------------- | ------- | | 드라이브 이름 | 4\~30자 | | 폴더 이름 | 4\~30자 | | 파일 이름(확장자 포함, 저장 기준) | 4\~255자 | | 파일 이름(확장자 제외, 편집 입력란) | 최대 250자 | 파일 이름을 편집할 때 입력란에는 확장자를 제외한 부분만 표시되고, 확장자는 별도로 표시된 뒤 저장할 때 다시 합쳐집니다. 긴 확장자가 붙으면 전체 이름이 저장 한도를 넘지 않도록 허용 길이가 자동으로 줄어듭니다. ## 문서 적재 및 상태 확인 업로드한 파일은 별도의 버튼 조작 없이 자동으로 적재됩니다. 적재 진행 상태는 목록의 **상태 컬럼**에서 확인합니다.

| 상태 | 의미 | | ------ | ----------------------------------- | | 대기중 | 적재 대기 상태입니다. | | 실행 중 | 적재가 진행 중입니다. | | 완료 | 적재가 완료되어 검색과 AI 참조가 가능합니다. | | 오류발생 | 적재에 실패했습니다. 상태 버튼을 클릭해 재시작할 수 있습니다. | | 재적재 대상 | 설정 변경이나 덮어쓰기 등으로 재적재가 필요한 상태입니다. | * **오류발생**과 **재적재 대상** 상태의 항목은 상태 버튼을 클릭해 재시작할 수 있습니다. 오류 상태는 상태 라벨에 마우스를 올리면 실패 사유가 툴팁으로 표시됩니다. * 대기중이거나 실행 중인 항목이 있으면 목록이 약 5초 간격으로 자동 갱신되어 상태 변화를 반영합니다. * 진행 중인 문서는 상태 라벨을 눌러 적재를 중지할 수 있습니다. * 파일을 더블 클릭하면 상세 화면으로 이동합니다. > **재적재 대상 문서의 상세 진입.** 덮어쓰기 직후처럼 재적재 대상 상태인 파일도 오류 상태와 동일하게 상세 뷰어에 진입할 수 있습니다. 원본 콘텐츠는 미리보기로 볼 수 있으며, 청크 데이터는 재적재가 완료돼야 채워집니다. ## 파일 보안등급 파일 단위로 열람 등급을 지정해 접근 범위를 제한할 수 있습니다. 폴더와 드라이브에는 보안등급이 적용되지 않습니다. ### 지정 방법 * **업로드 시 일괄 지정**: 업로드 모달에서 선택한 보안등급이 이번 업로드로 확정되는 모든 파일에 적용됩니다. * **개별 파일 수정**: 파일을 선택해 **기본 정보**를 열고 보안등급을 다시 선택해 저장합니다. 선택 목록에는 본인의 유효 등급 이하만 표시되어 자신보다 높은 등급으로는 올릴 수 없습니다. ### 목록 표시 * 파일 목록에는 보안등급 컬럼이 있으며, 지정된 파일은 등급명 배지로 표시됩니다. 폴더와 등급을 지정하지 않은 파일은 `-`로 표시됩니다. * 등급명이 길면 배지에서 말줄임 처리되고, 마우스를 올리면 전체 등급명이 툴팁으로 표시됩니다. * 보안등급 컬럼은 정렬을 지원합니다. ### 동기화 상태 보안등급을 지정하거나 변경하면 벡터 DB에 반영되며, 반영이 끝나기 전까지 배지에 동기화 대기 중 또는 동기화 중 표시가 함께 붙습니다. 동기화 중인 파일이 있으면 목록이 약 5초 간격으로 자동 조회되어, 완료되면 안내 표기가 사라집니다. ### RAG 검색 시 등급 통제 문서 보안등급은 파일 목록 표시뿐 아니라 채팅·워크플로우의 RAG 검색 단계에서도 적용됩니다. 사용자의 유효 보안등급을 초과하는 문서는 검색 단계에서 제외되어 컨텍스트로 주입되지 않으며, 결과적으로 답변 내용과 출처 어디에도 노출되지 않습니다. * 등급 필터는 출처 표시 단계가 아니라 검색·컨텍스트 주입 단계에 적용됩니다. 등급을 초과하는 문서의 청크는 애초에 검색 대상에서 빠지므로 내용이 답변에 반영되지 않습니다. * 워크플로우를 AgentFlow로 구성한 경우에도 검색 도구가 요청 사용자의 보안등급을 전달받아 검색 쿼리에 반영합니다. * 사용자의 최종 유효 등급은 관리 그룹·역할·사용자 지정 중 가장 높은 등급으로 적용됩니다. 자세한 내용은 [보안등급 관리](/default/v1.9.1/admin-management/settings/iam/security-level.md)를 참고하세요. ## 문서 재적재 드라이브 설정(임베딩 모델·전처리기·파라미터 등)을 바꾸면 기존 문서를 최신 설정으로 다시 적재해야 합니다. 1. 드라이브 기본 정보 패널에서 설정을 수정하고 저장합니다. 2. 드라이브 내부 목록에서 **재적재 대상** 상태로 표시된 항목을 확인합니다. 3. 항목을 선택하고 `재적재` 버튼을 클릭합니다. 4. 확인 모달에서 `예`를 선택하면 최신 설정이 적용되어 다시 적재됩니다.

> * 재적재가 진행 중인 문서는 완료 전까지 검색 및 AI 답변 참조에서 자동으로 제외됩니다. > * 그룹 드라이브의 `재적재` 버튼은 AI 드라이브에 쓰기 권한이 있는 경우에만 사용할 수 있습니다. > * 공유받은 문서함의 파일은 쓰기 권한이 없어도 재적재할 수 있습니다. > * **휴지통 복원 시 자동 재적재.** 휴지통에서 파일을 복원하면 별도 조작 없이 자동으로 재적재됩니다. 삭제 시 검색 인덱스에서 해당 문서 데이터가 제거되므로, 복원 시 자동 재적재로 검색과 AI 참조 대상으로 원상 복구합니다. ## 파일 버전 관리 파일의 콘텐츠 스냅샷을 버전으로 보관해 이전 시점으로 되돌릴 수 있습니다. **버전 관리는 파일에만 제공되며 드라이브와 폴더에는 없습니다.** 활동 내역이 누가 무엇을 했는지의 행위 기록이라면, 버전은 콘텐츠 상태의 보관소입니다.

### 버전이 생기는 규칙 * 신규 업로드 시 **v1**이 자동으로 생성됩니다. * 동일한 이름으로 덮어쓰면 버전이 하나 올라갑니다. 버전 번호는 시스템이 자동으로 부여하며 사용자가 직접 입력할 수 없습니다. * 복원하면 최상위 버전보다 하나 높은 신규 버전이 생성됩니다. 덮어쓰기가 아니라 새 버전 추가이며 기존 버전은 모두 유지됩니다. * 시스템 자동 재적재, 스키마·임베딩 변경, 사용자 수동 재적재는 콘텐츠가 동일하므로 버전을 생성하지 않습니다. 활동 내역에만 기록됩니다. ### 버전 기록 모달 파일 상세 또는 기본 정보에서 버전 항목을 통해 **버전 관리** 모달로 진입합니다. 모달의 컬럼은 다음과 같습니다. | 컬럼 | 내용 | | ------ | ------------------------------------- | | 버전 | 버전 번호입니다. 현재 버전과 이전 버전을 구분해 표시합니다. | | 변경 사항 | 업로드·덮어쓰기·복원 중 어떤 작업으로 생성된 버전인지 표시합니다. | | 수정자 | 해당 버전을 만든 사용자입니다. | | 수정한 날짜 | 버전 생성 일시입니다. | | 크기 | 해당 버전의 파일 크기입니다. | | 보관 | 영구 보관 지정 여부입니다. | ### 버전 액션 행별 더보기(⋮) 메뉴에서 다음 작업을 수행합니다. | 메뉴 | 동작 | 권한 | | -------- | ---------------------------------- | -- | | 파일 열기 | 해당 버전 콘텐츠를 좌측 미리보기에 표시합니다. | 읽기 | | 복원 | 해당 버전을 새 버전으로 복원합니다. 기존 버전은 유지됩니다. | 쓰기 | | 영구 보관 | 자동 제거 대상에서 제외합니다. | 쓰기 | | 영구 보관 해제 | 영구 보관 지정을 해제합니다. | 쓰기 | | 버전 삭제 | 해당 버전을 즉시 영구 제거합니다. | 쓰기 | * **복원**: 확인 다이얼로그에서 확정하면 새 버전이 만들어지고 복원 완료 토스트가 표시됩니다. * **영구 보관**: 드라이브별로 최대 200개까지 지정할 수 있고, 초과하면 안내 토스트가 표시됩니다. * **버전 삭제**: 휴지통을 거치지 않고 즉시 영구 제거되므로 되돌릴 수 없습니다. 확인 다이얼로그에 지정 문자를 입력해야 확인 버튼이 활성화됩니다. ### 보관 정책 영구 보관으로 지정하지 않은 버전은 다음 정책에 따라 시스템이 자동으로 제거합니다. * **30일 경과**: 생성 후 30일이 지난 일반 버전은 자동으로 제거됩니다. * **100개 한도**: 버전이 100개에 도달한 뒤 신규 업로드가 생기면 가장 오래된 버전부터 제거됩니다. * 현재 버전은 항상 보존되며, 영구 보관 버전은 자동 제거 대상에서 제외됩니다. * 모든 버전 콘텐츠는 드라이브 용량에 합산됩니다. ### 버전 뷰어 버전 기록에서 `파일 열기`를 실행하면 해당 버전의 콘텐츠를 좌측 미리보기 영역에 표시합니다. 과거 버전을 조회하는 상태에서는 다음과 같이 동작합니다. * **뷰어를 제공하는 파일**: 해당 버전 콘텐츠를 미리보기로 표시합니다. * **뷰어를 제공하지 않는 파일**: 미리보기 대신 대체 안내를 표시합니다. * 과거 버전 조회 상태에서는 상세 정보의 버전 텍스트를 클릭할 수 없고 청크 데이터를 수정할 수 없습니다. * 과거 버전을 볼 때 `수정` 버튼은 `복원` 버튼으로 대체됩니다. * 버전에 남아 있는 청크·벡터가 없으면 청크 데이터는 빈 상태로 안내됩니다. ## 활동 내역 드라이브·폴더·파일 각 리소스에 발생한 변경을 시간순으로 누적 기록해 **활동** 탭에서 확인합니다. 협업 시 누가 언제 무엇을 바꿨는지 추적하는 용도이며, 한 번 기록된 활동은 수정하거나 삭제할 수 없는 영구 기록입니다.

### 공통 규칙 * **정렬**: 활동 일시 역순으로 최신 항목이 위에 표시됩니다. * **추적 단위**: 한 번의 작업이 활동 항목 한 건이 됩니다. 여러 파일을 동시에 업로드하면 한 건으로 묶입니다. * **표시 범위**: 해당 리소스에서 직접 발생한 활동만 표시됩니다. 하위 리소스의 활동은 그 리소스의 활동 탭에서 확인합니다. * **행 구성**: `{행위자}님이 {활동}` 형태로 표시하고, 변경 전후가 있는 활동은 우측 토글을 펼쳐 상세 변경 내역을 봅니다. 변경 전은 취소선으로, 변경 후는 굵게 구분해 표시합니다. * **빈 상태**: 필터 결과가 없으면 활동 내역이 없다는 안내가 표시됩니다. 모든 리소스는 생성 시 생성 활동이 최소 한 건 기록됩니다. * **필터**: 상단의 활동 종류 필터로 범위를 좁힐 수 있으며 기본값은 전체입니다. ### 활동 종류 필터 필터 옵션은 리소스 종류에 따라 묶음으로 제공됩니다. | 리소스 | 필터 옵션 | | ---- | --------------------------------------------------- | | 드라이브 | 생성 · 기본 정보 · 공유 여부 · 속성 · 업로드 · 삭제 · 복원 | | 폴더 | 생성 · 기본 정보 · 공유 여부 · 업로드 · 삭제 · 복원 | | 파일 | 생성 · 기본 정보 · 공유 여부 · 버전 · 보안등급 · 적재 · 업로드 · 삭제 · 복원 | 각 묶음이 포함하는 세부 활동은 다음과 같습니다. | 묶음 | 포함되는 세부 활동 | | ------------ | ---------------------------- | | 기본 정보 | 기본 정보 수정 · 이름 변경 · 상세 설명 수정 | | 공유 여부 | 공유 · 공유 해제 · 재공유 · 공유 권한 변경 | | 속성(드라이브 전용) | 속성 수정 · 속성 추가 | | 버전(파일 전용) | 버전 복원 · 버전 삭제 · 시스템 자동 버전 제거 | | 보안등급(파일 전용) | 보안등급 수정 | | 적재(파일 전용) | 재적재 · 적재 상태 변화 | | 업로드 | 드라이브·폴더는 하위 업로드 집계, 파일은 덮어쓰기 | | 생성 · 삭제 · 복원 | 각각 단일 활동 | * 시스템이 자동으로 버전을 제거한 경우 행위자가 시스템으로 표시됩니다. * 영구 삭제는 활동으로 기록되지만 필터 옵션에서는 제외됩니다. ## 다운로드 다운로드는 대상 개수에 따라 두 경로로 나뉩니다. 읽기 권한 이상이 필요합니다.

* **단일 항목**: 목록에서 해당 행 우측의 **더보기(⋮) 메뉴 > 다운로드**를 사용합니다. 파일은 원본 그대로, 폴더와 드라이브는 zip 파일로 내려받습니다. 이 메뉴에는 다운로드 외에 **기본 정보**와 **공유**가 함께 들어 있습니다. * **다중 항목**: 여러 항목의 체크박스를 선택한 뒤 상단 툴바의 `다운로드` 버튼을 사용합니다. 폴더가 포함되거나 여러 항목을 함께 받는 경우 서버가 zip으로 묶어 준비하며, 준비가 완료되면 자동으로 내려받아집니다. 상단 툴바에는 선택 대상의 `재적재`·`삭제` 버튼도 함께 제공되며, 한 항목만 선택했을 때는 `공유` 버튼도 표시됩니다. zip 다운로드는 서버에서 묶이므로 요청 직후 백그라운드에서 준비 상태가 추적됩니다. 준비 중에 페이지를 새로고침해도 진행 중인 다운로드 작업은 유지되어 준비가 끝나면 이어서 내려받아집니다. ## 공유하기 드라이브·폴더·파일을 다른 관리 그룹, 역할, 사용자에게 공유할 수 있습니다. 공유는 한 번에 한 항목만 지정할 수 있으며 여러 항목을 함께 공유하는 것은 지원되지 않습니다. 1. 공유할 항목 행 우측의 **더보기(⋮) 메뉴 > 공유**를 클릭합니다. 한 항목만 선택한 경우 상단 툴바의 `공유` 버튼으로도 진입할 수 있습니다. 공유 메뉴는 쓰기 권한이 있는 본인 소유 항목에서만 표시되며, 공유받은 항목에는 표시되지 않습니다. 2. 공유 모달에서 **관리 그룹 · 역할 · 사용자** 탭 중 하나를 선택해 공유 대상을 추가합니다. 3. 대상별로 **읽기** 또는 **쓰기** 권한을 지정합니다. 4. `저장` 버튼을 누르고 확인 모달에서 `예`를 선택합니다.

> * 폴더를 공유하면 하위 폴더와 파일 전체에 동일한 권한이 부여되고, 파일을 공유하면 해당 파일 한 건만 공유됩니다. > * 공유받은 항목의 재공유는 지원되지 않습니다. > * 공유, 회수, 권한 변경, 원본 삭제 시 수신자에게 알림이 발송됩니다. ### 다른 워크스페이스의 공유 리소스 열람 공유받은 리소스는 출처 워크스페이스에서 열람하는 것이 원칙입니다. 활성 워크스페이스가 아닌 다른 워크스페이스에서 공유 리소스의 주소로 직접 접근하면, 안내 없이 홈으로 이동하지 않고 **출처 워크스페이스로 전환할지 묻는 모달**이 표시됩니다. * 전환을 확정하면 출처 워크스페이스로 전환되어 공유 리소스를 정상적으로 열람합니다. * 전환해도 접근할 수 없는 경우에는 화면을 벗어나며 해당 워크스페이스에 대한 권한이 없다는 안내가 표시됩니다. * 사이드바 메뉴는 활성 워크스페이스 기준으로 계속 구성되므로, 주소로는 열리지만 메뉴에는 보이지 않는 것이 의도된 동작입니다. 워크스페이스 전환의 전체 동작은 [워크스페이스 관리](/default/v1.9.1/admin-management/settings/iam/workspace.md)를 참고하세요. ## 공유받은 문서함 다른 사용자나 그룹으로부터 공유받은 항목을 확인하는 공간입니다. 드라이브·폴더·파일이 한 목록에 섞여 표시됩니다.

* 항목을 더블 클릭하면 내부로 진입해 조회하고 다운로드할 수 있습니다. * 부여받은 권한이 쓰기인 경우 기본 정보 수정과 재적재를 할 수 있습니다. * 공유받은 파일은 본인의 용량에 포함되지 않습니다. ### 제거와 제거된 항목 복원 공유받은 문서함의 `제거`는 원본을 삭제하는 것이 아니라 **공유받기를 거절하는 동작**입니다. 제거해도 원본 리소스와 다른 수신자에는 영향이 없습니다. 제거한 항목은 목록 하단의 **제거된 항목** 섹션에 모여 복원할 수 있습니다.

* **안내 배너**: 목록 상단에 제거의 의미를 설명하는 안내가 표시됩니다. 그룹 드라이브 탭의 삭제는 원본을 휴지통으로 옮기는 동작이라 의미가 다릅니다. * **제거 처리**: `제거`를 클릭하면 재확인 모달 없이 즉시 제거됩니다. 제거된 항목에서 복원할 수 있으므로 확인 모달을 생략합니다. * **제거된 항목 섹션**: 목록 하단에 접이식으로 제공되며 기본은 접힌 상태입니다. 제거 항목이 있으면 헤더에 개수가 표시됩니다. 컬럼은 ID·이름·공유한 사용자·관리 그룹·제거 일시·원래 위치로 구성됩니다. * **복원**: 제거된 항목을 선택하면 섹션 우측 상단에 선택 개수와 `복원` 버튼이 나타나며, 개별 또는 선택 복원할 수 있습니다. * **검색 연동**: 상단 검색어는 일반 목록과 제거된 항목에 동일하게 적용되며, 검색 시 제거된 항목 섹션이 자동으로 펼쳐집니다. * **예외**: 제거된 항목에 있는 항목을 공유자가 원본에서 삭제하면 제거된 항목에서도 사라집니다.

> 공유받은 문서함에서의 수정·생성·재적재는 공유받은 권한을 기준으로 판정합니다. 그룹 드라이브 탭과 달리 AI 드라이브 쓰기 권한이 없어도 공유받은 쓰기 권한만 있으면 해당 항목을 수정할 수 있습니다. ## 휴지통 삭제한 드라이브·폴더·파일이 보관되는 공간입니다. 항목이 한 목록에 섞여 표시됩니다.

* **복원**: 항목을 선택하고 `복원` 버튼을 클릭한 뒤 확인 문구를 입력하면 원래 위치로 복원됩니다. 같은 이름이 이미 있으면 이름 뒤에 `(n)`이 덧붙습니다. * **영구 삭제**: 확인 문구를 입력한 뒤 삭제하며, 영구 삭제된 항목은 복원할 수 없습니다. > 휴지통으로 이동된 항목은 30일 후 자동으로 영구 삭제됩니다. 이 안내는 휴지통 화면 상단의 안내 바에 표시됩니다. ## 파일 상세와 벡터 정보 파일을 더블 클릭하면 파일 상세 화면으로 이동합니다. * PDF 파일은 좌측에 뷰어가 함께 표시됩니다. * 상세 정보·문서 공통 정보와 함께, 적재 결과로 생성된 벡터(청크) 목록을 확인할 수 있습니다. 벡터 목록은 청크 ID·속성·벡터·등록일시 컬럼으로 구성됩니다. * 파일 상세에서 **활동** 탭으로 리소스 활동 내역을, **버전 관리** 모달로 버전 기록을 확인할 수 있습니다. ### 기본 정보 패널 파일을 선택하면 우측 기본 정보 패널에서 파일 속성을 확인합니다. v1.9.x부터 다음 항목이 추가되었습니다. * **파일 크기**: 읽기 쉬운 단위로 표시됩니다. * **버전**: 현재 버전이 표시됩니다. > 파일 크기와 버전 항목은 파일에만 표시되며 폴더·드라이브에는 나타나지 않습니다. ## AI 드라이브 활용 * **문서 참조**: 적재된 문서를 채팅에서 검색하고 참조할 수 있습니다. AI 드라이브는 채팅의 파일 참조 플러그인의 소스가 됩니다. * **워크플로우 데이터 소스**: 워크플로우 상세의 데이터 소스 탭에서 소스 종류로 **AI 드라이브**를 선택해 워크플로우의 데이터 소스로 연결할 수 있습니다. 이때 드라이브 선택 목록에는 접근 권한을 충족하는 드라이브만 표시됩니다. * **협업**: 공유 기능으로 관리 그룹이나 팀원과 문서를 공유해 함께 활용할 수 있습니다. * **개인 문서 관리**: 내 드라이브로 관리 그룹과 무관한 개인 문서를 별도로 관리할 수 있습니다. ## 사용자 시나리오 ### 새 문서함을 만들고 문서를 적재하기 그룹 드라이브 탭에서 드라이브를 생성하고 관리 그룹을 지정한 뒤 임베딩과 전처리기를 설정합니다. 드라이브에 진입해 폴더를 만들고 파일을 업로드하면 자동으로 적재가 시작되며, 상태 컬럼에서 진행 상황을 확인합니다. ### 개인 문서를 관리하기 내 드라이브 탭에서 드라이브를 생성합니다. 관리 그룹 선택 단계가 없으며 본인이 자동으로 소유자가 됩니다. 개인 용량 한도 안에서 문서를 올리고 관리하며, 필요하면 특정 파일을 관리 그룹·역할·사용자에게 공유할 수 있습니다. ### 파일을 이전 버전으로 되돌리기 동일한 이름으로 덮어써 여러 버전이 쌓인 파일에서 버전 관리 모달을 엽니다. 되돌릴 버전의 더보기 메뉴에서 복원을 선택하면 새 버전으로 복원되고 기존 버전은 유지됩니다. 자주 참조하는 기준 버전은 영구 보관으로 지정해 자동 제거에서 제외합니다. ### 변경 이력을 확인하기 공유받은 드라이브의 파일에서 활동 탭을 열어 누가 언제 이름을 바꾸거나 덮어쓰거나 공유 권한을 변경했는지 시간순으로 확인합니다. 변경 전후가 있는 활동은 토글을 펼쳐 상세 변경 내역을 봅니다. ### 설정을 바꿔 문서를 다시 적재하기 임베딩 모델이나 전처리기를 변경하면 기존 문서가 재적재 대상으로 표시됩니다. 해당 항목을 선택해 재적재하면 최신 설정으로 다시 적재됩니다. 재적재 중인 문서는 완료 전까지 검색과 AI 참조에서 제외됩니다. ### 공유만 받은 사용자 그룹 드라이브에 대한 권한이 없어도 공유받은 항목은 **공유받은 문서함** 탭에서 확인할 수 있습니다. 읽기로 공유받으면 조회와 다운로드가, 쓰기로 공유받으면 수정과 재적재가 가능합니다. 필요 없으면 제거로 공유받기를 거절하고, 나중에 제거된 항목에서 복원할 수 있습니다. ### 삭제한 항목을 복원하기 휴지통 탭에서 삭제한 드라이브·폴더·파일을 확인합니다. 복원으로 원래 위치에 되돌리며, 같은 이름이 있으면 `(n)`이 붙어 복원됩니다. 30일이 지나면 자동으로 영구 삭제되므로 필요한 항목은 그 전에 복원합니다. ## 함께 보기 * [DB 문서 적재](/default/v1.9.1/basic-tutorials/guides/data/vectordb.md) * [벡터 DB 자동 적재](/default/v1.9.1/basic-tutorials/guides/data/auto_ingestion.md) * [용어사전](/default/v1.9.1/basic-tutorials/guides/data/glossary.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.1/basic-tutorials/guides/data/ai-drive.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.