> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/ja/work/file-library/vs-knowledge-base.md).

# ナレッジベースとファイルライブラリ：用途の違いと使い分け

ナレッジベースとファイルライブラリの違い、データの保存先を解説します。一言でわかる位置づけ、利用シーンの比較、よくある誤用、目的別の保存先一覧、同じ Agent や会話での併用方法を紹介します。

**ナレッジベースは試験のときのカンニングペーパー、ファイルライブラリは宿題をするときに手元に置く教科書です。**

どちらもドキュメントを保存できますが、AI による使い方が異なります。ナレッジベースは Agent が**すばやく答えを見つけて**ユーザーに回答するために使い、ファイルライブラリは AI が**元のファイル全体を参照して作業する**ために使います。保存先を誤ると、回答が不正確になったり、応答が遅くなったり、Credits の使用量が増えたりすることがあります。このページでは、データをどちらに保存すべきかを判断する方法を説明します。

***

## 一言でわかる位置づけ <a href="#positioning" id="positioning"></a>

|             | [ナレッジベース](https://docs.maiagent.ai/maiagent-user-guide/ja/build/knowledge-base.md)（RAG） | [ファイルライブラリ](https://docs.maiagent.ai/maiagent-user-guide/ja/work/file-library.md) |
| ----------- | --------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| **たとえ**     | 試験のときのカンニングペーパー                                                                         | 宿題をするときに手元に置く教科書                                                                  |
| **何を保存するか** | Agent の「記憶」です。内容をあらかじめチャンクに分割し、インデックスを作成します                                             | 組織のファイルを集約する場所です。元のファイルをそのままファイルワークスペースに保存します                                     |
| **AI の使い方** | 質問との関連性が最も高いチャンクをいくつか検索し、それに基づいて回答します                                                   | 必要に応じてファイル全体を読んでから回答します。ユーザーの確認後にファイルの編集、名前変更、移動もできます                             |
| **目的**      | ユーザーの質問にできるだけ速く、正確に回答します                                                                | 内容全体に基づいて、文章の作成、取りまとめ、書き直しを支援します                                                  |

試験会場に教科書を何冊も持ち込むことはできないため、カンニングペーパーを用意する、というたとえです。一方、宿題では教科書を開いて全体を参照する必要があります。外部ユーザーの質問への回答は試験に似ており、すばやく答えが見つかるメモが必要です。社内ドキュメントの作成は宿題に似ており、元のファイル全体が必要です。

***

## 利用シーンの比較 <a href="#use-cases" id="use-cases"></a>

|              | ナレッジベース                                                                                                                                                                | ファイルライブラリ                                                                                                                                                                   |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **代表的なシーン**  | 外部向けカスタマーサポート、FAQ への回答、社内規程や SOP の検索                                                                                                                                   | 提案書の作成、複数の見積書の取りまとめ、新しい仕様に合わせた FAQ の更新など、社内ドキュメントの作成、取りまとめ、書き直し                                                                                                             |
| **求めるもの**    | 速さと正確さ                                                                                                                                                                 | 内容全体の参照と編集                                                                                                                                                                  |
| **利用できる場所**  | あらゆる会話プラットフォームの Agent（Web Widget、LINE、API 連携、内部チャット）、および MaiGPT の[ナレッジベース Q\&A](https://docs.maiagent.ai/maiagent-user-guide/ja/work/maigpt/chat.md#knowledge-base-qa) | MaiGPT（[ワークスペースを接続](https://docs.maiagent.ai/maiagent-user-guide/ja/work/file-library/use-in-maigpt.md)）、およびファイルワークスペースを設定した Agent の<mark style="color:blue;">内部チャット</mark> |
| **データの準備方法** | [FAQ](https://docs.maiagent.ai/maiagent-user-guide/ja/build/knowledge-base/faq.md) の作成、データのクレンジング、古い内容や重複した内容の削除など、回答品質を安定させるための整理が必要です                                | 元のファイルを保存し、プロジェクトやテーマごとにワークスペースを分けて整理します                                                                                                                                    |
| **内容は変わるか**  | 比較的固定されています。更新時は再アップロードします                                                                                                                                             | 頻繁に編集します。変更のたびにバージョンが残り、[復元](https://docs.maiagent.ai/maiagent-user-guide/ja/work/file-library/versions.md)できます                                                             |

{% hint style="warning" %}
Web Widget、LINE、API 連携などの会話プラットフォームは、**ファイルライブラリの読み取りも書き込みも一切行いません**。利用するのは MaiGPT と Agent の<mark style="color:blue;">内部チャット</mark>のみです。外部向けカスタマーサポート Agent の回答に使う内容は、ナレッジベースに保存してください。
{% endhint %}

***

## よくある誤用 <a href="#common-mistakes" id="common-mistakes"></a>

| よくある使い方                                                         | 起こること                                                                              | 推奨する方法                                                                                                                                                        |
| --------------------------------------------------------------- | ---------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 製品マニュアルをファイルライブラリに保存し、外部向けカスタマーサポート Agent がそれに基づいて回答することを期待します  | Web Widget や LINE などの会話プラットフォームからはファイルライブラリを読めないため、Agent は回答できません                  | ナレッジベースに保存し、よく聞かれる質問を FAQ にまとめます                                                                                                                              |
| 繰り返し寄せられる大量のよくある質問に、ファイルライブラリで回答します                             | 多数のドキュメント全体を読むと、処理時間や Credits の使用量が増える可能性があります。1 回に読み取れるのは最大 5 ファイルで、複数回に分けて読み取れます | ナレッジベースの FAQ に整理すると、速く一貫した回答ができます                                                                                                                             |
| 整理していない大量の元ファイルをそのままナレッジベースに入れ、Agent にレポートの作成やドキュメント全体の比較を依頼します | ナレッジベースは関連チャンクの検索が中心です。元ファイル全体を 1 つずつ比較する必要がある場合は、参照するドキュメントと範囲を明確に指定する必要があります     | ファイルライブラリのワークスペースに保存し、AI に各ファイル全体を読ませてから取りまとめます                                                                                                               |
| まだ修正を繰り返している下書きをナレッジベースに保存します                                   | 修正のたびに再アップロードと解析待ちが必要で、バージョン履歴もありません。古い内容が回答に使われる可能性もあります                          | 下書きはファイルライブラリに保存し、確定して Agent の外部向け回答に使う段階でナレッジベースに入れます                                                                                                        |
| 整理せずにすべてのドキュメントをナレッジベースに入れます                                    | 無関係なチャンクや矛盾するチャンクが根拠に使われ、回答が不正確になります                                               | Agent のタスクに関連するクレンジング済みの内容だけを保存し、公開前に[検索テスト](https://docs.maiagent.ai/maiagent-user-guide/ja/build/knowledge-base/test-search-result.md)で正しいチャンクが見つかることを確認します |

***

## 何をしたいか → どこに保存するか <a href="#decision-table" id="decision-table"></a>

| やりたいこと                                                     | 保存先                                                                                                 |
| ---------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| 公式サイトや LINE のカスタマーサポート Agent に、製品、プラン、返品・交換に関する質問に回答させたいです | ナレッジベース                                                                                             |
| Agent によくある質問への標準回答を使わせたいです                                | ナレッジベース（FAQ）                                                                                        |
| 社員が MaiGPT で社内規程や SOP を調べられるようにしたいです                       | ナレッジベース                                                                                             |
| 仕様書と顧客の要望に基づいて、AI に提案書を作成してほしいです                           | ファイルライブラリ                                                                                           |
| 複数の見積書や契約書の違いを全体にわたって比較したいです                               | ファイルライブラリ                                                                                           |
| AI にドキュメントの内容を直接編集させ、変更履歴を残したいです                           | ファイルライブラリ                                                                                           |
| AI が会話中に生成したドキュメントや画像を保存したいです                              | ファイルライブラリ（<mark style="color:blue;">マイファイル</mark>の<mark style="color:blue;">一時保存領域</mark>に自動保存されます） |
| 同じデータを外部向けの回答にも社内での書き直しにも使いたいです                            | 両方に保存します。元のファイルはファイルライブラリで管理し、整理済みの確定版や FAQ はナレッジベースに保存します                                          |

まだ迷う場合は、**「答えを見つけたい」のか、「ファイル全体を扱いたい」のか**を考えてください。答えを探すならナレッジベース、ファイルを扱うならファイルライブラリです。

***

## 同じ Agent や会話で併用できますか <a href="#use-together" id="use-together"></a>

はい、併用できます。両者は競合せず、AI が質問に応じて、ナレッジベースのチャンクを検索するか、ワークスペースのファイルを読み取るかを判断します。

### MaiGPT の会話で併用する <a href="#together-in-maigpt" id="together-in-maigpt"></a>

同じ MaiGPT の会話で、[ワークスペースを接続](https://docs.maiagent.ai/maiagent-user-guide/ja/work/file-library/use-in-maigpt.md#start-chat)しながら、<mark style="color:blue;">ナレッジベースを選択</mark>で検索対象のナレッジベースを指定できます。

たとえば、カスタマーサポート研修の担当者が、ワークスペースの元ファイルとナレッジベースを同時に参照したい場合です。サンプルの保証 FAQ を保存したワークスペースで<mark style="color:blue;">ここから会話を開始</mark>をクリックし、図書館のサンプルナレッジベースも選択して、「ワークスペースのドキュメントにある本体とモーターの保証期間はどのくらいですか？ナレッジベースにある学部生と大学院生の貸出期間はそれぞれどのくらいですか？」と質問します。MaiGPT は 1 つの回答でワークスペースの元ファイルとナレッジベースをそれぞれ引用するため、2 種類のデータソースを確認できます。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-865b65ea7c63f20df5411d1e3d0c033cc60d9650%2Fkb-file-library-prod-answer.png?alt=media" alt="1 つの回答に、ワークスペースのドキュメントの保証情報と、選択したナレッジベースの貸出期間が表示されています"><figcaption><p>同じ MaiGPT の会話で、ワークスペースの元ファイルと選択したナレッジベースをそれぞれ引用して回答しています。画像内の内容はすべて架空のサンプルデータです。</p></figcaption></figure>

### Agent の設定で併用する <a href="#together-in-agent" id="together-in-agent"></a>

組織でファイルライブラリを有効にすると、Agent 設定の左側にある<mark style="color:blue;">ナレッジとデータ</mark>グループに<mark style="color:blue;">ファイルワークスペース</mark>が表示され、<mark style="color:blue;">ナレッジベース設定</mark>と同時に設定できます。ファイルワークスペースは、この Agent が<mark style="color:blue;">内部チャット</mark>でファイルライブラリをどう使うかを決めます。

| オプション                                       | 説明                                                   |
| ------------------------------------------- | ---------------------------------------------------- |
| <mark style="color:blue;">使用しない</mark>      | ワークスペースの読み取りも書き込みも行いません（デフォルト）                       |
| <mark style="color:blue;">ワークスペースを固定</mark> | 1 つのワークスペースに固定して作業し、読み取りも生成物の保存もそこで行います。ユーザーは変更できません |
| <mark style="color:blue;">ユーザーが自分で接続</mark> | ユーザーが会話中に接続するファイルワークスペースを選択できます                      |

同じ Agent にナレッジベースとファイルワークスペースの両方を設定した場合は、次のように動作します。

* **Web Widget、LINE、API 連携などの会話プラットフォーム**：ナレッジベースのみを使って回答します。
* <mark style="color:blue;">**内部チャット**</mark>：ナレッジベースの検索と、ワークスペースのファイルの読み書きを併用できます。

よくある構成は、「**ナレッジベースを Q\&A の根拠にし、ファイルライブラリに作業用の元ファイルを保存する**」という使い方です。AI にファイルの生成や編集もさせたい場合は、[AI にファイルを編集・整理させる](https://docs.maiagent.ai/maiagent-user-guide/ja/work/file-library/ai-edit.md)の手順に従ってください。単に質問したり、構成案を依頼したりするだけでは、必ずしもファイルが生成されるわけではありません。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-ead1f1f37504807cf19b7c758800e66a17fd15eb%2Fagent-file-workspace-prod.png?alt=media" alt="Agent のファイルワークスペース設定に、使用しない、ワークスペースを固定、ユーザーが自分で接続の 3 つのオプションが表示されています"><figcaption><p>Agent のファイルワークスペースは、使用しない、固定して接続する、ユーザーが自分で接続する、のいずれかに設定できます。標準の案内にも、外部チャネルではファイルライブラリの読み書きを行わないことが記載されています。</p></figcaption></figure>

{% hint style="info" %}

* ワークスペースを固定するには、Agent を設定する人にそのワークスペースの編集権限が必要です。
* ワークスペースを固定した後も、各ユーザーが会話中にそのワークスペースを読み書きできるかどうかは、本人のファイルライブラリ権限によって決まります。閲覧権限しかないユーザーに対しては、AI はファイルの読み取りのみを行い、編集や生成物の保存は行いません。権限設定については、[有効化と権限](https://docs.maiagent.ai/maiagent-user-guide/ja/work/file-library.md#availability-and-permissions)を参照してください。
  {% endhint %}

***

## 関連ページ <a href="#related" id="related"></a>

* [ナレッジベース](https://docs.maiagent.ai/maiagent-user-guide/ja/build/knowledge-base.md)：ナレッジベースの概要と保存できる内容
* [FAQ（よくある質問）の作成方法](https://docs.maiagent.ai/maiagent-user-guide/ja/build/knowledge-base/faq.md)
* [ファイルライブラリ](https://docs.maiagent.ai/maiagent-user-guide/ja/work/file-library.md)：容量、ファイルワークスペース、権限
* [MaiGPT でワークスペースを使う](https://docs.maiagent.ai/maiagent-user-guide/ja/work/file-library/use-in-maigpt.md)
* [AI にファイルを編集・整理させる](https://docs.maiagent.ai/maiagent-user-guide/ja/work/file-library/ai-edit.md)
* 技術者向けマニュアル：[ナレッジベース vs ファイルライブラリ：仕組みと選定基準](https://docs.maiagent.ai/tech/quickstart/knowledge-base-vs-file-library)：SI、プリセールス、導入エンジニア向けの、仕組み、権限、容量、課金の違い


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.maiagent.ai/maiagent-user-guide/ja/work/file-library/vs-knowledge-base.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
