Files

hskwon aca1767eb9 초기 커밋: 5130 레거시 시스템

- URL 하드코딩 → .env APP_URL 기반 동적 URL로 변경
- DB 연결 하드코딩 → .env 기반으로 변경
- MySQL strict mode DATE 오류 수정

2025-12-10 20:14:31 +09:00

2.2 KiB

Raw Permalink Blame History

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

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

핵심 원리

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

설정 방법 (3단계)

1단계: 최상위 페이지(Root Page) 이동

Notion에 로그인합니다.
회사의 모든 문서가 담겨 있는 가장 상위 폴더 또는 워크스페이스 홈 페이지로 이동합니다.
- 예: OOO 회사 홈, Team Space, 공용 문서함 등

2단계: 연결(Connection) 메뉴 진입

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

3단계: 챗봇 앱 추가

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

확인 사항

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

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

2.2 KiB Raw Permalink Blame History