Gitbook
GitBook Import 설정 가이드
개요
AiTalk.ch의 GitBook Import 기능을 사용하면 GitBook에 작성된 문서를 AI 에이전트의 지식 베이스로 가져올 수 있습니다.
1. Access Token 발급 방법
GitBook Developer Settings에서 Access Token을 발급받아야 합니다.
발급 절차:
- GitBook에 로그인합니다
- 좌측 하단의 Settings 아이콘(⚙️)을 클릭합니다
- Settings → Developer Settings로 이동합니다
- Personal Access Tokens 섹션에서 Create new token을 클릭합니다
- 토큰 이름을 입력하고 생성합니다
- 생성된 토큰을 복사하여 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에서 확인
- GitBook에서 해당 Space를 엽니다
- 좌측 하단의 Space Settings (⚙️)를 클릭합니다
- General 탭에서 Space ID를 확인할 수 있습니다
3. Published Base URL 설정
GitBook을 커스텀 도메인으로 퍼블리시한 경우 해당 URL을 입력합니다.
- 예:
https://docs.example.com/ - GitBook 기본 도메인을 사용하는 경우:
https://[조직명].gitbook.io/[space명]/
4. 연결 테스트
모든 정보를 입력한 후:
- Save Settings를 클릭하여 설정을 저장합니다
- Test Connection을 클릭하여 연결이 정상적인지 확인합니다
- "Connected" 상태가 표시되면 설정 완료입니다
문제 해결
| 증상 | 해결 방법 |
|---|---|
| 연결 실패 | Access Token이 올바른지 확인하세요 |
| Space를 찾을 수 없음 | Space ID가 정확한지 확인하세요 |
| 문서를 불러올 수 없음 | GitBook Space가 퍼블리시되어 있는지 확인하세요 |