> 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/build/agent/label-filter.md).

# ナレッジベースのラベルフィルタリング

AI アシスタントにラベルフィルター条件を一度設定することで、すべての会話プラットフォームで条件に一致するファイルのみを参照させます

ナレッジベースのラベルフィルターでは、AI アシスタントごとにデフォルトのラベル条件を設定できます。設定後、このアシスタントは質問に回答する際、条件に一致するファイルと FAQ のみを参照し、それ以外のコンテンツは参照しません。ユーザーが Web Chat、LINE、API、または管理画面の会話から質問した場合も、同じルールが適用されます。

{% hint style="info" %}
ラベルフィルターを設定していない場合、アシスタントはマウントされているすべてのナレッジベース内の全ファイルを参照します。従来の動作とまったく同じです。
{% endhint %}

以前は、アシスタントが特定のラベルを持つファイルだけを検索するよう制限するには、API を呼び出すたびにクエリメタデータを渡すか、連絡先ごとに設定する必要がありました。現在は、アシスタント設定ページで一度設定するだけで済みます。

## 利用シーン <a href="#use-case" id="use-case"></a>

あるチェーン店のナレッジベースには、一般公開用の返品・交換規定や会員ポイント制度と、従業員専用の開店・レジ操作 SOP が保存されています。ナレッジベース管理者は、一般公開用ドキュメントに「カスタマーサービス公開可」ラベルを、社内ドキュメントに「社内業務」ラベルを付けます。続いてカスタマーサービスアシスタントの設定ページで「ラベルフィルター」を有効にし、「カスタマーサービス公開可」を選択して保存します。これ以降、顧客が公式サイトの Web Chat または LINE から質問しても、アシスタントは一般公開用ドキュメントのみを引用します。顧客が開店手順について質問しても、アシスタントは社内 SOP を検索できないため、社内情報を回答することはありません。この一連の設定に、エンジニアによる連携プログラムの変更は必要ありません。

## 事前準備 <a href="#prerequisites" id="prerequisites"></a>

* アシスタントに少なくとも 1 つのナレッジベースがマウントされていること（アシスタント設定ページの「<mark style="color:blue;">ナレッジベース設定</mark>」で設定します）。
* ナレッジベースにラベルが作成され、ファイルまたは FAQ にラベルが付けられていること。ラベルの作成方法と適用方法については、[ドキュメント管理：タグおよびメタデータ](/maiagent-user-guide/ja/build/knowledge-base/tags-and-metadata.md)をご覧ください。

選択できるラベルは、このアシスタントにマウントされているナレッジベースのラベルです。アシスタントに複数のナレッジベースがマウントされている場合、同じ条件セットがすべてのナレッジベースに適用されます。

## ラベルフィルターの設定 <a href="#setup" id="setup"></a>

{% stepper %}
{% step %}
左側のメニューで「<mark style="color:blue;">AI アシスタント</mark>」をクリックし、設定するアシスタントを選択して「<mark style="color:blue;">設定</mark>」を開きます。
{% endstep %}

{% step %}
「ナレッジとデータ」グループで「<mark style="color:blue;">ラベルフィルター</mark>」をクリックします。右上には適用範囲、つまりこのアシスタントに現在マウントされているナレッジベースが表示されます。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-aec3fd4687b3caaa423417cf9d2dde10320fda55%2Flabel-filter-initial.png?alt=media" alt="条件がまだ追加されていない AI アシスタント設定ページのラベルフィルター領域"><figcaption><p>条件を設定していない場合、アシスタントはすべてのファイルを参照します</p></figcaption></figure>
{% endstep %}

{% step %}
「条件グループ 1」で下にあるラベルをクリックし、条件に追加します。複数のラベルを追加でき、「<mark style="color:blue;">すべてのラベルを含む</mark>」または「<mark style="color:blue;">いずれかのラベルを含む</mark>」でこのグループの判定方法を指定できます。
{% endstep %}

{% step %}
下へスクロールして「<mark style="color:blue;">影響を受けるファイル</mark>」パネルを確認し、検索対象になるファイルと除外されるファイルを確認します。パネルは、未保存の変更を含む画面上の現在の条件に基づいてリアルタイムに計算されます。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-5675433977f7d3074d970799450b832974aec8ec%2Flabel-filter-configured.png?alt=media" alt="「カスタマーサービス公開可」ラベルを追加すると、影響を受けるファイルパネルに 4 件中 3 件が検索可能と表示されます"><figcaption><p>ラベルを追加すると、平易な説明と影響を受けるファイルパネルがリアルタイムに更新されます</p></figcaption></figure>
{% endstep %}

{% step %}
右下の「<mark style="color:blue;">保存</mark>」をクリックします。保存後、左側の「ラベルフィルター」の横に「設定済み」と表示されます。
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
ラベルフィルターとアシスタントのその他の設定では、同じ「保存」ボタンを使用します。保存せずにページを離れると条件が適用されないため、必ず保存してください。
{% endhint %}

## 条件の読み方 <a href="#how-conditions-work" id="how-conditions-work"></a>

ビルダー画面では条件を平易な言葉で説明し、AND／OR は表示しません。本マニュアルでは、旧画面や API ドキュメントと比較しやすいように、対応する論理演算子を括弧内に記載しています。条件には「グループ内」と「グループ間」の 2 つの階層があります。

| 階層                    | オプション            | 意味                                      |
| --------------------- | ---------------- | --------------------------------------- |
| グループ内（同じ条件グループ内のラベル間） | すべてのラベルを含む（AND）  | ファイルには、このグループに記載されたすべてのラベルが必要です         |
| グループ内                 | いずれかのラベルを含む（OR）  | ファイルには、このグループ内のいずれか 1 つのラベルがあれば条件を満たします |
| グループ間（複数の条件グループ間）     | すべてのグループに一致（AND） | ファイルはすべての条件グループを満たす必要があります              |
| グループ間                 | いずれかのグループに一致（OR） | ファイルはいずれか 1 つの条件グループを満たせば条件を満たします       |

「A または B」のような組み合わせが必要な場合は、「<mark style="color:blue;">条件グループを追加</mark>」をクリックして別のグループを追加します。「複数グループの場合」のグループ間切り替えは、グループが 2 つ以上ある場合にのみ表示されます。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-c9ac268cbac87e553237e80781808e2b70aeac98%2Flabel-filter-groups.png?alt=media" alt="2 つの条件グループを「いずれかのグループに一致」で接続"><figcaption><p>2 つの条件グループ：「カスタマーサービス公開可」ラベルを持つファイル、または「社内業務」ラベルを持つファイル</p></figcaption></figure>

ビルダーの下部には、「アシスタントは『カスタマーサービス公開可』ラベルを持つファイル、または『社内業務』ラベルを持つファイルのみを参照します。」のように、現在の条件が 1 文で表示されます。条件が正しく設定されているか不明な場合は、この文と「影響を受けるファイル」パネルを確認してください。

{% hint style="info" %}
「影響を受けるファイル」パネルで集計されるのは、画面に読み込まれたファイルです。ナレッジベースに多数のファイルがある場合、パネルには「読み込まれた先頭 N 件のみを集計」と表示されますが、実際の検索ではすべてのファイルに条件が適用されます。
{% endhint %}

## 適用範囲と優先順位 <a href="#scope-and-priority" id="scope-and-priority"></a>

アシスタントのラベルフィルターは「デフォルト値」として、このアシスタントを通じて行われるすべての会話に適用されます。対象には、Web Chat、LINE などの会話プラットフォーム、API 連携、管理画面の会話が含まれます。

ある会話ですでに別の階層にクエリメタデータが指定されている場合は、その階層が優先され、アシスタントのデフォルトは使用されません。優先順位は高い順に次のとおりです。

1. 個別メッセージで渡されるクエリメタデータ（API 呼び出しや Web Chat の埋め込みで指定する場合など）
2. 会話レベルのクエリメタデータ
3. 連絡先のクエリメタデータ
4. アシスタントのラベルフィルター（このページの設定）

つまり、既存の連絡先または API の設定には影響しません。最初の 3 階層のいずれにも指定がない場合にのみ、アシスタントのデフォルト条件が適用されます。各階層の設定方法については、[ナレッジ管理権限：クエリメタデータ](/maiagent-user-guide/ja/org/querymetadata.md)および[構築を始める—「クエリビルダー」の使用](/maiagent-user-guide/ja/org/query-builder.md)をご覧ください。

{% hint style="info" %}
ナレッジベースの「検索テスト」は検索品質を確認するためのツールであり、アシスタントのラベルフィルターは適用されません。
{% endhint %}

## ラベルが無効になった場合 <a href="#invalid-labels" id="invalid-labels"></a>

条件で参照しているラベルの名称が変更または削除された場合、あるいはそのラベルが属するナレッジベースがアシスタントからアンマウントされた場合、設定ページを再度開くと、影響を受けるラベルを一覧にした無効ラベルの警告が表示されます。「<mark style="color:blue;">無効なラベルを削除</mark>」をクリックして一括削除するか、別のラベルを選択して保存してください。

{% hint style="warning" %}
無効なラベルは検索時にどのファイルにも一致せず、検索範囲がすべてのファイルに拡大されることもありません。アシスタントが突然ナレッジベースの内容を回答できなくなった場合は、まずラベルフィルターに無効なラベルがないか確認してください。
{% endhint %}

## 設定のクリア <a href="#clear" id="clear"></a>

ビルダー右上の「<mark style="color:blue;">すべての条件をクリア</mark>」をクリックして保存すると、アシスタントは再びすべてのファイルを参照する状態に戻ります。

アシスタントにマウントされているナレッジベースにラベルが 1 つもない場合、このページには「マウントされているナレッジベースにはラベルがありません」と表示されます。先にナレッジベースでファイルにラベルを付けてください。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-643602b6c5278d200b0704ca967d0ed7f678661f%2Flabel-filter-empty.png?alt=media" alt="マウントされているナレッジベースにラベルがない場合のメッセージ"><figcaption><p>ナレッジベースにラベルがない場合のメッセージ</p></figcaption></figure>


---

# 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/build/agent/label-filter.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.