コンテキスト セットを使用すると、セマンティック情報とデータアセット参照の境界付きコンテナを使用して AI エージェントをグラウンディングできます。これらのコンテナの動作の詳細については、コンテキスト セットの概要をご覧ください。
拡充タスクを実行する前に、コンテキスト セットを構成する必要があります。拡充タスクは、データセットのスキーマとドキュメントを継続的に分析して、データアセットのメタデータの候補を生成する自律型エージェントです。
コンテキスト セットは、スタンドアロン コンテナとして構成することも、拡充ジョブの設定の一部として構成することもできます。タスクの設定中にコンテキスト セットを作成する方法については、拡充タスクを作成するをご覧ください。
始める前に
コンテキスト セットを管理する前に、必要な IAM ロールがあることを確認してください。
必要なロール
コンテキスト セットの管理に必要な権限を取得するには、プロジェクトに対する次の IAM ロールを付与するよう管理者に依頼してください。
- コンテキスト セットを作成するには: Dataplex Catalog 管理者（
roles/dataplex.catalogAdmin）または Dataplex エントリ グループ オーナー（roles/dataplex.entryGroupOwner）。これらのロールには、コンテキスト セットの作成時にオーナー権限を自動的に付与するために必要なdataplex.entryGroups.setIamPolicy権限が含まれています。 - コンテキスト セットを編集または削除するには: Dataplex Catalog 管理者（
roles/dataplex.catalogAdmin）または Dataplex Catalog 編集者（roles/dataplex.catalogEditor）。
コンテキスト セットを作成する
拡充されたメタデータを保存する空のコンテキスト セットを作成する手順は次のとおりです。
Knowledge Studio
Google Cloud コンソールで、[Knowledge Studio] ページに移動します。
左側のナビゲーション パネルで、[コンテキスト セット] を選択します。
[コンテキスト セット] ページで、[作成] をクリックします。
[コンテキスト セットを作成] ペインで、[表示名] フィールドに名前を入力し、[コンテキスト セット ID] フィールドに ID を入力します。
省略可: [説明] を入力し、[ロケーション] を選択して、[ラベル] を追加します。
[保存] をクリックします。
メタデータのタイプ
Google Cloud コンソールで、[メタデータのタイプ] ページに移動します。
[エントリ グループ] > [コンテキスト セット] をクリックします。
[メタデータ タイプ] ページで、[作成] をクリックします。
[コンテキスト セットを作成] ペインで、[表示名] フィールドに名前を入力し、[コンテキスト セット ID] フィールドに ID を入力します。
省略可: [説明] を入力し、[ロケーション] を選択して、[ラベル] を追加します。
[保存] をクリックします。
コンテキスト セットを作成したら、拡充タスクのターゲットとして選択できます。拡充の実行により、AI が提案したメタデータ コンセプト、セマンティック関連付け、数式がこのコンテナに入力されます。
拡充タスクの詳細については、拡充タスクについてをご覧ください。
コンテキスト セットを表示する
既存のコンテキスト セットを表示するには、次の操作を行います。
Knowledge Studio
Google Cloud コンソールで、[Knowledge Studio] ページに移動します。
左側のナビゲーション パネルで、[コンテキスト セット] を選択します。
特定のコンテキスト セットの詳細を表示するには、リスト内の名前をクリックします。
メタデータのタイプ
Google Cloud コンソールで、[メタデータのタイプ] ページに移動します。
[エントリ グループ] > [コンテキスト セット] をクリックします。
特定のコンテキスト セットの詳細を表示するには、リストでその名前をクリックします。
詳細ページには、説明、ロケーション、プロジェクト ID などのコンテキスト セットのプロパティが表示されます。また、[サンプル エントリ] セクションには、コンテキスト セットに保存されている拡充されたメタデータ エントリのプレビューが一覧表示されます。また、検索結果の関連エントリをすべて表示するボタンも用意されています。
コンテキスト セットを編集する
Google Cloud コンソールを使用すると、コンテキスト セットのコンテナ プロパティ（表示名、説明、ラベルなど）を編集できます。
コンテキスト セット内の拡充されたメタデータ コンテンツを更新するには、そのセットをターゲットとする拡充タスクを実行し、生成された変更提案を承認する必要があります。変更提案の承認の詳細については、拡充実行を管理するをご覧ください。
コンテキスト セットのプロパティを編集する手順は次のとおりです。
Knowledge Studio
Google Cloud コンソールで、[Knowledge Studio] ページに移動します。
左側のナビゲーション パネルで、[コンテキスト セット] を選択します。
編集するコンテキスト セットの名前をクリックします。
詳細ページで [編集] をクリックします。
編集可能なフィールド（[表示名]、[説明]、[ラベル]）を変更し、[保存] をクリックします。
メタデータのタイプ
Google Cloud コンソールで、[メタデータのタイプ] ページに移動します。
[エントリ グループ] > [コンテキスト セット] をクリックします。
[メタデータ タイプ] ページで、編集するコンテキスト セットの名前をクリックします。
詳細ページで [編集] をクリックします。
編集可能なフィールド（[表示名]、[説明]、[ラベル]）を変更し、[保存] をクリックします。
コンテキスト セットを削除する
コンテキスト セットを削除すると、データ コンテキスト グラフからそのセマンティック関連付けが削除されます。拡充の実行中にコンテキスト セットを削除すると、ターゲットの宛先が使用できなくなるため、実行の完了時に提案されたメタデータを保存できません。有効なコンテキスト セットに出力するようにタスクを更新するまで、拡充タスクの後続の実行も失敗します。
コンテキスト セットを削除するには、次の操作を行います。
Knowledge Studio
Google Cloud コンソールで、[Knowledge Studio] ページに移動します。
左側のナビゲーション パネルで、[コンテキスト セット] を選択します。
リストで、削除するコンテキスト セットの名前をクリックします。
詳細ページで [削除] をクリックします。
削除を確認します。
メタデータのタイプ
Google Cloud コンソールで、[メタデータのタイプ] ページに移動します。
[エントリ グループ] > [コンテキスト セット] をクリックします。
リストで、削除するコンテキスト セットの名前をクリックします。
詳細ページで [削除] をクリックします。
削除を確認します。
制限事項
プレビュー中に適用される制限事項については、 プレビューの制限をご覧ください。
次のステップ
詳しくは以下をご覧ください。