> 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/tags-and-metadata.md).

# ファイル管理：タグとメタデータ

ナレッジベースには大量のファイルや FAQ を管理する必要がある場合があるため、MaiAgent ではタグ管理・メタデータ管理機能を提供しており、大量のファイルや FAQ を分類・整理できます。

## タグ管理 <a href="#tag-management" id="tag-management"></a>

ナレッジベースに大量のデータが含まれている場合、タグシステムを使うことでファイルや FAQ の属性をすばやく整理したり、参照資料の権限を制御したりできます。例えば次のとおりです。

```
製品資料ナレッジベース (製品情報で分類)
|-- #テント 
|-- #4人用テント 
|-- #3シーズンテント 
|-- #SnowPeak
```

```
教育コンテンツナレッジベース (権限レベルで分類)
|-- #非会員
|-- #一般会員 
|-- #VIP
```

### タグの追加 <a href="#add-tag" id="add-tag"></a>

1. 追加ボタンをクリックします

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

2. タグ名を入力します

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

3. 追加を押すと、入力したタグが以下のように ID や名称などとともに表示されます

{% hint style="info" %}
ID はドキュメント権限を開放する際に使用できます。詳しくは[技術者マニュアル—Query Metadata 制御項目](https://docs.maiagent.ai/tech/authorization-integration/zhi-shi-guan-li-quan-xian-query-metadata-cha-xun-yuan-zi-liao-zong-lan/json-interfaces#querymetadata-kong-zhi-xiang-mu-shuo-ming)をご覧ください
{% endhint %}

<figure><img src="/files/7zg1meCnmKt2wAij9Fmu" alt=""><figcaption></figcaption></figure>

### ドキュメントへのタグ付け <a href="#tag-document" id="tag-document"></a>

タグの追加が完了したら、続いてドキュメントページに進みます

1. ファイル情報の編集をクリックします

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

2. タグを選択します

ドキュメントの要件に応じて、対応するタグを付与します (複数のタグを選択できます)

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

このようにすると、追加したタグが対応するドキュメントの後に表示されます。

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

### FAQ へのタグ追加 <a href="#tag-faq" id="tag-faq"></a>

FAQ に階層分類やタグ管理を追加したい場合は、次の手順で行えます。

1. ナレッジベース内の FAQ 管理画面に入り、編集したい FAQ を選択して、編集ボタンをクリックします

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

2. 追加したいタグを選択し、追加後に「<mark style="color:blue;">確定</mark>」を押します

<div><figure><img src="/files/7dpDDLZnYLek7VPDvjzv" alt=""><figcaption></figcaption></figure> <figure><img src="/files/hqbBhI4a6fu6W2AIkQLG" alt=""><figcaption></figcaption></figure></div>

追加したタグは FAQ 欄に表示されます

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

***

### タグによる権限アクセス制御 <a href="#tag-access-control" id="tag-access-control"></a>

タグの違いに応じて、ユーザーごとに表示する内容を制御できます。例えば、VIP 顧客にはより上級の製品操作デモを表示し、非会員には汎用的な操作デモのみを表示するといった使い方が可能です。

{% hint style="info" %}
FAQ・ドキュメントのいずれにもフィルターを適用できます
{% endhint %}

#### AND フィルター <a href="#and-filter" id="and-filter"></a>

AND フィルターは、すべてのタグ条件を同時に満たすコンテンツを開放するタグです。

例えば、この会話が非会員向けの操作に関する会話である場合は、タグフィルターを使用し、「<mark style="color:blue;">非会員</mark>」と「<mark style="color:blue;">操作</mark>」の両方のタグを同時に満たすドキュメントだけを AI アシスタントに使用させることができます。

図のように、フィルター後は AI アシスタントが初級キャンプのドキュメントのみを使用できるようになり、非会員との会話に無関係な情報を漏らすことを防ぎます。

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

#### OR フィルター <a href="#or-filter" id="or-filter"></a>

会員との会話の場合は、OR フィルターを使用することで、一般会員または非会員のいずれかに該当するドキュメントを AI アシスタントに参照させることができます。

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

会員は非会員よりも多くのドキュメント内容を閲覧できるようになり、権限の段階分けを実現できます。

{% hint style="info" %}
タグフィルター内の「AND」「OR」をクリックすることで、フィルター方式を切り替えられます
{% endhint %}

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

> フィルター結果については次をご参照ください：[内部 Q\&A 機能](/maiagent-user-guide/maiagent-user-guide-ja/conversations/explain.md)

## ドキュメントメタデータ管理 <a href="#document-metadata-management" id="document-metadata-management"></a>

### **メタデータとは？** <a href="#what-is-metadata" id="what-is-metadata"></a>

メタデータはドキュメントの「身分証明書」のようなもので、ドキュメントの詳細情報を記録し、システムがこれらのドキュメントをより適切に管理・活用できるよう支援します。

**例：初級キャンプ.pdf**

```
メタデータ設定：
├── ドキュメントバージョン：v2.1
├── 作成日：2024-03-15
├── 前回更新：2024-11-20
├── 次回チェック：2025-05-20
├── 更新部門：マーケティング部
└── バージョン状態：審査済み・公開可能
```

### なぜメタデータを使うのか？ <a href="#why-use-metadata" id="why-use-metadata"></a>

データが膨大で複雑な状況において、メタデータを使うことでデータ品質をより手軽かつ迅速に維持でき、次のことを支援します。

**管理効率の向上**

* ドキュメントの状態やバージョン情報をすばやく識別できる
* 大量のドキュメントを一括管理する際により整然と扱える
* 手作業での検索や確認にかかる時間を削減できる

**コンテンツ品質の確保**

* 最新のドキュメントバージョンを使用できる
* ドキュメントの更新履歴やバージョン状態を追跡できる
* AI アシスタントが最新かつ審査済みのコンテンツを使用することを保証できる
* 定期チェックのリマインダーを設定し、データ品質を維持できる

### ドキュメントへのメタデータ追加 <a href="#add-metadata-to-document" id="add-metadata-to-document"></a>

1. ドキュメントページに入り、ドキュメント情報の編集をクリックします：

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

2. メタデータタブに切り替え、メタデータの対応関係を入力します

> MaiAgent は key-value 形式でメタデータを保存・参照します

<div><figure><img src="/files/8wb5bGkMblLfWfyeZKuO" alt=""><figcaption></figcaption></figure> <figure><img src="/files/CkFRyHaqjOMTTZ2p1yw8" alt=""><figcaption></figcaption></figure></div>

入力後に「<mark style="color:blue;">メタデータを追加</mark>」ボタンをクリックすると、入力したキーと値の対応関係が追加されます (一度に複数のメタデータを追加できます)。

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

追加が完了すると、追加したメタデータが欄に表示されます。

### FAQ へのメタデータ追加 <a href="#add-metadata-to-faq" id="add-metadata-to-faq"></a>

1. ナレッジベース内の FAQ 管理画面に入り、編集したい FAQ を選択して、編集ボタンをクリックします

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

2. メタデータページに切り替え、入力後にメタデータを追加をクリックします

すべて入力が完了したら「確定」を押します

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

追加したメタデータは FAQ リストに表示されます

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

### カスタムリンクマッピング <a href="#custom-url-mapping" id="custom-url-mapping"></a>

url はメタデータシステムにおける予約語です。`url: https://...指定する URL` のように設定すると、会話中で引用された箇所を表示する際に、設定した url のアドレスが元のファイルの場所を上書きし、指定した URL を開くようになります。

**例のシナリオ：ブランドの春季プロモーション活動**

**元の設定：**

```yaml
title: "2025春季大型プロモーション活動の詳細"
content: "今回の活動には全館20%オフ、購入金額に応じたプレゼントなど多数の特典が含まれます..."
url: https://www.yourstore.com/spring-sale-2025
```

**利用効果：** ユーザーが会話中で「春季プロモーション活動にはどんな特典がありますか？」と質問したとき：

* AI はこのナレッジ片を引用して質問に回答します
* ユーザーが引用元をクリックしても、内部ファイルの場所は開かれません
* 代わりに、直接 `https://www.yourstore.com/spring-sale-2025` の公式サイトの活動ページにジャンプします
* ユーザーは最新の活動詳細、購入ボタン、カウントダウンなどの動的なコンテンツをすぐに確認できます

**実用シーン：**

* **ウェブサイトの公知**：`url: https://www.company.com/announcements/system-maintenance`
* **製品スペックページ**：`url: https://www.product.com/specs/model-x1`
* **カスタマーサポートポリシー**：`url: https://support.company.com/return-policy`
* **イベント申込**：`url: https://events.company.com/register/webinar-2025`

このように設定する利点は、AI の回答をより実用的にできる点にあります。情報を提供するだけでなく、ユーザーを関連ページへ直接誘導して行動を促すことができ、ユーザー体験とコンバージョン率の向上につながります。

***

#### url 設定前 <a href="#before-url-setting" id="before-url-setting"></a>

以下のとおり、url の値を設定する前に引用ノードをクリックし、いずれかのノード (例：初級キャンプ.pdf) をクリックすると、元のドキュメントを確認できます (会話プラットフォーム側で、ユーザーに元のファイルのダウンロードを許可するかどうかを設定できます)：

{% hint style="info" %}
[会話プラットフォーム - 引用ドキュメントのダウンロード許可設定](https://docs.maiagent.ai/maiagent-user-guide/maiagent-user-guide-ja/km/pages/TuPfPNiHa9fh9VuzU5Zu#id-3.-gong-neng-she-ding)
{% endhint %}

<div><figure><img src="/files/t1mraFfJP0fNlWjV1rl5" alt=""><figcaption><p>引用ノードを確認</p></figcaption></figure> <figure><img src="/files/4cgNbp5tt5i3a2hfclVM" alt=""><figcaption><p>元のファイルの場所を確認</p></figcaption></figure></div>

#### url 設定後 (Google を例に) <a href="#after-url-setting" id="after-url-setting"></a>

<figure><img src="/files/7xbxvP20nac90QFivf6U" alt=""><figcaption></figcaption></figure>

引用したノードファイル (キャンプ注意事項.txt) を再度クリックすると、ドキュメントのプレビューは表示されず、上書きされて Google のトップページが開きます：

<div><figure><img src="/files/ax2oZc9GVagvHaKDKK7F" alt=""><figcaption></figcaption></figure> <figure><img src="/files/4ntgGo4WR4Hq07neIreq" alt=""><figcaption></figcaption></figure></div>

メタデータで `url` 欄を設定すると、ユーザーは会話中で AI アシスタントが該当ドキュメントを引用した際に、直接設定したリンクへジャンプして、より充実した情報を得られます


---

# 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/tags-and-metadata.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.