# 지식 베이스

## 지식 베이스 소개

지식 베이스는 에이전트의 외부 두뇌 역할을 하며, 대형 언어 모델을 넘어선 지식을 제공하여 에이전트가 더 정확한 정보와 특정 분야에서 강력한 기능을 갖출 수 있도록 합니다.\
지식 베이스의 활용 범위는 넓습니다:

* 프로젝트/제품 문서에 접근하여 정밀한 Q\&A 제공.
* 학술 문헌에 접근하여 도메인 전문가가 됨.
* 블로그/트윗에 접근하여 디지털 라이프 구축.
* 게임/애니메이션 위키에 접근하여 고정밀 롤플레잉.
* ...상상할 수 있는 더 많은 활용 시나리오!

## 지식 베이스를 사용하는 방법?

에이전트 편집 페이지에서 “고급 설정” 내 “지식 베이스” 패널로 이동하여 지식 베이스 스위치를 켜고, 링크를 가져와 에이전트에 연결하세요.

<figure><img src="/files/tAQHwnbrZo874tAxS02m" alt=""><figcaption></figcaption></figure>

현재 지원되는 링크 내용은 다음과 같습니다:

* Gitbook
* Docusaurus
* 텍스트 콘텐츠가 주를 이루는 일반 웹 페이지

더 많은 입력 지원이 개발 중이니, 지속적으로 주목해 주세요.

다단계 파싱이 필요한 대량 텍스트 콘텐츠가 있다면 Gitbook 또는 Docusaurus를 사용하세요. 단일 레벨 파싱만 필요하다면 텍스트가 풍부한 어떤 웹 페이지라도 가져올 수 있습니다.

<figure><img src="/files/4EhGdwjS05NFzATqyI6Y" alt=""><figcaption></figcaption></figure>

링크를 가져올 때 상태가 먼저 “가져오는 중”으로 표시되어 웹 페이지가 파싱 중임을 나타냅니다.

가져오기가 성공하면 상태가 초록색 “활성”으로 바뀌며, 지식 베이스 기능을 정상적으로 사용할 수 있습니다!

가져오기가 실패하고 “유효하지 않음”으로 표시되면 입력 링크의 유효성을 확인하세요. Gitbook 링크를 입력한 경우, 가져온 링크가 공개적으로 사용 가능한지 확인하세요.

### 지식 베이스 사용 시 주의사항

1. 순수 텍스트 부분만 지식 베이스 콘텐츠로 사용됩니다. 현재 페이지에 첨부된 파일, 온라인 링크, 이미지, 오디오 등 멀티미디어 콘텐츠는 읽을 수 없습니다.
2. 가능한 한 자연어 텍스트 단락을 가져오고, 표와 같은 복잡한 형식의 콘텐츠는 피하세요.
3. 여러 지식 베이스를 가져올 때, 밀접한 관계가 있는 지식 베이스를 가져오면 더 나은 결과를 얻을 수 있습니다.

### Gitbook 사용 팁

Gitbook은 에이전트 지식 베이스에 정보를 제공하는 중요한 방법입니다. 구조화된 지식 베이스를 편집하고 대량의 정보를 입력할 수 있습니다. 콘텐츠 조직을 위해 MyShell의 공식 문서와 유사한 형식을 사용하는 것이 좋습니다.

**사용법**:

1. Gitbook에서 “Space” 를 생성하고 “Space” 내부에서 문서를 편집하세요.
2. Gitbook의 “Import content” 를 통해 대량 콘텐츠를 가져오거나 수동으로 지식 베이스를 편집할 수 있습니다.
3. 콘텐츠 계층이 복잡할 경우, 왼쪽 사이드바에서 “Subpage” 를 생성하세요.
4. 지식 베이스 콘텐츠가 완성되면 오른쪽 상단의 “Share” 를 클릭하고 “Publish to the web” 를 열어 얻은 링크를 복사하세요.
5. 링크를 MyShell 지식 베이스 인터페이스에 복사하고 붙여넣은 뒤 가져오기를 클릭하세요.
6. 지식 베이스가 성공적으로 파싱되면 아래에 초록색 “활성”이 표시됩니다.

이제 Gitbook 을 통해 대량의 정보를 성공적으로 가져왔습니다!

지식 베이스 콘텐츠를 수정해야 할 경우, “Edit” 를 클릭해 편집 페이지로 들어가세요. 편집이 완료된 후 “Merge” 를 클릭하면 업데이트된 콘텐츠가 자동으로 에이전트에 동기화됩니다.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.myshell.ai/ko/create/classic-mode/knowledge-base.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
