> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudthinker.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 지식 베이스

> AI 에이전트가 조직의 지식, 문서, 절차를 활용할 수 있도록 지식 베이스를 생성하고 관리합니다

AI 에이전트에게 문서를 업로드하거나 웹사이트를 크롤링하여 조직의 지식에 접근할 수 있게 합니다. 에이전트는 이 정보를 참조하여 더욱 정확하고 맥락에 맞는 응답을 제공합니다.

***

## 일반 AI의 한계

일반 AI 모델은 AWS 모범 사례는 알고 있지만 — *여러분의* AWS 환경은 알지 못합니다. 회사 정책상 모든 S3 버킷에 특정 키 ARN의 SSE-KMS를 사용해야 한다는 것을 모릅니다. 재해 복구 RTO가 AWS 권장 1시간이 아닌 4시간이라는 것도 모릅니다. 인시던트 대응 절차에서 모든 복구 조치 전에 Opsgenie 알림을 보내야 한다는 것도 알 수 없습니다.

그 결과: 정책과 충돌하거나, 기존 문서와 모순되거나, 모든 시니어 엔지니어는 알지만 일반 AI가 놓치는 회사별 컨텍스트를 반영하지 못하는 권장 사항이 나옵니다.

**지식 베이스가 이 문제를 해결합니다.** 런북, 정책, 컴플라이언스 문서, 아키텍처 문서를 연결하면 CloudThinker 에이전트가 일반적인 클라우드 모범 사례가 아닌 여러분 조직의 고유한 지식을 바탕으로 동작합니다.

***

## 일반 RAG와의 비교

| 접근 방식           | 일반 AI    | CloudThinker 지식 베이스      |
| --------------- | -------- | ------------------------ |
| **회사 정책**       | 알 수 없음   | 색인되어 관련 모든 응답에 참조        |
| **커스텀 런북**      | 없음       | 관련 시 자동으로 가져옴            |
| **아키텍처 컨텍스트**   | 일반 모범 사례 | 여러분의 구체적인 설계 결정과 제약      |
| **컴플라이언스 요구사항** | 표준 프레임워크 | 여러분의 구체적인 감사 요구사항과 증거 형식 |
| **인시던트 절차**     | 일반적인 단계  | 회사의 정확한 에스컬레이션 경로와 도구    |

| 소스 유형      | 기능                                     |
| ---------- | -------------------------------------- |
| **문서 업로드** | PDF, Word 문서, 텍스트 파일을 추가하여 지식 레포지토리 생성 |
| **웹 크롤링**  | 웹사이트, 위키, 문서 사이트를 자동으로 색인              |

***

## 빠른 설정

<Steps>
  <Step title="지식 베이스 생성">
    CloudThinker의 **Knowledge**로 이동하여 **"Create Knowledge Base"** 클릭
  </Step>

  <Step title="유형 선택">
    콘텐츠 소스에 따라 **Document Upload** 또는 **Web Crawler** 선택
  </Step>

  <Step title="설정 구성">
    * **Name**: 설명적인 이름 지정
    * **Description**: 콘텐츠에 대한 간략한 개요
    * **Access**: 이 지식 베이스를 사용할 수 있는 사용자 선택
  </Step>

  <Step title="콘텐츠 추가">
    문서를 업로드하거나 웹 크롤링을 설정합니다(아래 섹션 참조)
  </Step>
</Steps>

***

## 문서 업로드

### 지원 파일 형식

* **텍스트**: TXT, Markdown, RTF
* **오피스**: Word (.docx), PowerPoint (.pptx), Excel (.xlsx)
* **PDF**: Adobe PDF 파일
* **웹**: HTML, XML, JSON

### 업로드 방법

<Tabs>
  <Tab title="단일 파일">
    1. **"Upload Document"** 클릭
    2. 파일 선택 (최대 50MB)
    3. 제목과 태그 추가
    4. **"Upload"** 클릭
  </Tab>

  <Tab title="여러 파일">
    1. 최대 100개 파일을 드래그 앤 드롭
    2. 또는 ZIP 파일 업로드
    3. 일괄 메타데이터 추가
    4. **"Process All"** 클릭
  </Tab>
</Tabs>

***

## 웹 크롤링

### 기본 설정

<Steps>
  <Step title="웹사이트 URL 입력">
    크롤링을 시작할 웹페이지 URL을 입력합니다
  </Step>

  <Step title="한도 설정">
    * **Depth**: 클릭 깊이 (1-10)
    * **Pages**: 크롤링할 최대 페이지 수 (100-10,000)
  </Step>

  <Step title="스케줄 선택">
    * **One-time**: 1회 크롤링
    * **Daily**: 24시간마다 업데이트
    * **Weekly**: 주간 업데이트
    * **Manual**: 직접 트리거할 때만
  </Step>
</Steps>

### 일반적인 예시

* 문서 사이트 (GitBook, Confluence)
* 회사 위키
* 고객 지원 센터 및 FAQ
* GitHub 레포지토리

***

## 지식 베이스 사용

### 접근 모드

| 모드                        | 동작                          |
| ------------------------- | --------------------------- |
| **Always Available** (자동) | 에이전트가 모든 대화에서 이 지식을 자동으로 사용 |
| **Manual Search** (온디맨드)  | `#kb` 명령으로 요청할 때만 에이전트가 사용  |

### 에이전트 명령어

```text theme={null}
# 모든 지식 베이스 검색
@alex #kb find AWS cost optimization strategies

# 특정 지식 베이스 검색
@tony #kb:database-guide PostgreSQL backup procedures

# 에이전트가 지식 사용 시점을 결정 (Always 모드)
@oliver analyze this security incident
# Oliver가 보안 절차를 자동으로 참조
```

### 에이전트 예시

<Tabs>
  <Tab title="Alex - 클라우드 엔지니어">
    **지식 유형:**

    * AWS 문서 및 가이드
    * 비용 최적화 플레이북
    * 인프라 절차

    **예시:**

    ```
    @alex #kb find EC2 cost savings
    → References uploaded cost optimization guide
    → Provides specific recommendations
    ```
  </Tab>

  <Tab title="Oliver - 보안 엔지니어">
    **지식 유형:**

    * 보안 정책 및 절차
    * 컴플라이언스 문서
    * 인시던트 대응 플레이북

    **예시:**

    ```
    @oliver #kb security incident response
    → References uploaded incident procedures
    → Provides step-by-step guidance
    ```
  </Tab>

  <Tab title="Tony - 데이터베이스 엔지니어">
    **지식 유형:**

    * 데이터베이스 관리 가이드
    * 성능 튜닝 문서
    * 백업 및 복구 절차

    **예시:**

    ```
    @tony #kb PostgreSQL performance tuning
    → References database optimization guide
    → Suggests specific improvements
    ```
  </Tab>
</Tabs>

***

## 모범 사례

### 콘텐츠 구성

**문서 구조 (검색 가능하게 만들기):**

* 명확한 제목 사용 (H1, H2, H3)
* 목차 포함
* 관련 키워드 추가
* 불릿 포인트와 목록 사용

**태그 지정 (스마트 구성):**

* 일관된 태그 이름 사용
* 기능별 태그 포함 (security, database, aws)
* 우선순위 레벨 추가 (critical, reference)
* 부서/팀 태그 포함

### 유지보수 팁

* 월별로 콘텐츠를 검토하고 업데이트
* 오래된 문서 삭제
* 어떤 콘텐츠가 가장 많이 사용되는지 모니터링
* 검색 기능을 정기적으로 테스트

***

## 빠른 예시

### 예시 1: 회사 절차

```yaml theme={null}
Name: "Operations Procedures"
Type: Document Upload
Content: 
  - Employee handbook (PDF)
  - IT policies (Word docs)
  - Emergency procedures (PDF)
Access: Always Available
Agents: All agents can reference
```

### 예시 2: 기술 문서

```yaml theme={null}
Name: "AWS Documentation"
Type: Web Crawler
URL: "https://docs.aws.amazon.com/"
Schedule: Weekly updates
Access: Manual (#kb command)
Agents: Alex (primary), others as needed
```

### 예시 3: 보안 정책

```yaml theme={null}
Name: "Security Compliance"
Type: Document Upload
Content:
  - SOC 2 checklist (PDF)
  - Security policies (Multiple PDFs)
  - Incident templates (Word)
Access: Manual (sensitive content)
Agents: Oliver (full access), others (limited)
```

***

## 시작 체크리스트

<Steps>
  <Step title="지식 계획">
    * [ ] 핵심 문서 및 웹사이트 파악
    * [ ] 명명 규칙 결정
    * [ ] 각 지식 베이스의 접근 수준 선택
  </Step>

  <Step title="첫 번째 지식 베이스 생성">
    * [ ] CloudThinker에서 지식 베이스 생성
    * [ ] 중요한 문서 3-5개 업로드 또는 웹 크롤링 설정
    * [ ] 적절한 태그와 설명 추가
    * [ ] 검색 기능 테스트
  </Step>

  <Step title="에이전트 설정">
    * [ ] 각 에이전트에 대한 지식 베이스 접근 설정
    * [ ] `#kb` 명령어로 수동 검색 테스트
    * [ ] 중요한 지식에 "Always Available" 설정
    * [ ] 팀에 사용 명령어 교육
  </Step>

  <Step title="모니터링 및 개선">
    * [ ] 어떤 콘텐츠가 가장 많이 사용되는지 확인
    * [ ] 오래된 정보 업데이트
    * [ ] 팀 요구사항에 따라 새로운 지식 추가
    * [ ] 피드백 수집 및 최적화
  </Step>
</Steps>

***

## 트러블슈팅

<Accordion title="에이전트가 정보를 찾을 수 없음">
  **해결 방법:**

  * 에이전트가 지식 베이스에 접근 권한이 있는지 확인
  * 지식 베이스가 "Always Available"로 설정되어 있는지 확인하거나 `#kb` 명령어 사용
  * 문서 제목을 개선하고 더 많은 키워드 추가
  * 다른 검색어로 검색 테스트
</Accordion>

<Accordion title="문서가 업로드되지 않음">
  **해결 방법:**

  * 파일 크기 확인 (파일당 최대 50MB)
  * 파일 형식이 지원되는지 확인
  * 문서에 비밀번호가 걸려 있지 않은지 확인
  * 파일을 하나씩 업로드 시도
</Accordion>

<Accordion title="웹 크롤링이 작동하지 않음">
  **해결 방법:**

  * 웹사이트 URL이 접근 가능한지 확인
  * 웹사이트가 크롤러를 차단하는지 확인 (robots.txt)
  * 더 적은 페이지 수로 시작
  * 단일 페이지 크롤링 먼저 시도
</Accordion>

***

## 다음 단계

<Note>
  **성공 팁:**

  * 가장 중요한 문서부터 소규모로 시작하세요
  * 모든 항목에 명확하고 설명적인 이름을 사용하세요
  * 본격 사용 전에 검색 기능을 테스트하세요
  * 팀에 `#kb` 명령어 문법을 교육하세요
</Note>

<CardGroup cols={2}>
  <Card title="🚀 지식 베이스 생성" icon="rocket" href="https://app.cloudthinker.io/knowledge">
    **지금 시작하기**

    첫 번째 지식 베이스를 만들고 콘텐츠 업로드를 시작하세요
  </Card>

  <Card title="🤖 에이전트 설정" icon="robot" href="/ko/guide/agents">
    **AI 에이전트 설정**

    에이전트가 지식 베이스를 효과적으로 활용하도록 설정합니다
  </Card>
</CardGroup>