ナレッジ管理権限（Query Metadata／クエリメタデータ）の概要

Query Metadata（クエリメタデータ）を使用して、AI アシスタントが検索できるナレッジの範囲を制御します。詳細な設定方法については、「構築を開始」サブページを参照してください。

Query Metadata とは

対話型 AI を導入する際、ユーザーごとに参照できるナレッジの範囲を変える必要があることがよくあります。たとえば、訪問者は公開情報のみ、VIP 会員は追加のプランドキュメント、社内従業員は従業員ハンドブックを検索できるようにします。

Query Metadata は、ナレッジ検索の範囲を制限する条件のセットです。特定の ID、会話、またはメッセージについて、検索時に参照できる「ナレッジベース、ドキュメント、FAQ、ラベル条件に一致するコンテンツ」を指定します。ID の仕組みに代わるものではなく、ID が条件に応じて機能するようにします。

連絡先、会話、メッセージはコンテナであり、Query Metadata はコンテナに紐づけられ、実際の表示範囲を決定する条件です。

関連情報：連絡先（Contact）の概要と連携、ロール（Role）と連絡先（Contact）の違い

設定可能なレベル

Query Metadata は3つのレベルで設定でき、それぞれ異なる連携方法に対応します。

レベル	適用範囲	設定方法
メッセージ（Message）	そのメッセージのみ	会話 API の message.queryMetadata、社内 Q&A インターフェース右側のナレッジ選択、Web Chat 組み込みの queryMetadata（メッセージレベルで送信）
会話（Conversation）	その会話内のすべてのメッセージ	API で会話を作成する際に指定
連絡先（Contact）	そのユーザーのすべての会話	管理画面で連絡先を編集（クエリビルダーまたは JSON）、連絡先 API

解決順序

検索時には、上から順に最初に「設定されている」レベルが使用されます。

Message > Conversation > Contact > すべて未設定（制限なし。AI アシスタントに紐づくすべてのナレッジベースを検索可能）

• あるレベルが未設定（null）の場合は、次のレベルを確認します。

• 最初に設定されているレベルが全体として適用され、下位レベルとはマージされません。上位レベルの設定が下位レベルを完全に上書きします。

• 空のオブジェクト（{}）も設定済みと見なされます。これは制限なしを意味し、下位レベルの確認を終了します。「空のセットと未設定」の厳密な意味については、JSON 形式ガイドを参照してください。

社内メンバーの場合はどうなりますか？ メンバーがプラットフォーム内で参照できるリソースは、別の仕組みであるロール権限によって制御されます。メンバーが社内 Q&A を利用する場合は、メッセージごとにナレッジ範囲を選択します。これは上表のメッセージレベルに該当します。詳しくは、グラフィカルインターフェースガイドを参照してください。

条件による範囲の絞り込み

Query Metadata は2つの要素で構成され、検索可能な範囲を段階的に絞り込みます。

1. knowledge_bases：どのナレッジベースを利用可能にするか、および各ナレッジベース内のどのドキュメント／FAQを利用可能にするかを定義します（すべて選択、一部を除いてすべて選択、指定項目のみ選択）。

2. label_relations：利用可能なドキュメントをラベル条件（AND／OR、ネスト可能）でさらにフィルタリングします。

ドキュメントのフィルタリング条件レベルを示す図

Query Metadata が制限するのはナレッジベース検索のみです。LLM prompt には含まれないため、AI は条件自体を読み取れません。商品 ID などの値を AI に認識させるには、contextDataを使用してください。

2つの構築方法

方法	適した用途	ガイド
クエリビルダー（グラフィカル）	管理画面で連絡先の権限を手動設定する場合、社内 Q&A でメッセージごとにナレッジを選択する場合	構築を開始—「クエリビルダー」を使用する
JSON 形式	API 連携、Web Chat の組み込み、複雑なネスト条件	構築を開始—JSON 形式を使用する

実際のユースケース

ID	渡す条件（query_metadata）	レスポンス結果
訪問者	ナレッジベース：一般 ドキュメント：なし ラベル：訪問者 FAQ：1、2	一般ナレッジベースから、訪問者ラベルが付いたドキュメント、FAQ 1、FAQ 2を取得します
一般会員	ナレッジベース：一般 ドキュメント：A、B、C ラベル：なし FAQ：なし	一般ナレッジベースから、ドキュメントA、B、Cとすべての FAQ を取得します
カスタマーサポート担当者	ナレッジベース：従業員 ドキュメント：なし ラベル：カスタマーサポート FAQ：なし	従業員ナレッジベースから、カスタマーサポートラベルが付いたドキュメントとすべての FAQ を取得します
社内従業員	ナレッジベース：従業員 ドキュメント：A、B ラベル：なし FAQ：なし	従業員ナレッジベースから、ドキュメントA、Bとすべての FAQ を取得します
管理者	ナレッジベース：従業員、一般 ドキュメント：なし ラベル：なし FAQ：なし	従業員および一般ナレッジベースのすべてのドキュメントと FAQ を取得します

同じ AI アシスタントが複数の ID に対応する場合、条件を切り替えるだけでよく、アシスタントを複製する必要はありません。これが Query Metadata の中心的な価値です。つまり、多次元の ID による横断的なアクセス制御（ランク × 部門 × 製品ライン）、クエリごとの制御（バックエンドが現在の ID に基づいて条件をリアルタイムに組み立てる）、大規模ナレッジベースの柔軟な認可（シナリオに応じてラベルとナレッジベースを分割する）を実現します。