> 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/maiagent-user-guide/ja/build/knowledge-base/tags-and-metadata.md).
# 文書管理：タグとメタデータ
ナレッジベースのドキュメント管理：タグによるドキュメントと FAQ の分類、メタデータによる検索範囲と参照資料へのアクセス権限の制御、およびタグフィルター・クエリメタデータとの関係を説明します。
ナレッジベースには管理が必要なドキュメントや FAQ が多数含まれることがあります。MaiAgent のタグ管理とメタデータ管理を使うと、大量のドキュメントや FAQ を分類・整理できます。
## タグ管理 確定 」をクリックします
追加したタグが FAQ の欄に表示されます
非会員 」と「学習 」の両方のタグに一致するドキュメントだけを Agent が利用できるようにします。
図のように、フィルター適用後は Agent が初級キャンプのドキュメントだけを利用できるため、非会員との会話で関係のない情報が開示されるのを防げます。
すべてのタグを含む（AND） 」または「いずれかのタグを含む（OR） 」をクリックすると、そのグループの判定方法を切り替えられます（下図は旧画面の AND／OR ボタンですが、位置は同じです）。ビルダーの下部には現在の条件を説明する文章が表示されるため、設定が正しいか確認できます。
{% endhint %}
メタデータ管理 で `next_review` などの日付フィールドを作成し、ドキュメントに値を入力します（新しくアップロードするドキュメントにはデフォルト値を自動適用できます）。
2. レビュー時に[メタデータの一括管理](/maiagent-user-guide/ja/build/knowledge-base/km.md#batch-manage-labels-metadata)でナレッジベース全体のメタデータを Excel ファイルとしてダウンロードし、そのフィールドで並べ替えや絞り込みを行って、レビュー期限を過ぎたドキュメントを探します。
3. 期限を過ぎたドキュメントを更新または削除し、新しいレビュー日を入力して再度アップロードします。
別の方法として、「バージョンの状態」をタグ（例えば `レビュー済み`、`レビュー待ち`）で表し、[ナレッジベースのタグフィルター](/maiagent-user-guide/ja/build/agent/label-filter.md)で Agent がレビュー済みのドキュメントだけを参照するようにできます。レビュー中のドキュメントを `レビュー待ち` タグに変更すると、検索対象から除外できます。
### メタデータ管理ページ：フィールド、デフォルト値、検索時の使用 メタデータ管理 」で定義してください。その後、各ドキュメントや FAQ に値を入力できます。ページ上部には「メタデータフィールドはドキュメントに追加の構造化情報を提供し、コンテンツの整理や検索に役立ちます。グローバルデフォルト値を設定すると、新しくアップロードされたドキュメントに自動適用されます」と説明されています。一覧の列は次のとおりです：
| フィールド | 説明 |
| ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| フィールド名 | `url`、`version` などのメタデータのキーです |
| 種類 | デフォルト ＝システム組み込みのフィールドです。カスタム ＝「カスタムフィールドを追加 」で作成したフィールドです |
| フィールドの説明 | 管理者向けの用途の説明です |
| デフォルト値 | 新しくアップロードされたドキュメントに自動適用される値です。未設定の場合は「（なし）」と表示されます |
| 検索設定 | チェックが付いていれば「検索時に使用 」が有効です |
| 操作 | 編集 、削除 （ナレッジベースの編集／削除権限が必要です） |
「カスタムフィールドを追加 」または「編集 」をクリックしたら、次の項目を入力します：
* **フィールド名**：英字で始め、英字・数字・アンダースコアのみを使用し、50 文字以内にします。
* **フィールドの説明**：任意です。200 文字以内で、例えば「引用ドキュメントへのリンク」と入力します。
* **デフォルト値**：任意です。画面には「グローバルデフォルト値を設定すると、新しくアップロードされたドキュメントに自動適用されます」と表示されます。既存のドキュメントには遡って適用されません。値を追加するには[メタデータの一括管理](/maiagent-user-guide/ja/build/knowledge-base/km.md#batch-manage-labels-metadata)を使ってください。
* **検索時に使用**：有効にすると、画面には「検索時にこの情報を LLM に渡し、回答の判断や参照に使用します」と説明されます。つまり、ある断片を検索した際に、そのドキュメントの該当メタデータ値も Agent に渡されます。「ドキュメントのバージョン」「適用地域」「発効日」など、回答に影響する情報に適しています。[カスタム URL マッピング](#custom-url-mapping)だけに使う `url` などのフィールドでは有効にする必要がなく、トークンを節約できます。
{% hint style="warning" %}
フィールドを編集すると、そのフィールドを使用しているすべてのドキュメントに影響します。フィールドを削除すると、すべてのドキュメントからそのフィールドのデータが削除され、復元できません。
{% endhint %}
### ドキュメントへのメタデータの追加 メタデータを追加 」ボタンをクリックして、入力したキーと値の対応関係を追加します（一度に複数のメタデータを追加できます）。
引用ノードの表示
元のファイルの場所の表示
&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.
.png?alt=media)
.png?alt=media)
.png?alt=media)
.png?alt=media)
%20(1).png?alt=media)
.png?alt=media)
.png?alt=media)
.png?alt=media)
.png?alt=media)
.png?alt=media)
.png?alt=media)
.png?alt=media)
.png?alt=media)
.png?alt=media)
.png?alt=media)
.png?alt=media)
