> 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).

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

Agent の設定でラベルのフィルター条件を一度設定すると、すべての会話プラットフォームで条件に一致するファイルのみを参照するようになります

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

{% hint style="info" %}
ラベルフィルターを設定していない場合、Agent は接続されているすべてのナレッジベースの全ファイルを参照します。従来の動作と変わりません。
{% endhint %}

以前は、特定のラベルが付いたファイルだけを Agent に検索させるには、API 呼び出しごとにクエリメタデータを渡すか、連絡先を個別に設定する必要がありました。現在は、Agent の設定ページで一度設定するだけで済みます。

## 利用例 <a href="#use-case" id="use-case"></a>

あるチェーン店のナレッジベースには、顧客向けの返品・交換規定や会員ポイント制度に加え、店員だけが閲覧する開店・レジ業務の SOP が保存されています。ナレッジベース管理者は、顧客向けのドキュメントに「顧客対応で公開可能」、内部ドキュメントに「内部業務」というラベルを付けます。次に、カスタマーサービスアシスタントの設定ページで「ラベルフィルター」を有効にし、「顧客対応で公開可能」を選択して保存します。以降、顧客が公式サイトの Web Chat でも LINE でも質問した際、Agent は顧客向けのドキュメントのみを引用します。顧客が開店手順を尋ねても、Agent は内部 SOP を検索できないため、内部情報を開示しません。この設定のためにエンジニアが連携プログラムを変更する必要はありません。

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

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

選択できるラベルは、この Agent に接続されているナレッジベースのラベルです。Agent に複数のナレッジベースが接続されている場合、同じ条件がすべてのナレッジベースに適用されます。

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

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

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

<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="条件がまだ追加されていない、Agent 設定ページのラベルフィルターセクション"><figcaption><p>条件を設定していない場合、Agent はすべてのファイルを参照します</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="「顧客対応で公開可能」ラベルを追加すると、影響を受けるファイルのパネルに検索可能なファイルが 3 / 4 件と表示されます"><figcaption><p>ラベルを追加すると、わかりやすい説明文と影響を受けるファイルのパネルがリアルタイムで更新されます</p></figcaption></figure>
{% endstep %}

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

{% hint style="warning" %}
ラベルフィルターは、Agent のほかの設定と同じ「保存」ボタンを使用します。ページを離れる前に必ず保存してください。保存しないと条件は有効になりません。
{% 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>

ビルダーの下部には、「アシスタントが参照するのは、『顧客対応で公開可能』が付いたファイル、または『内部業務』が付いたファイルのみです。」など、現在の条件を説明する文が表示されます。条件が正しいか判断できない場合は、この文と「影響を受けるファイル」パネルを確認してください。

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

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

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

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

1. 個々のメッセージに渡されたクエリメタデータ（API 呼び出しや Web Chat の埋め込み時に指定したものなど）
2. 会話レベルのクエリメタデータ
3. 連絡先のクエリメタデータ
4. Agent のラベルフィルター（このページで設定するもの）

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

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

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

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

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

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

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

Agent に接続されているナレッジベースにまだラベルがない場合、このページには「接続されているナレッジベースにはまだラベルがありません」と表示されます。先にナレッジベースでファイルにラベルを付けてください。

<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.