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

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

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

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

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

利用シーン

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

事前準備

• アシスタントに少なくとも 1 つのナレッジベースがマウントされていること（アシスタント設定ページの「ナレッジベース設定」で設定します）。

• ナレッジベースにラベルが作成され、ファイルまたは FAQ にラベルが付けられていること。ラベルの作成方法と適用方法については、ドキュメント管理：タグおよびメタデータをご覧ください。

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

ラベルフィルターの設定

1

左側のメニューで「AI アシスタント」をクリックし、設定するアシスタントを選択して「設定」を開きます。

2

「ナレッジとデータ」グループで「ラベルフィルター」をクリックします。右上には適用範囲、つまりこのアシスタントに現在マウントされているナレッジベースが表示されます。

条件を設定していない場合、アシスタントはすべてのファイルを参照します

3

「条件グループ 1」で下にあるラベルをクリックし、条件に追加します。複数のラベルを追加でき、「すべてのラベルを含む」または「いずれかのラベルを含む」でこのグループの判定方法を指定できます。

4

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

ラベルを追加すると、平易な説明と影響を受けるファイルパネルがリアルタイムに更新されます

5

右下の「保存」をクリックします。保存後、左側の「ラベルフィルター」の横に「設定済み」と表示されます。

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

条件の読み方

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

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

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

2 つの条件グループ：「カスタマーサービス公開可」ラベルを持つファイル、または「社内業務」ラベルを持つファイル

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

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

適用範囲と優先順位

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

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

1. 個別メッセージで渡されるクエリメタデータ（API 呼び出しや Web Chat の埋め込みで指定する場合など）

2. 会話レベルのクエリメタデータ

3. 連絡先のクエリメタデータ

4. アシスタントのラベルフィルター（このページの設定）

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

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

ラベルが無効になった場合

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

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

設定のクリア

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

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

ナレッジベースにラベルがない場合のメッセージ