ナレッジ管理権限(Query Metadata/クエリメタデータ)概要
本ページでは、Query Metadata(クエリメタデータ)を通じて AI アシスタントが参照できるデータやナレッジの範囲を制御する方法を説明します。詳細な設定方法は「構築をはじめる」のサブページをご参照ください
Last updated
Was this helpful?
本ページでは、Query Metadata(クエリメタデータ)を通じて AI アシスタントが参照できるデータやナレッジの範囲を制御する方法を説明します。詳細な設定方法は「構築をはじめる」のサブページをご参照ください
AI 対話システムを導入する際、ユーザーの権限や利用ニーズが異なるため、通常「ナレッジベース / AI アシスタント / 対話プラットフォーム」の利用可能範囲をきめ細かく制御する必要があります。
MaiAgent では、対話 / 身分のレベルごとに付加された Query Metadata を活用して、「この人 / この対話がどのコンテンツを参照できるか」を決定できます。
Query Metadata は、クエリ範囲を限定する一連の動的な条件であり、あるユーザーが特定の対話プラットフォーム上でクエリできる「ナレッジベース、FAQ、タグ条件に合致する文書」などのデータ内容を指定できます。
これは役割(Role)や連絡先(Contact)を置き換えるものではなく、これらの身分を「条件付きで機能させる」ものであり、対話レベルでの最小権限制御を実現します。
役割 / 連絡先 / 対話はコンテナであり、Query Metadata は可視範囲を実際に制御する条件制限の設定です
以下の記事の説明から、さらに詳しく学べます:
サービスを構築する前に、Agent はさまざまなレベルの Query Metadata を通じて、その時点で参照可能なすべてのナレッジベースを確認します。権限レベルの参照順序は以下のとおりです:
AI 助理 > 對話平台 > 使用者 ( Message / Contact / Role ) > query_metadata > 查詢權限各レベルにおいて、グラフィカルインターフェースまたは JSON 形式で権限を指定できます。
以下の文書を参照して操作してください:
Contact / Role は身分のコンテナです
Message に対応するのは、社内対話を行う際に、フィルタリングを通じて対話で使用されるナレッジベースを制御できるものです
query_metadata は対話時に実際に実行される「フィルタリング条件の集合」です

公開されるフィルタリングロジックは以下のとおりです:
このように段階的に受け渡されることで、Query Metadata は AI 応答ロジックにおける実際の意思決定の根拠となります。
訪問者
ナレッジベース:一般
ファイル文書:なし
タグ:訪問者
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 を取得
🎯 多次元の身分クロス制御(役割+地域+製品ライン)
🎯 リアルタイムなクエリ制御:アシスタントを複製する必要はなく、条件を変更するだけでシーンの切り替えに対応できます
🎯 大規模ナレッジベースの柔軟な管理:タグとナレッジベースはシーンに応じて分割・権限付与が可能です
query_metadata を製品アーキテクチャの中核に組み込むことを推奨します。これにより、企業は最小限の設定で最大限の権限の柔軟性を実現でき、 ナレッジの安全性を確保しつつ、対話体験と運用効率を同時に向上させます。
Last updated
Was this helpful?
Was this helpful?
