> 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/maiagent-user-guide-ja/km/km.md).

# ナレッジベース総覧

## ナレッジベースとは？ <a href="#what-is-knowledge-base" id="what-is-knowledge-base"></a>

AI アシスタントの作成が完了したら、次に設定するのが**ナレッジベース**です。これは、AI アシスタントが質問に回答する際の情報源となります。

ナレッジベースの仕組み：

<figure><img src="/files/xJM0msOPjiXMQiF8yLDd" alt=""><figcaption><p>ナレッジベースの仕組みのイメージ図</p></figcaption></figure>

ナレッジベースは、オープンブック試験（Open Book）のようなものだとイメージしてください。AI アシスタントは、ナレッジベースの中から質問に最も関連性の高い内容を見つけ出し、それを回答の根拠とします。

ナレッジベースには大量のデータを格納できますが、それでもアシスタントのタスクと関連性の高い内容をアップロードすることをおすすめします。関連性の低いデータが含まれていると、現在の検索技術では、無関係な情報を回答のコンテキストとして取得してしまい、回答が不正確になる場合があります。

## ナレッジベースで何ができる？ <a href="#what-can-knowledge-base-do" id="what-can-knowledge-base-do"></a>

ナレッジベースの以下の機能を活用することで、次のことが可能になります。

### 📋 **タグによる文書管理** <a href="#tag-document-management" id="tag-document-management"></a>

各文書に複数のタグを付与し、体系的な分類構造を構築できます。

* **例**：「テントマニュアル」に `#テント #初心者 #設営ガイド` というタグを付ける

### 🔐 **文書権限の選択的な開放** <a href="#selective-document-permissions" id="selective-document-permissions"></a>

ユーザーの属性に応じて文書ごとに異なるアクセス権限を設定し、差別化されたサービスを実現できます。

* **例**：製品価格表は VIP 会員との会話でのみ開放し、原価データは社内向けの会話でのみ開放する

### ❓ **FAQ の作成** <a href="#create-faq" id="create-faq"></a>

よくある質問を標準的な質問応答集としてまとめ、回答の一貫性と網羅性を確保できます。

* **例**：「テントの保証期間は何年ですか？」→ 標準回答：「3 年間の保証サービスを提供しています」

### 📊 **文書の Metadata の入力** <a href="#document-metadata-input" id="document-metadata-input"></a>

文書にバージョン、更新日、適用範囲などの詳細情報を追加でき、今後の文書メンテナンスが容易になります。

* **例**：文書バージョン v2.1、更新日 2024/11/28、適用製品「山岳シリーズテント」

### 🔍 **検索テスト** <a href="#search-testing" id="search-testing"></a>

さまざまな質問に対する検索結果をテストし、AI が正しいデータ片を見つけられているかを検証できます。

* **例**：「テントの設営手順」と入力 → AI が正しい設営ガイドの片を見つけられているか確認する

## ナレッジベースをアップロードするには？ <a href="#how-to-upload-knowledge-base" id="how-to-upload-knowledge-base"></a>

1. 左側のメニュー「<mark style="color:blue;">AI 機能</mark>」→「<mark style="color:blue;">ナレッジベース</mark>」に入ります
2. アップロードするナレッジベースを選択します（まだ作成していない場合は、まず [ナレッジベースの作成方法：基本設定](/maiagent-user-guide/maiagent-user-guide-ja/km/km-basic-settings.md) を参照してください）
3. ナレッジベースのページ右上にある青色の「<mark style="color:blue;">ファイルをアップロード</mark>」ボタンをクリックし、AI アシスタントに知ってほしいデータをアップロードします

{% hint style="info" %}

* プランによって提供されるナレッジベースの容量は異なります
* ファイルが大きい場合やデータ量が多い場合は、アップロード後にシステムの処理に時間がかかることがあります。
  {% endhint %}

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

「<mark style="color:blue;">処理状況</mark>」の欄で処理の進捗を確認できます。

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

{% hint style="success" %}
現在ナレッジベースがサポートしているファイル形式：

* 表計算ファイル：`.xls, .xlsx, .csv, .ods`
* 文書処理ファイル：`.doc, .docx, .odt, .pdf, .md, .txt`
* プレゼンテーションファイル：`.ppt, .pptx, .odp`
* Web ファイル：`.html, .htm`
* データ形式：`.json, .jsonl`
* 音声ファイル：`.wav, .mp3, .m4a, .aac`
* 動画ファイル：`.mp4`
  {% endhint %}

### データを確認する <a href="#view-data" id="view-data"></a>

#### データ片についての説明 <a href="#chunk-description" id="chunk-description"></a>

データをナレッジベースにアップロードすると、データは複数の片（チャンク）に分割されます。これには以下のようなメリットがあります。

* **検索精度の向上**：小さな片はクエリとより正確にマッチし、無関係な内容による干渉を防ぎます
* **応答速度の最適化**：処理が速くなり、計算リソースの消費を抑えます
* **内容の関連性の強化**：各片が単一のトピックに集中するため、的確さが高まります
* **メンテナンスと管理の容易化**：更新、追跡、品質管理が容易になります
* **AI モデルの制限への適合**：入力長の超過を防ぎ、情報の完全性を確保します

#### 片の内容を編集・確認する <a href="#edit-view-chunk-content" id="edit-view-chunk-content"></a>

文書の分割された内容を確認できます。

1. ナレッジベースの文書ページに入り、「<mark style="color:blue;">編集</mark>」をクリックします
2. 分割された内容を確認し、見たい片をクリックします

画面には、この片の完全な内容が Markdown 形式で表示されます。

<div><figure><img src="/files/CdSvGCf7mMsLgmPw7xzW" alt=""><figcaption></figcaption></figure> <figure><img src="/files/LTF2zSMCEhKlvOeySvWk" alt=""><figcaption></figcaption></figure></div>

#### 元の文書を編集する <a href="#edit-source-document" id="edit-source-document"></a>

1. 編集ページで「<mark style="color:blue;">文書を表示</mark>」をクリックします

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

2. 編集ページに入ると、テキストボックスにその文書の Markdown 形式が表示されます

テキストボックス内で元の文書を編集できます。すべてのファイル形式をこの方法で編集できます。編集が完了したら「<mark style="color:blue;">保存</mark>」を押すと、編集結果を保存できます。

<div><figure><img src="/files/skSXQRNdZMJ5zKsB8gi3" alt=""><figcaption></figcaption></figure> <figure><img src="/files/skSXQRNdZMJ5zKsB8gi3" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
**データ管理に関する注意**

* 編集の前に、重要な内容をバックアップしておくことをおすすめします
* 元の文書を編集すると、システムが片の分割を再度実行します
  {% endhint %}


---

# 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.maiagent.ai/maiagent-user-guide/maiagent-user-guide-ja/km/km.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.