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

Query Metadata（クエリメタデータ）を通じて AI アシスタントが検索可能なナレッジ範囲を制御します。詳細な設定方法は「構築を始める」サブページをご覧ください

Query Metadata とは？

AI チャットを導入する際、異なるユーザーには異なる範囲のナレッジが表示されるべきです。訪問者は公開情報のみ閲覧可能、VIP 会員にはプラン資料が追加で表示され、社内従業員のみが従業員ハンドブックを参照できます。

Query Metadata はナレッジ検索範囲を絞り込むための条件です。特定の身分／特定の会話／特定のメッセージが検索時に、どの「ナレッジベース、ドキュメント、FAQ、ラベル条件に合致するコンテンツ」のみを参照できるかを指定します。これは認証メカニズムを置き換えるものではなく、身分が条件付きで機能するようにするものです。

コンタクト／会話／メッセージはコンテナであり、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）→ 次のレベルを参照

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

• 「空オブジェクト {}」も設定済みとみなされ（制限なしを意味）、下位への参照を終了します——「空集合 vs 未設定」の正確な意味については JSON 形式ガイドをご覧ください

社内メンバーの場合は？ メンバーがプラットフォーム内で閲覧できるリソースはロール権限で制御されます（別のメカニズム）。メンバーが社内 Q&A を使用する際はメッセージごとにナレッジ範囲を選択します。これは上表のメッセージレベルに該当します（グラフィカルインターフェースガイドを参照）。

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

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

1. knowledge_bases：どのナレッジベースを公開するか、および各ナレッジベース内でどのドキュメント／FAQを公開するか（全選択、一部を除外して全選択、一部のみ選択）

2. label_relations：公開済みのドキュメントの中から、さらにラベル条件（AND／OR、ネスト可能）でフィルタリング

ドキュメントフィルタリング条件の階層図

Query Metadata はナレッジベース検索のみを制約します：LLM プロンプトには入らず、AI は条件自体を読み取れません。AI に特定の値（商品 ID など）を「知らせたい」場合は contextData を使用してください。

2 つの構築方法

方法	適している場合	ガイド
クエリビルダー（グラフィカル）	管理画面でコンタクト権限を手動設定、社内 Q&A でのメッセージごとの選択	構築を始める — クエリビルダーの使用
JSON 形式	API 連携、Web Chat 埋め込み、複雑なネスト条件	構築を始める — JSON 形式の使用

実際の活用シナリオ

身分	渡される条件（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 アシスタントで複数の身分にサービスを提供する場合、条件を変更するだけでアシスタントを複製する必要はありません。これが Query Metadata の核心的な価値です：多次元の身分クロス制御（ランク × 部門 × 製品ライン）、クエリごとの制御（バックエンドが現在の身元に基づいてリアルタイムで条件を組み立てる）、大規模ナレッジベースの柔軟な権限管理（ラベルとナレッジベースをシナリオに応じて分割）。