構築を始める—「クエリビルダー」を使う

連絡先クエリのメタデータ設定

MaiAgent のサービスにある「クエリビルダー」を使うと、グラフィカルな操作でクエリのメタデータを作成できます。ここでは連絡先のクエリメタデータを作成する例で説明します：

ステップ 1：MaiAgent 管理画面の連絡先エリアに入る

連絡先エリアの入口

ステップ 2：設定したい連絡先を設定する

1. 設定したい連絡先を見つけ、編集をクリックします

連絡先の編集入口

2. クリックすると、以下の画面が表示されます

クエリビルダーの入口

クエリビルダーをそのままクリックすると、グラフィカルな操作画面に入ります

ステップ 3：開放したい権限にチェックを入れる

1. 開放したいナレッジベースにチェックを入れます。そのナレッジベース内のファイルを一部だけ選んでチェックすることもできます

ナレッジベースとファイルの選択

2. 特定のタグに対してファイルを開放したい場合は、「タグフィルターを表示」をクリックすると、タグ設定エリアが開きます

タグフィルター設定

ここでは作成したい判定条件を選択できます。開放済みのナレッジベース内のファイルを開放する基準として、"OR"（いずれかの条件に一致）または "AND"（すべての条件に一致）を選択できます

対話設定（Message）

下図の右側メニューを使って、開放したいナレッジ権限を選択することもできます：

内部対話：利用可能なナレッジ権限を選択

同様に「タグフィルターを表示」を使って、タグのフィルター条件を設定できます

異なるメッセージを送信するたびに、右側の権限を変更してナレッジ管理を行うことができます

利用可能なファイル一覧

選択済みファイルの状態

現在は CV、SOP、アンケート調査の合計 3 つのファイルを参照できます

次のメッセージで CV のチェックを外したうえで、再度メッセージを送信します：

ファイルのチェックを外す例

すると Agent は CV ファイルを使用できなくなり、引用ライブラリにも CV の引用が表示されなくなります：

引用ライブラリの変化：CV を除外した後

メッセージを送信するたびに権限を調整でき、そのターンの回答が引用できる内容に影響します。

Web Chat 読み込み時の事前設定

MaiAgent では、Web Chat が正式に初期化される前にクエリメタデータを事前設定する機能を提供しています。連絡先より前の段階で対話内容を制限したい場合（例：未登録の連絡先アカウントのお客様に Web Chat サービスを提供する場合）には、埋め込み時にクエリメタデータを指定できます。これにより、システムはメッセージレベルのナレッジベースファイルのフィルタリング機構をデフォルトで起動します。

Web Chat の設定については、こちらを参照してください：技術者マニュアル：構築を始める—JSON 形式を使う

JSON 形式でクエリメタデータを構築することもできます。技術者マニュアル：構築を始める—JSON 形式を使うを参照してください