タグとカスタムメタデータ
Access Tags は誰がドキュメントを見られるかを決めます。Custom Metadata はドキュメントが何についてのものかを記述します。UI では似ていますが、解決する問題は異なります — Access Tags をメタデータの代わりに使わないでください（その逆も同様です）。
前提条件
| タスク | 必要なもの |
|---|---|
| チームタグの作成 | My Account → Tags へのアクセス（タグカタログのチーム管理者経路） |
| 人にタグを割り当て | Team Management でメンバーを編集する権限 |
| ドキュメントに Access Tags を適用 | ナレッジベースリソースを編集する権限 |
| ドキュメントの Custom Metadata を編集 | リソースを編集する権限 |
| エージェントに検索可能なメタデータでのフィルタリングをさせる | エージェント上の Knowledge Base ツールキットで Custom Metadata Filtering が有効であること |
Access Tags
何であるか
タグは誰がドキュメントを見られるかを制御する — バッジシステムです。ドキュメントを開くのにバッジを要求したり、特定のバッジを持つ人をブロックできます。
タグは可視性とアクセス制御のために存在します。タグは部署名やトピック名で呼ばれますが、それはラベルにすぎません — 実際の唯一の効果は、誰がドキュメントを見られる（または見られない）かです。Custom Metadata のようにドキュメントを整理、分類、フィルタリングすることはしません。
エンドツーエンドのセットアップ
- My Account → Tags でタグカタログを作成します（例：
HR-Only、Sales-Team、Finance-Confidential）。 - チームメンバーを編集するときに人にタグを割り当てます（ロールを変更するのと同じ場所）。各メンバーは1つ以上のタグを持つことができます。
- リソース詳細ページ → Access Tags → Edit Access Tags からドキュメントにタグを適用します（Document Access Control が開きます）。
ドキュメント上のモード
| モード | UI ラベル | 効果 |
|---|---|---|
| Allow | Allow Only | ユーザーはドキュメントを見るために一覧のタグを少なくとも1つ持つ必要があります |
| Block | Allow None | 一覧のタグをいずれか持つユーザーは、他の条件でアクセスできたとしても拒否されます |
経験則：
- ドキュメントに Access Tags がない場合、プロジェクトにアクセスできるすべての人が見られます — タグは適用されて初めて制限します
- 両方のモードが同じ人に適用されうる場合、ブロックは常にAllow より優先されます
- ドキュメントのモーダルがリマインドします：カタログが空の場合は My Account → Tags でタグを作成してください
例： 給与査定をアップロードして Allow Only: HR-Only を設定します。
HR-Onlyタグを持つユーザーは開いて検索できます；そのタグを持たない人は検索結果やチャットの回答で見られません。
注意： Access Tags は、AI 搭載の検索やチャットの回答に何が表示されるかを支配します（そのユーザーとしての EKB Runtime の
search_knowledgeとask_*を含む）。正しいプロジェクトレベルのアクセスの上乗せのレイヤーとして扱い、代わりにしてはいけません。
Access Tags を使うべきとき
- 機密または機微なドキュメント（人事記録、給与、法務、財務データ）
- 同じプロジェクト内で社内全体に見せるべきでない部署固有の資料
- 特定のロールまたはクリアランスのみを想定したドキュメント
日常的な整理 — 部署、トピック、種類による並べ替え — には下記の Custom Metadata を使用してください。
Custom Metadata
何であるか
Custom Metadata はドキュメントに記述的なラベルを付与します — Department: Engineering、Author: Jane Smith、Version: 2.1 のような事実です。"誰が見られるか？" ではなく "このドキュメントは何についてか？" に答えます。
リソースの Details タブで、Custom Metadata は2つのセクションに表示されます：
| セクション | UI ラベル | 役割 |
|---|---|---|
| 自動 / コネクタフィールド | AI-Searchable | 自動入力（例：SharePoint ライブラリの列から）され、エージェントの取得のためにインデックス化 |
| 手動フィールド | User-Defined | Add Field で追加 — 参考のみ；エージェントからは検索不可 |
2つのタイプの比較
| User-Defined（手動） | AI-Searchable（自動取得） | |
|---|---|---|
| 追加方法 | ドキュメントの Add Field | 列/フィールドを持つ接続済みソースからインポート時に取得 |
| 検索結果をフィルタするか | いいえ — 参考のみ | はい — 検索を絞り込めるのはこのタイプ |
| 表示 | User-Defined | AI-Searchable |
エージェント：Custom Metadata Filtering
エージェントの Knowledge Base ツールキット構成で Custom Metadata Filtering（enable_metadata_filtering）を有効にすると：
- ナレッジ検索ツールに
metadata_filterパラメータが追加されます - 利用可能なメタデータフィールド/値を一覧表示するツールが追加されます
これが、エージェントが意図的に取得を特定の検索可能なメタデータを持つドキュメント（例：SharePoint の列）に限定する方法です。マッチングはあいまいではなく完全一致です — 値を一貫させてください（Engineering であって Eng / eng. dept ではない）。
フラットフィールドのみ
メタデータフィールドはフラットな単一レベルのラベルで、ネストされたカテゴリではありません。Department: Engineering は作れますが、Department → Team → Sub-team のような単一のネスト構造は作れません。
2番目の詳細レベルが必要な場合は、2つ目のフィールド（例：Department の隣の Sub-Team）を追加してください。フィルタリング時に両方を組み合わせることは引き続き可能です。
クイック比較
| Access Tags | Custom Metadata | |
|---|---|---|
| 目的 | 誰がドキュメントを見られるかを制御 | ドキュメントが何についてかを記述 |
| 最適な用途 | 機密性とアクセス制御 | 整理と精密な検索 |
| 検索/チャットに影響 | はい — 制限されたドキュメントはアクセスのないユーザーには非表示 | AI-Searchable フィールドのみが取得を絞り込む（エージェントでフィルタリングが有効な場合） |
| 設定方法 | タグカタログ + メンバーへの割り当て + ドキュメントの Edit Access Tags | Add Field、またはコネクタインポート時の自動取得 |
| カタログの場所 | My Account → Tags | ドキュメントごと（およびソースシステムの列） |
トラブルシューティング
| 症状 | 確認すること |
|---|---|
| Edit Access Tags にタグが表示されない | まず My Account → Tags でタグを作成 |
| ユーザーが制限されたドキュメントをまだ見られる | ユーザーに割り当てられたタグ、ドキュメントの Allow Only / Allow None、ブロック優先のルールが意図と逆になっていないことを確認 |
| あるべきドキュメントが見えない | Allow Only タグが欠けているか、Allow None タグを持っている可能性 |
| エージェントが部署でフィルタしない | フィールドが AI-Searchable か、値が一貫しているか、KB ツールキットで Custom Metadata Filtering が有効かを確認 |
| 手動メタデータが回答に影響しない | User-Defined フィールドでは想定どおり — 参考のみ |