> For the complete documentation index, see [llms.txt](https://docs.cherryai.com.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherryai.com.cn/docs/jp/knowledge-base/knowledge-base.md).

# ナレッジベース入門

ナレッジベースは、ファイル、メモ、ディレクトリ、またはWebページを、繰り返し検索できる資料コレクションとして整理します。まず再現率テストで、システムが正しい断片を見つけられることを確認し、その後ナレッジベースを対話やAgentで使用します。

{% hint style="info" %}
短い文章を一時的に処理するだけなら、そのまま対話に貼り付けるほうが早いです。資料を繰り返し使う場合や、回答を必ず内部資料に基づかせる必要がある場合に、ナレッジベースを作成します。
{% endhint %}

## どんなときに使うのが適切か

| 要件                         | 推奨方法                  | 理由                           |
| -------------------------- | --------------------- | ---------------------------- |
| 社員規程、製品マニュアル、プロジェクト資料を検索する | ナレッジベースを作成する          | 資料を繰り返し使うため、原文を安定して参照する必要がある |
| 添付ファイルを一時的に分析する            | 対話で直接アップロードする         | 長期的な管理やインデックス作成は不要           |
| 資料はまだ継続的に整理中               | まず【メモ】で整理する           | 未確認の内容が正式な回答として扱われるのを避ける     |
| 資料を長期的に自動処理する必要がある         | ナレッジベース作成後にAgentを紐づける | Agentはタスクの中で同じ資料範囲を継続して使用できる |

## 1回の回答で何が起こるか

<figure><img src="/files/edc5365fff3a4c1f05f12e1a504088b27b4673bc" alt="从资料解析、分块、BM25 与向量检索到合并、重排和 Top K 的知识库检索架构图"><figcaption><p>資料はまず解析と分割を受け、その後キーワードまたは意味で候補断片が見つけられます。チャットモデルは、再現された内容に基づいて回答を組み立てるだけです。</p></figcaption></figure>

### まずこれらの用語を理解する

| 名称        | このタスクでの意味                                        |
| --------- | ------------------------------------------------ |
| ナレッジベース   | 同じテーマを中心に整理された、一組の資料と検索設定                        |
| 資料項目      | 取り込まれた1つのファイル、メモ、ディレクトリ内のファイル、またはWebページのスナップショット |
| チャンク      | 資料を分割した後、検索に使われる小さな断片                            |
| 再現率       | 質問に基づいて関連する断片を見つけ出すプロセス                          |
| 埋め込みモデル   | 文章をベクトルに変換し、表現は違っても意味が近い内容を照合するために使うもの。必須ではない    |
| リランキングモデル | 候補断片を再度採点して並べ替えるもの。これも任意                         |

{% hint style="success" %}
埋め込みモデルがなくてもナレッジベースは使えます。その場合は主にBM25のキーワード検索に依存します。初回体験では、まず【使用しない】を選び、作成、取り込み、再現の流れを通してみてください。
{% endhint %}

## 5分で初回使用を完了

{% stepper %}
{% step %}

### 1. 境界が明確なナレッジベースを作成する

左側ナビゲーションの【ナレッジベース】を開き、ナレッジベース一覧の上にある追加ボタンをクリックします。名称は「対象 + 用途」にします。例：【社員出張規程】。
{% endstep %}

{% step %}

### 2. 検索方式を選ぶ

初回体験では【埋め込みモデル】を【使用しない】に設定できます。口語的な質問や同義表現に合わせたい場合は、その後で埋め込みモデルを設定します。
{% endstep %}

{% step %}

### 3. 資料を追加する

ナレッジベースに入ってから資料追加ボタンをクリックし、【ファイル】、【メモ】、【ディレクトリ】、または【リンク】を選びます。

<figure><img src="/files/82377b2a71ca10f68f1abd005dfc4bf682ba9635" alt="知识库中的文件、笔记、目录和链接四种资料入口"><figcaption><p>資料の出どころに応じて入口を選んでください。操作を減らそうとして、関係のないディレクトリまでまとめて取り込まないでください。</p></figcaption></figure>
{% endstep %}

{% step %}

### 4. 資料が利用可能になるのを待つ

処理が完了すると、資料は一覧に表示されます。本文とチャンクを抜き取り確認し、文字化け、ページ抜け、明らかな順序の乱れがないか確認します。

<figure><img src="/files/33438f8060e398ac476e2ef4640044bcd0903fa7" alt="包含多条已处理资料的员工差旅制度知识库"><figcaption><p>資料が利用可能になっても、内容の抜き取り確認は必要です。取り込み完了は、検索品質が合格したことを意味しません。</p></figcaption></figure>
{% endstep %}

{% step %}

### 5. 再現テストを完了する

【再現テスト】を開き、すでに答えを知っている実際の質問を入力し、正しい出典が上位結果に表示されるか確認します。
{% endstep %}

{% step %}

### 6. 対話に進むか、Agentに紐づける

再現が安定したら、対話の入力欄でナレッジベースを選択します。長期的なワークフローが必要な場合は、Agent編集ページでナレッジベースを紐づけます。
{% endstep %}
{% endstepper %}

## 推奨の出発点

| 設定項目       | 製品のデフォルト値 | 推奨の出発点                 | 役割                      | 適用シーン           | 注意点                           |
| ---------- | --------- | ---------------------- | ----------------------- | --------------- | ----------------------------- |
| ナレッジベースの範囲 | —         | 1つの明確なテーマ              | 検索に一緒に参加する資料を制御する       | 規程、製品、プロジェクト資料  | 権限やライフサイクルが異なる内容は分けるべき        |
| 埋め込みモデル    | 使用しない     | ひとまず使用しない              | ベクトル検索を追加するかどうかを決める     | 口語的な質問と原文の差が大きい | クラウドモデルの課金とデータ処理はサービス提供元に依存する |
| テスト質問      | —         | 実際の質問3～5件              | 長期的な回帰ベースラインを構築する       | 資料や設定を更新するたびに   | 資料タイトルと原文だけでテストしない            |
| 正式利用に入る    | —         | 資料、チャンク、再現の3項目がすべて通過する | 解析や検索の問題を対話に持ち込まないようにする | すべてのナレッジベース     | チャットモデルは、再現されなかった重要情報を補完できない  |

## すでに使用可能かどうかの判断方法

* 必要な資料はすべて利用可能状態になっており、処理中やエラー状態のまま長く止まっていない。
* 1～2件の資料をランダムに開き、本文とチャンクに文字化け、ページ抜け、明らかな順序の乱れがない。
* 固定の質問で再現テストを行い、正しい出典が安定して上位結果に表示される。

## ユーザー事例

小林さんは、同僚が出張規程を検索できるようにしたいと考えました。そこで【社員出張規程】ナレッジベースを作成し、宿泊、交通、承認の3つの資料を取り込み、まず埋め込みモデルは設定しませんでした。3つの資料が利用可能になった後、「北京での宿泊上限はいくらか」「5000元以上は誰が承認するか」などの質問でテストしました。

合格基準は、各質問で正しい規程の出典が見つかり、断片に適用条件と結論の両方が含まれていることです。この基準に達してから初めて、彼は社員Q\&Aを担当するAgentにナレッジベースを紐づけました。

## よくある質問

<details>

<summary>ナレッジベースとチャットモデルの違いは何ですか？</summary>

ナレッジベースはあなたの資料から断片を見つける役割を担い、チャットモデルは質問を理解して回答を組み立てる役割を担います。再現段階で重要情報が見つからない場合、単にチャットモデルを変更しても通常は解決しません。

</details>

<details>

<summary>資料の取り込みに成功したら、そのまま使えますか？</summary>

本文とチャンクの抜き取り確認を行い、再現テストも完了する必要があります。取り込み成功は、処理が終わったことを示すだけで、結果が完全であることや並び順が正しいことを意味しません。

</details>

<details>

<summary>チャンク設定を変更した後、既存資料は自動で変わりますか？</summary>

変わりません。既存資料に新しいチャンク設定を適用するには、【再インデックス】を実行し、同じ質問セットで再テストする必要があります。

</details>

## 続きを読む

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>ナレッジベースを作成する</strong></td><td>名称の境界と検索方式を決める。</td><td><a href="/pages/019ee2469f7ee963d95225e1f388331b4322ee1a">/pages/019ee2469f7ee963d95225e1f388331b4322ee1a</a></td></tr><tr><td><strong>資料を追加・整理する</strong></td><td>ファイル、メモ、ディレクトリ、Webページを取り込む。</td><td><a href="/pages/52419c0c8143ffa7c66f9f3048af576a7b985d6b">/pages/52419c0c8143ffa7c66f9f3048af576a7b985d6b</a></td></tr><tr><td><strong>資料と再現を確認する</strong></td><td>固定の質問で検索品質を検収する。</td><td><a href="/pages/e3b03b5648a5fd135fedd068ff34a7f23055261c">/pages/e3b03b5648a5fd135fedd068ff34a7f23055261c</a></td></tr><tr><td><strong>モデルと検索の設定</strong></td><td>埋め込み、リランキング、チャンクを引き続き調整する。</td><td><a href="/pages/552981e5e3388b3c03d9768a3befa7afa506edbe">/pages/552981e5e3388b3c03d9768a3befa7afa506edbe</a></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.cherryai.com.cn/docs/jp/knowledge-base/knowledge-base.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.