For the complete documentation index, see llms.txt. This page is also available as Markdown.

ナレッジ管理権限(Query Metadata/クエリメタデータ)概要

本ページでは、Query Metadata(クエリメタデータ)を通じて AI アシスタントが参照できるデータやナレッジの範囲を制御する方法を説明します。詳細な設定方法は「構築をはじめる」のサブページをご参照ください

機能説明

AI 対話システムを導入する際、ユーザーの権限や利用ニーズが異なるため、通常「ナレッジベース / AI アシスタント / 対話プラットフォーム」の利用可能範囲をきめ細かく制御する必要があります。

MaiAgent では、対話 / 身分のレベルごとに付加された Query Metadata を活用して、「この人 / この対話がどのコンテンツを参照できるか」を決定できます。

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 応答ロジックにおける実際の意思決定の根拠となります。

実際の活用シナリオ

身分
渡される条件(query_metadata)
応答結果

訪問者

ナレッジベース:一般 ファイル文書:なし タグ:訪問者 FAQ:12

一般 ナレッジベース内の 訪問者 タグを含む文書および FAQ 1、FAQ 2 を取得

一般メンバー

ナレッジベース:一般 ファイル文書:ABC タグ:なし FAQ:なし

一般 ナレッジベース内の ABC 文書とすべての FAQ を取得

カスタマーサポート担当者

ナレッジベース:従業員 ファイル文書:なし タグ:カスタマーサポート FAQ:なし

従業員 ナレッジベース内で カスタマーサポート タグが付与された文書とすべての FAQ を取得

社内従業員

ナレッジベース:従業員 ファイル文書:AB タグ:なし FAQ:なし

従業員 ナレッジベース内の AB 文書とすべての FAQ を取得

管理者

ナレッジベース:従業員一般 ファイル文書:なし タグ:なし FAQ:なし

従業員一般 ナレッジベース内のすべての文書内容および FAQ を取得


まとめ:企業が query_metadata を利用する価値

🎯 多次元の身分クロス制御(役割+地域+製品ライン)

🎯 リアルタイムなクエリ制御:アシスタントを複製する必要はなく、条件を変更するだけでシーンの切り替えに対応できます

🎯 大規模ナレッジベースの柔軟な管理:タグとナレッジベースはシーンに応じて分割・権限付与が可能です

query_metadata を製品アーキテクチャの中核に組み込むことを推奨します。これにより、企業は最小限の設定で最大限の権限の柔軟性を実現でき、 ナレッジの安全性を確保しつつ、対話体験と運用効率を同時に向上させます。

Last updated

Was this helpful?