> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/tech/maiagent-tech-ja/authorization-integration/zhi-shi-guan-li-quan-xian-query-metadata-cha-xun-yuan-zi-liao-zong-lan/graphical-interface.md).

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

## 連絡先（Contact）の Query Metadata 設定

MaiAgent サービスの「クエリビルダー」を使うと、グラフィカルな方法で QueryMetadata を作成できます。ここでは連絡先の Query Metadata を作成する例で説明します。

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

<figure><img src="/files/pAM0h9TGPm84qpL6UDZX" alt=""><figcaption><p>連絡先エリアの入口</p></figcaption></figure>

### ステップ 2：設定したい連絡先に対して設定を行う

1. 設定が必要な連絡先を見つけ、編集をクリックします

<figure><img src="/files/Z9Hoe63ypweeCemKWgZf" alt=""><figcaption><p>連絡先の編集入口</p></figcaption></figure>

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

<figure><img src="/files/ApnzAZ2dBvEm8fUpxdFU" alt=""><figcaption><p>クエリビルダーの入口</p></figcaption></figure>

クエリビルダーをそのままクリックして、グラフィカルなインターフェースに入ります

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

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

<figure><img src="/files/0pfKqxmYzSGT06PUFm00" alt=""><figcaption><p>ナレッジベースとファイルの選択</p></figcaption></figure>

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

<figure><img src="/files/G824GGUIJHUqzx9ypHRe" alt=""><figcaption><p>タグフィルターの設定</p></figcaption></figure>

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

## 対話設定（Message）

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

<figure><img src="/files/XbU5j162DgBQ6lbIrcFB" alt=""><figcaption><p>内部対話：利用可能なナレッジ権限を選択</p></figcaption></figure>

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

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

<figure><img src="/files/QC1wvCbEPd0c902ozacF" alt=""><figcaption><p>利用可能なファイル一覧</p></figcaption></figure>

<figure><img src="/files/lKove1PLIn2izHyaavEs" alt=""><figcaption><p>選択済みファイルの状態</p></figcaption></figure>

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

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

<figure><img src="/files/pvtTja977J9JwcuVlaLr" alt=""><figcaption><p>ファイルのチェックを外した例</p></figcaption></figure>

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

<figure><img src="/files/VZjsjtTdeKkdN9kz9l8Q" alt=""><figcaption><p>引用ライブラリの変化：CV を削除した後</p></figcaption></figure>

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.maiagent.ai/tech/maiagent-tech-ja/authorization-integration/zhi-shi-guan-li-quan-xian-query-metadata-cha-xun-yuan-zi-liao-zong-lan/graphical-interface.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.