목차

Gitbook

GitBook Import 설정 가이드

개요

AiTalk.ch의 GitBook Import 기능을 사용하면 GitBook에 작성된 문서를 AI 에이전트의 지식 베이스로 가져올 수 있습니다.


1. Access Token 발급 방법

GitBook Developer Settings에서 Access Token을 발급받아야 합니다.

발급 절차:

  1. GitBook에 로그인합니다
  2. 좌측 하단의 Settings 아이콘(⚙️)을 클릭합니다
  3. Settings → Developer Settings로 이동합니다
  4. Personal Access Tokens 섹션에서 Create new token을 클릭합니다
  5. 토큰 이름을 입력하고 생성합니다
  6. 생성된 토큰을 복사하여 AiTalk.ch의 Access Token 필드에 붙여넣습니다

⚠️ 주의: 토큰은 생성 시 한 번만 표시됩니다. 안전한 곳에 보관하세요.


2. Space ID 찾는 방법

Space ID는 GitBook의 특정 문서 공간을 식별하는 고유 코드입니다.

방법 1: URL에서 확인

  • GitBook 문서 편집 화면의 URL을 확인합니다
  • 형식: https://app.gitbook.com/s/[Space ID]/...
  • 예: https://app.gitbook.com/s/XF5Q8drxdQOBisGrmGGu/ → Space ID는 XF5Q8drxdQOBisGrmGGu

방법 2: Space Settings에서 확인

  1. GitBook에서 해당 Space를 엽니다
  2. 좌측 하단의 Space Settings (⚙️)를 클릭합니다
  3. General 탭에서 Space ID를 확인할 수 있습니다

3. Published Base URL 설정

GitBook을 커스텀 도메인으로 퍼블리시한 경우 해당 URL을 입력합니다.

  • 예: https://docs.example.com/
  • GitBook 기본 도메인을 사용하는 경우: https://[조직명].gitbook.io/[space명]/

4. 연결 테스트

모든 정보를 입력한 후:

  1. Save Settings를 클릭하여 설정을 저장합니다
  2. Test Connection을 클릭하여 연결이 정상적인지 확인합니다
  3. "Connected" 상태가 표시되면 설정 완료입니다

문제 해결

증상해결 방법
연결 실패Access Token이 올바른지 확인하세요
Space를 찾을 수 없음Space ID가 정확한지 확인하세요
문서를 불러올 수 없음GitBook Space가 퍼블리시되어 있는지 확인하세요