# ☁️ 구글 드라이브 & AI RAG 파이프라인 연합 전략 사용자의 구글 드라이브(Google Drive)에 있는 약관 PDF나 이미지를 인슈위키 AI가 어떻게 읽고 분석하는지에 대한 기술적 연결 고리를 정의합니다. --- ## 1. 드라이브-AI 연결 아키텍처 (Hybrid Pipeline) 우리는 파일을 우리 서버에 직접 쌓지 않고, **"저장은 드라이브, 지능은 인슈위키"** 원칙을 고수합니다. ### 🔄 데이터 흐름 (Data Flow) 1. **인덱싱 요청 (Indexing)**: 사용자가 특정 폴더나 파일을 "AI 분석 대상"으로 지정합니다. 2. **임시 다운로드 & 파싱**: 우리 서버가 OAuth 권한을 사용하여 파일을 아주 잠시 읽어 들입니다. (PDF 텍스트 추출 또는 이미지 OCR 수행) 3. **벡터화 (Vectorization)**: 추출된 텍스트를 작은 조각(Chunks)으로 나누어 의미 데이터(Vectors)로 변환합니다. 4. **벡터 DB 저장 (Indexing)**: 이 숫자 데이터(Vector)만 **인슈위키 전용 벡터 DB**에 저장합니다. (원본 파일은 드라이브에만 존재) 5. **질의응답 (RAG)**: 사용자가 질문하면 AI가 벡터 DB에서 관련 내용을 찾아 드라이브의 원본 파일 위치(URL)와 함께 답변을 제공합니다. --- ## 2. 기술적 해결책 (Technical Solutions) ### 2.1. OAuth 2.0 권한 최적화 * **문제**: 드라이브 전체 권한은 너무 광범위함. * **해결책**: `drive.file` 스코프를 사용하여 인슈위키에서 생성하거나, 사용자가 명시적으로 선택한 파일에만 접근하도록 제한하여 보안성 확보. ### 2.2. 실시간 동기화 (Webhooks) * **문제**: 드라이브에서 파일을 수정하면 AI 지식이 구버전이 됨. * **해결책**: Google Drive Push Notifications(Webhooks)를 연동하여 파일 변경 시 자동으로 벡터 DB를 재색인(Re-indexing)하는 파이프라인 구축. ### 2.3. 대용량 문서 처리 (Page-level Mapping) * **해결책**: 수만 페이지의 약관은 통째로 읽지 않고, 하이퍼링크 형식으로 필요한 페이지만 즉시 소환하는 **"Deep Linking"** 기술 적용. --- ## 3. 사용자 경험: "완벽한 은닉화 (Seamless Abstraction)" 사용자는 파일이 구글 드라이브에 올라간다는 사실을 인지하지 못하도록 앱 네이티브한 경험을 제공합니다. ### 3.1. 전용 은닉 폴더 사용 (The Vault) * **전략**: 사용자의 드라이브 루트가 아닌, 서비스 전용의 특수 폴더(예: `.insuwiki_data`)를 생성하여 그 안에서만 파일을 관리합니다. * **효과**: 사용자가 평소에 쓰는 드라이브 폴더들과 섞이지 않아 '인슈위키 전용 저장소'처럼 느껴집니다. ### 3.2. 인슈위키 네이티브 파일 탐색기 * **전략**: 구글 드라이브 인터페이스를 그대로 띄우지 않고, 인슈위키의 디자인 시스템에 맞춘 **자체 파일 탐색기 및 업로더**를 구현합니다. * **효과**: 버튼 하나로 업로드하고 관리하는 과정이 모두 인슈위키 앱 내에서 완결됩니다. ### 3.3. 투명 프록시 (Transparent Proxy) * **전략**: 파일 다운로드나 미리보기 시 드라이브 주소(`drive.google.com/...`)를 직접 노출하지 않고, 우리 서버의 API 엔드포인트(`insuwiki/api/files/...`)를 거쳐서 데이터를 전달합니다. * **효과**: 브라우저 주소창이나 개발자 도구에서도 구글 드라이브의 흔적을 찾기 어렵게 만듭니다. --- ## 4. 기대 효과 * **용량 걱정 zero**: 인슈위키 서버 저장소를 쓰지 않으므로 파일 용량에 제한이 없습니다. * **프라이버시**: 원본 데이터는 오직 사용자의 구글 계정에만 머뭅니다. * **즉시성**: 구글 드라이브에 파일을 던져 넣기만 하면, 잠시 후 인슈위키 AI가 그 내용을 모두 파악하게 됩니다. --- > [!TIP] > **"내 드라이브에 있는 모든 보험 자료가 나의 거대한 인공지능 뇌가 됩니다."** 이것이 우리가 추구하는 진정한 개인화 AI의 모습입니다.