# 챗봇 전체 문서 검색을 위한 Notion 설정 가이드

본 문서는 사내 챗봇이 회사 Notion의 모든 주요 문서를 검색하여 답변할 수 있도록 권한을 설정하는 방법을 설명합니다.

## 핵심 원리
Notion API는 보안을 위해 **"사용자가 명시적으로 허용한 페이지"**만 챗봇이 읽을 수 있습니다.
따라서, 회사의 가장 상위 페이지(Root Page)에 챗봇 권한을 부여하면, 그 하위에 있는 모든 문서와 데이터베이스까지 자동으로 권한이 상속되어 검색이 가능해집니다.

---

## 설정 방법 (3단계)

### 1단계: 최상위 페이지(Root Page) 이동
1. Notion에 로그인합니다.
2. 회사의 모든 문서가 담겨 있는 **가장 상위 폴더** 또는 **워크스페이스 홈 페이지**로 이동합니다.
   - 예: `OOO 회사 홈`, `Team Space`, `공용 문서함` 등

### 2단계: 연결(Connection) 메뉴 진입
1. 페이지 우측 상단의 **`...` (더보기 아이콘)**을 클릭합니다.
2. 메뉴 목록 아래쪽의 **`연결(Connections)`** 또는 **`Connect to`** 항목을 클릭합니다.
   *(이미 연결된 앱이 있다면 해당 앱 이름이 보일 수 있습니다.)*

### 3단계: 챗봇 앱 추가
1. 검색창에 우리 회사의 챗봇 통합 앱 이름(예: `CodeBridge Chatbot` 또는 API 발급 시 설정한 이름)을 검색합니다.
2. 해당 앱을 선택하고 **`초대(Confirm)`** 버튼을 클릭합니다.

---

## 확인 사항
- **권한 상속**: 위 설정을 완료하면, 해당 페이지 내부에 있는 모든 하위 페이지도 챗봇이 읽을 수 있게 됩니다.
- **제외하고 싶은 문서**: 만약 특정 문서를 챗봇이 읽지 못하게 하려면, 해당 하위 페이지로 이동하여 `연결` 메뉴에서 챗봇 앱을 **`연결 해제(Disconnect)`** 하거나, 별도의 비공개 페이지로 이동시켜야 합니다.
- **검색 테스트**: 설정 후 약 1~5분 뒤부터 챗봇에서 해당 문서의 내용을 질문하면 답변을 받을 수 있습니다.

> **참고**: 챗봇은 문서의 **제목**과 **텍스트 내용**을 기반으로 검색을 수행합니다. 문서 제목이 명확할수록 검색 정확도가 높아집니다.
