プロアクティブ モードを設定する

Gemini Cloud Assist がバックグラウンドで自律的に実行され、アラートの調査と費用の異常の分析を継続的に行えるように、プロアクティブ モードを設定します。

プロアクティブ モードを有効にすると、Gemini Cloud Assist 専用のサービス アカウントがプロビジョニングされます。このアカウントを構成することで、Gemini Cloud Assist に、ユーザーが介入しなくても環境のテレメトリーとログを分析するために必要なアクセス権を付与できます。

必要な API を有効にする

プロジェクトで次の API が有効になっていることを確認します。

  • Gemini Cloud Assist: geminicloudassist.googleapis.com
  • App Optimize API: appoptimize.googleapis.com

これらの API を有効にする方法の詳細については、 Gemini Cloud Assist を設定するおよび App Optimize API を有効にするをご覧ください。

プロアクティブな費用の分析情報を生成するために、Gemini Cloud Assist は 費用の異常アラートに 依存しています。これらのアラートは、すべてのプロジェクトでデフォルトで有効になっています。

プロアクティブ モードを有効にする

プロジェクト管理者は、プロアクティブ モードを明示的に有効にする必要があります。プロアクティブ モードを有効にすると、Gemini Cloud Assist はエージェント ID と呼ばれる専用のサービス アカウントを自動的にプロビジョニングします。

  1. コンソールを Google Cloud 開きます。

    コンソールに移動 Google Cloud

  2. コンソールの任意のページで Google Cloud 、 spark [**Gemini Cloud Assist チャットを開始または終了します**]をクリックします。

    [Cloud Assist] パネルが開きます。

  3. [**その他の操作**]（）をクリックし、 プルダウン メニューから [**Cloud Assist の設定**] をクリックします。

    [Gemini Cloud Assist を管理] 設定パネルが開きます。

  4. [プロアクティブ エージェント] セクションで [プロアクティブ エージェントを有効にする] を選択し、[アクセス権を付与] をクリックします。

  5. [アクセス権を付与] パネルで [保存] をクリックします。

  6. [Gemini Cloud Assist を管理] パネルの下部にある [保存] をクリックします。

権限を構成する

プロアクティブ モードを設定するには、ユーザーとエージェント ID に IAM ロールを付与する必要があります。

エージェント ID のロール

エージェントがバックグラウンドで自律的に実行される場合、エージェント ID が使用されます。エージェント ID は、プロアクティブ モードを有効にすると自動的にプロビジョニングされるため、作成する必要はありません。ただし、このエージェント ID には、バックグラウンド タスクを実行するために必要な IAM ロールを付与する必要があります。Gemini Cloud Assist は、エージェント ID に付与された IAM ロールを通じて明示的に承認したデータにのみアクセスします。

これは、Cloud Monitoring、Cloud Logging、Cloud Asset Inventory などのサービスに対する読み取り専用アクセスに限定されます。これらの権限を明示的に付与しない限り、データベースやストレージ バケット内のデータにアクセスすることはできません。

説明可能性を高めるため、Gemini Cloud Assist によって生成されたすべての分析情報には、アラートや特定のログなどのソースデータにリンクする引用が含まれています。

エージェント ID プリンシパルの形式は次のとおりです。

agents.global.org-ORG_NUMBER.system.id.goog/resources/geminicloudassist/projects/PROJECT_NUMBER/locations/global/agents/cloud

ここで、ORG_NUMBER は Google Cloud 組織の数値 ID、PROJECT_NUMBER は 実際の Google Cloud プロジェクトの数値 ID です。

エージェント ID に必要な権限は、使用するプロアクティブ モードの機能によって異なります。次のロールは、ユースケースに基づいた適切な出発点となりますが、環境の特性やプロアクティブ モードで実行するタスクに応じて、追加のロールを付与する必要がある場合があります。

タスク固有のロールの詳細については、 職務機能のロールをご覧ください。 Gemini Cloud Assist の権限とロールの詳細については、IAM の要件をご覧ください。

ユースケースに基づいて、次のロールをエージェント ID プリンシパルに付与します。

  • プロアクティブなトラブルシューティング: サポート ユーザー（roles/iam.supportUser）と Service Usage コンシューマー（roles/serviceusage.serviceUsageConsumer）を付与します。
  • プロアクティブな費用の最適化: プロアクティブな トラブルシューティングのロールに加えて、次のロールを付与します:
    • リソース費用にアクセスするための Cloud Hub オペレーター（roles/cloudhub.operator）。
    • 費用の最適化調査を生成するための App Optimize 管理者（roles/appoptimize.admin）。

これらのロールは、Google Cloud CLI を使用して付与できます。プロアクティブ モードで使用するために gcloud CLI をインストールして 初期化するには、 Google Cloud CLI をインストールするをご覧ください。

次の gcloud CLI コマンドを実行して、エージェント ID のロールを付与します。

gcloud projects add-iam-policy-binding PROJECT_ID \
    --role='roles/iam.supportUser' \
    --member='principal://agents.global.org-ORG_NUMBER.system.id.goog/resources/geminicloudassist/projects/PROJECT_NUMBER/locations/global/agents/cloud'
gcloud projects add-iam-policy-binding PROJECT_ID \
    --role='roles/cloudhub.operator' \
    --member='principal://agents.global.org-ORG_NUMBER.system.id.goog/resources/geminicloudassist/projects/PROJECT_NUMBER/locations/global/agents/cloud'
gcloud projects add-iam-policy-binding PROJECT_ID \
    --role='roles/appoptimize.admin' \
    --member='principal://agents.global.org-ORG_NUMBER.system.id.goog/resources/geminicloudassist/projects/PROJECT_NUMBER/locations/global/agents/cloud'
gcloud projects add-iam-policy-binding PROJECT_ID \
    --role='roles/serviceusage.serviceUsageConsumer' \
    --member='principal://agents.global.org-ORG_NUMBER.system.id.goog/resources/geminicloudassist/projects/PROJECT_NUMBER/locations/global/agents/cloud'

次のように置き換えます。

  • PROJECT_ID: 実際の Google Cloud プロジェクト ID。
  • ORG_NUMBER: 組織 Google Cloud の数値 ID。
  • PROJECT_NUMBER: プロジェクト Google Cloud の数値 ID。

これらの ID は Google Cloud コンソールから取得できます。

カスタム制約

ロールの付与を許可する プリンシパル タイプを制限する 組織ポリシーの カスタム制約がある場合、 エージェント ID に IAM ロールを付与しようとするとエラーが発生する可能性があります。この場合は、エージェント ID プリンシパル タイプ iam.googleapis.com/AgenticIdentityPoolPrincipal を、IAM ロールの付与を許可するプリンシパル タイプを制限するカスタム制約の MemberTypeMatches 部分に追加します。

ユーザーロール

プロアクティブな結果を操作するユーザーには、次のロールが必要です。

  • roles/geminicloudassist.user（エージェントとチャットする）
  • roles/geminicloudassist.viewer （プロアクティブな調査と費用の最適化調査を表示する）。

次の gcloud CLI コマンドを使用して、これらのロールを付与します。

gcloud projects add-iam-policy-binding PROJECT_ID \
    --role='roles/geminicloudassist.user' \
    --member='user:EMAIL_ADDRESS'
gcloud projects add-iam-policy-binding PROJECT_ID \
    --role='roles/geminicloudassist.viewer' \
    --member='user:EMAIL_ADDRESS'

EMAIL_ADDRESS は、エージェントとチャットしてプロアクティブな調査結果を表示する権限が必要なユーザーのメールアドレスに置き換えます。

次のステップ