Gemini Cloud Assist を設定する

Gemini Cloud Assist を使用するには、このドキュメントで説明する設定手順を管理者が行う必要があります。Gemini Cloud Assist は、プロジェクトまたはフォルダに設定できます。

プロジェクトの Gemini Cloud Assist を設定する

次の手順では、Google Cloud コンソールまたは Google Cloud CLI を使用して、プロジェクトに Gemini Cloud Assist を設定する方法について説明します。

コンソール

  1. [Gemini の管理] ページに移動します。

    [Gemini for Google Cloud] に移動

  2. ページ上部のプロジェクト選択ツールから、プロジェクト リソースを選択します。

  3. [Gemini Cloud Assist を入手する] を選択します。

  4. [Gemini Cloud Assist を入手する] ダイアログで、次の操作を行います。

    1. [必須および推奨の API] セクションにある展開矢印 を選択します。

    2. 必要な API(Gemini Cloud Assist APIGemini for Google Cloud API)が有効になっていることを確認します。

    3. [推奨 API] リストで、有効にする API を選択します。

    4. 省略可: [プロンプトと回答を共有して Cloud Assist の改善にご協力ください] を選択します。

    5. [Gemini Cloud Assist を無料で有効にする] を選択します。

  5. [保存] をクリックします。

  6. Gemini Cloud Assist の使用に必要な IAM ロールを付与します。

    1. [IAM と管理] ページに移動します。

      [IAM と管理] に移動

    2. [プリンシパル] 列で、Gemini Cloud Assist へのアクセスを許可するプリンシパルを見つけて、その行で [プリンシパルを編集] をクリックします。

    3. 権限の編集ペインで、[ 別のロールを追加] をクリックします。

    4. [ロールを選択] で、[Gemini Cloud Assist ユーザー] を選択します。

    5. [別のロールを追加] をクリックし、[Recommender 閲覧者] を選択します。

    プリンシパルがアクセス権のないプロダクトに関するサポートを希望している場合は、追加の IAM ロールを付与する必要があります。さまざまなプロダクトで Gemini Cloud Assist を最適に使用するための IAM ロールの表については、Gemini Cloud Assist の使用に関する IAM 要件をご覧ください。

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

  2. gcloud services enable コマンドを使用して Gemini Cloud Assist API を有効にします。

    gcloud services enable geminicloudassist.googleapis.com
    

    この手順で Gemini for Google Cloud API も有効になります。これは Gemini Cloud Assist の使用にも必要です。

    別の Google Cloud プロジェクトで Gemini Cloud Assist API を有効にする場合は、--project パラメータを追加します。

    gcloud services enable geminicloudassist.googleapis.com --project PROJECT_ID
    

    出力は次のようになります。

    Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
    Operation finished successfully.
    
  3. Google Cloud プロジェクトで IAM ロールを付与します。詳細については、単一のロールを付与するgcloud projects add-iam-policy-binding をご覧ください。

    1. roles/geminicloudassist.user ロールを付与します。

      gcloud projects add-iam-policy-binding  PROJECT_ID \
          --member=PRINCIPAL --role=roles/geminicloudassist.user
      

      PRINCIPAL は、プリンシパルの ID に置き換えます。ID の形式は user|group|serviceAccount:email または domain:domain です(例: user:cloudysanfrancisco@gmail.comgroup:admins@example.comserviceAccount:test123@example.domain.comdomain:example.domain.com)。

      以下を含むポリシー バインディングのリストが出力されます。

      - members:
        - user:PRINCIPAL
        role: roles/geminicloudassist.user
      
    2. ロール roles/recommender.viewer に対しても前の手順を繰り返します。

    プリンシパルがアクセス権のないプロダクトに関するサポートを希望している場合は、追加の IAM ロールを付与する必要があります。さまざまなプロダクトで Gemini Cloud Assist を最適に使用するための IAM ロールの表については、Gemini Cloud Assist の使用に関する IAM 要件をご覧ください。

フォルダに Gemini Cloud Assist を設定する

次の手順では、Google Cloud コンソールでフォルダに Gemini Cloud Assist を設定する方法について説明します。Google Cloud CLI を使用して Gemini Cloud Assist を設定することはできません。

  1. 必要な API と推奨 API を有効にします。

    1. [Gemini の管理] ページに移動します。

      [Gemini の管理] に移動

    2. ページ上部のプロジェクト選択ツールから、フォルダリソースを選択します。

    3. [Gemini Cloud Assist を入手する] を選択します。

      [フォルダ内の既存のプロジェクトに対して API を有効にする] ダイアログが表示されます。

    4. [フォルダ内の既存のプロジェクトに対して API を有効にする] ダイアログで、[必須の API と推奨される API] セクションの展開矢印 を選択します。

    5. 必要な API(Gemini Cloud Assist APIGemini for Google Cloud API)が有効になっていることを確認します。

    6. [推奨 API] リストで、有効にする API を選択します。

    7. 省略可: [プロンプトと回答を共有して Cloud Assist の改善にご協力ください] を選択します。

    8. [Gemini Cloud Assist を無料で有効にする] を選択します。

      この手順では、フォルダ内のすべてのプロジェクトに対して、必須の API と選択した推奨 API を有効にします。フォルダ内の一部のプロジェクトに例外を設ける場合は、それらのプロジェクトにリソース サービスの使用を制限する 組織のポリシーの制約を設定することで、API の有効化をブロックできます。詳細については、リソースの使用量の制限をご覧ください。

  2. 次の IAM ロールを付与するか、フォルダに対する同等の権限を持つカスタムロールを作成します。

    • Gemini for Google Cloud ユーザー
    • Cloud Asset 閲覧者
    • Recommender 閲覧者

    プリンシパルがアクセス権のないプロダクトに関するサポートを希望している場合は、追加の IAM ロールを付与する必要があります。さまざまなプロダクトで Gemini Cloud Assist を最適に使用するための IAM ロールの表については、Gemini Cloud Assist の使用に関する IAM 要件をご覧ください。

  3. アプリケーションで Gemini Cloud Assist を使用している場合は、アプリケーション管理も有効にする必要があります。この手順では、請求先アカウントをリンクする管理プロジェクトを作成します。

    1. [Gemini の管理] ページに戻ります。

      [Gemini の管理] に移動

    2. [アプリ管理を有効にする] を選択します。

      [IAM と管理] 設定ページが表示されます。

    3. ページの [アプリの有効化] セクションで [有効にする] を選択します。

      [このフォルダでアプリケーション API を有効にする] ダイアログが表示されます。

    4. [有効にする] を選択します。

      ステータスバーに API の有効化の進行状況が表示されます。API の有効化が完了すると、[IAM と管理] 設定ページが更新されます。

    5. [お支払いの管理] を選択します。

      [リンクされたアカウント] ページが表示されます。

    6. リストから請求先アカウントを選択し、[アカウントを設定] を選択します。

  4. 手順 2 でフォルダに付与したIAM ロールを付与するか、前の手順で作成した管理プロジェクトと同等の権限を持つカスタムロールを作成します。

    フォルダの管理プロジェクトを見つけます。

    1. [Gemini の管理] ページに戻ります。

      [Gemini の管理] に移動

    2. ページ上部のプロジェクト選択ツールから、フォルダリソースを選択します。

    3. [Gemini Cloud Assist の設定を管理] を選択します。

      [Gemini Cloud Assist を管理する] ダイアログが表示されます。

    4. 管理プロジェクトをメモします。

  5. (省略可)フォルダ内のプロジェクトの設定を構成する

次のステップ