> 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/tech/maiagent-tech-ja/ai-agents/knowledge-base.md).

# ナレッジベース

最終更新：2025-11-14

## 概要

ナレッジベースは、オープンブック（Open Book）方式の試験のようなものだとイメージできます。ナレッジベースの中から質問に最も関連性の高い情報を探し出し、それを抜き出して大規模言語モデルが回答する際に参照するコンテキストとして利用します。ナレッジベースには大量のデータを格納できますが、アップロードするデータが、構築する AI アシスタントが回答すべき質問と関連しているかどうかには注意が必要です。関連性がない場合、現在の検索技術では、無関係な情報を回答のコンテキストとして取得してしまい、その結果として回答できなくなる可能性があります。

## ナレッジベースに格納する内容の例

ナレッジベースは、さまざまな構造化データや非構造化データの格納に適しています。

* 製品情報
* FAQ（よくある質問）
* 技術ドキュメント
* 操作マニュアル
* ポリシー・規定
* その他の比較的大量のデータ

## ファイル一覧の並び順

### 作成日順での並び替え

MaiAgent のナレッジベースのファイル一覧は、**作成日順** で表示され、最新にアップロードしたファイルが一覧の先頭に表示されます。この設計により、次のことが可能になります。

* **新しいファイルをすばやく見つける**：アップロードしたばかりのファイルが、すぐに最上部に表示されます
* **更新時期を追跡する**：ファイルの並び順から、ナレッジベースの更新履歴を把握できます
* **管理・メンテナンスが容易**：最新に追加されたデータから優先的に対応できます

### 並び替えのロジック

システムは、ファイルの作成日に従って自動的に降順（最新のファイルが先頭）で並べ替えます。この並び順は、API または画面から取得するすべてのファイル一覧に適用され、一貫した利用体験を確保します。

## ナレッジベースのファイル管理のベストプラクティス

### ファイル名の付け方の推奨

ファイルをより識別・管理しやすくするために、意味のある命名方法を採用することをおすすめします。

* **日付を含める**：例 `製品仕様_2025-11.pdf`
* **バージョン表記**：例 `操作マニュアル_v2.3.pdf`
* **テーマによる分類**：例 `FAQ_返品交換ポリシー.md`

### 定期的な確認と更新

ファイルは作成日順に並ぶため、定期的に一覧を確認することをおすすめします。

1. **最新ファイルの確認**：直近にアップロードしたファイルの内容が正しいか確認します
2. **古いデータの更新**：比較的古いファイルを見つけ、更新または削除が必要かどうかを評価します
3. **データ品質の維持**：ナレッジベースの内容の鮮度と正確性を確保します

### 一括アップロードの戦略

一度に複数のファイルをアップロードする必要がある場合は、次のようにします。

* 重要度の順にアップロードし、最も重要なファイルを最後にアップロードします（先頭に表示されます）
* 関連するファイルは近い時間帯にアップロードすることをおすすめします。これにより一覧でまとまって表示されます
* アップロード後はすぐに一覧の並び順を確認し、ファイルの並びが想定どおりであることを確認します

## 技術的な説明

### API レスポンスのフォーマット

ナレッジベースのファイル API は、作成日順に並んだファイル一覧を返します。

```json
{
  "files": [
    {
      "id": "file_123",
      "name": "最新產品目錄.pdf",
      "created_at": "2025-11-14T10:30:00Z",
      "size": 2048576
    },
    {
      "id": "file_122",
      "name": "FAQ更新.md",
      "created_at": "2025-11-13T15:20:00Z",
      "size": 10240
    }
  ]
}
```

### 他の並び替え方法との比較

| 並び替え方法   | メリット           | デメリット                   | MaiAgent での採用 |
| -------- | -------------- | ----------------------- | ------------- |
| 作成日順     | 新しい内容を追跡しやすい   | 古いが重要なファイルが見落とされる可能性がある | ✅ はい          |
| ファイル名順   | 特定のファイルを検索しやすい | 適切な命名規則が必要              | ❌ いいえ         |
| ファイルサイズ順 | 大きなファイルを識別できる  | 内容の重要度とは無関係             | ❌ いいえ         |
| 更新日順     | 最新の更新を反映する     | 初回作成日時の情報が失われる          | ❌ いいえ         |

MaiAgent が作成日順を採用しているのは、最も直感的なタイムライン視点を提供し、ナレッジベースの成長過程をユーザーが明確に把握できるようにするためです。

## 関連機能

* [ナレッジベースの作成方法：基本設定](https://docs.maiagent.ai/km/km-basic-settings)
* [ファイル管理：タグとメタデータ](https://docs.maiagent.ai/km/tags-and-metadata)
* [検索テスト](https://docs.maiagent.ai/km/test-search-result)


---

# 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/tech/maiagent-tech-ja/ai-agents/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.