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

# ナレッジベース

最終更新：2025-11-14

## 概要

ナレッジベースは、オープンブック形式の試験に例えられます。質問に最も関連する情報をナレッジベースから見つけ出し、大規模言語モデルが回答する際の参考コンテキストとして取得します。ナレッジベースには大量のデータを保存できますが、アップロードするデータが、構築する 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/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.