Gemini Code Assist を設定する

注: Gemini for Google Cloud Code Assist は 2024 年 7 月 11 日まで料金不要でお試しいただけます。ただし、請求先アカウントごとに 1 ユーザーに限ります。組織についてはこちらからライセンスをご購入いただけます。

Gemini for Google Cloud Code Assist を使用する前に、チームがこのドキュメントで説明する設定手順を行う必要があります。

1. 省略可: Gemini Code Assist のサブスクリプションを購入します。Gemini Code Assist は 2024 年 7 月 11 日まで料金不要でお試しいただけます。ただし、請求先アカウントごとに 1 ユーザーに限ります。

2. Google Cloud プロジェクトで Cloud AI Companion API を有効にします。 通常、このステップは管理者が行います。

3. Google Cloud プロジェクトで Identity and Access Management（IAM）のロールを付与します。通常、このステップは管理者が行います。

4. 省略可: IDE で Gemini Code Assist を使用するには、Cloud Code プラグインをインストールします。

省略可: Gemini Code Assist のサブスクリプションを購入する

Gemini Code Assist は、2024 年 7 月 11 日まで、サブスクリプションなしで料金不要でお試しいただけます。ただし、請求先アカウントごとに 1 ユーザーに限ります。1 つの請求先アカウントに複数のユーザーが存在する組織は、このセクションの説明に沿ってサブスクリプションを購入する必要があります。Google Cloud と既存の契約を結んでいる場合は、サブスクリプションを購入する前に セールスチームに問い合わせください。

注: Gemini のサブスクリプションを購入するには、billing.subscriptions.create Identity and Access Management（IAM）権限を付与されていることが必要です。billing.subscriptions.create 権限は roles/billing.admin IAM ロールに含まれています。または、カスタムロールに権限を追加することもできます。

1. Google Cloud コンソールで、[Gemini for Google Cloud] ページに移動します。

   [Gemini for Google Cloud] に移動

2. [Gemini を使ってみる] をクリックします。

3. プロンプトが表示されたら、請求先アカウントを選択して、[Gemini の管理者ページに進む] をクリックします。

4. [サブスクリプションの構成] で、コミットメント期間（月単位または年単位）、サブスクリプションのライセンス数などのサブスクリプションを構成するフィールドに入力します。

   注: 年単位のサブスクリプションでは、まとめ払いではなく、割引された年間料金が毎月請求されます。

   コミットメント期間（月単位または年単位）の経過後にサブスクリプションを自動更新するかどうかを選択します。自動更新では、サブスクリプションとライセンスが有効のままになります。サブスクリプションが自動更新されない場合、現在の期間が終了するとサブスクリプションが終了し、ライセンスを再取得するには、購入プロセスをもう一度行う必要があります。

5. サブスクリプションの詳細を確認するには、[続行] をクリックします。

6. 利用規約に同意する場合は、[購入を完了] をクリックしてから、サブスクリプションを確定します。

これで Gemini の課金が有効になりました。この請求先アカウントに関連付けられている 1 つ以上のプロジェクトで Cloud AI Companion API を有効にする必要があります。少なくとも 1 つのプロジェクトで Gemini を有効にするまで、Gemini はユーザーに表示されません。

Google Cloud プロジェクトで Cloud AI Companion API を有効にする

このセクションでは、Google Cloud プロジェクトで Cloud AI Companion API を有効にするために必要な手順について説明します。

コンソール

1. Cloud AI Companion API を有効にするには、[Gemini for Google Cloud] ページに移動します。

   [Gemini for Google Cloud] に移動

2. プロジェクト セレクタでプロジェクトを選択します。

3. [有効にする] をクリックします。

   ページが更新され、[有効] のステータスが表示されます。これで、必要な IAM ロールを持つすべてのユーザーが、選択した Google Cloud プロジェクトで Gemini を使用できるようになりました。

gcloud

1. Google Cloud コンソールで、「Cloud Shell をアクティブにする」をクリックします。

   Cloud Shell をアクティブにする

2. プロジェクト選択メニューで、プロジェクトを選択します。

3. gcloud services enable コマンドを使用して、Gemini 用の Cloud AI Companion API を有効にします。

   gcloud services enable cloudaicompanion.googleapis.com
   

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

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

   PROJECT_ID は、実際の Google Cloud プロジェクト ID に置き換えます。

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

   Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
   Operation finished successfully.
   

これで、必要な IAM ロールを持つすべてのユーザーが、指定された Google Cloud プロジェクトで Gemini for Google Cloud を使用できるようになりました。

Google Cloud プロジェクトで IAM ロールを付与する

このセクションでは、ユーザーに Cloud AI Companion ユーザーと Service Usage 閲覧者の IAM ロールを付与するために必要な手順について説明します。

コンソール

1. Gemini の使用に必要な IAM ロールを付与するには、[IAM と管理] ページに移動します。

   [IAM と管理] に移動

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

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

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

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

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

gcloud

1. Google Cloud コンソールで、「Cloud Shell をアクティブにする」をクリックします。

   Cloud Shell をアクティブにする

2. プロジェクト選択メニューで、プロジェクトを選択します。

3. Cloud AI Companion ユーザーロールを付与します。

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

   PRINCIPAL は、プリンシパルの ID に置き換えます。ID の形式は user|group|serviceAccount:email または domain:domain です（例: user:[e-mail]、group:[e-mail]、serviceAccount:[e-mail]、domain:example.domain.com）。

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

   - members:
     - user:PRINCIPAL
     role: roles/cloudaicompanion.user
   

4. Service Usage 閲覧者のロールを付与します。

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

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

   - members:
     - user:PRINCIPAL
     role: roles/serviceusage.serviceUsageViewer
   

詳細については、単一のロールを付与すると gcloud projects add-iam-policy-binding をご覧ください。

これらのロールが付与されたすべてのユーザーは、指定したプロジェクト内の Google Cloud コンソールの Gemini for Google Cloud 機能にアクセスできます。詳細については、Gemini for Google Cloud の概要をご覧ください。

省略可: IDE で Gemini Code Assist を使用する

IDE で Gemini を使用することを必要とするデベロッパーである場合は、Cloud Code プラグインをインストールする必要があります。詳しくは以下をご覧ください。

• Cloud Workstations: Gemini Code Assist を使用したコード
• Cloud Shell エディタ: Gemini Code Assist を使用したコード
• Cloud Code for VS Code: Gemini Code Assist を使用したコード
• Cloud Code for IntelliJ とその他の JetBrains IDE: Gemini Code Assist を使用したコード

高度な設定タスク

Google Cloud コンソールまたは gcloud CLI を使用して事前定義された IAM ロールを付与する代わりに、次のいずれかを行うことができます。

• IAM REST API または IAM クライアント ライブラリを使用してロールを付与します。

  これらのインターフェースを使用する場合は、完全修飾ロール名を使用します。

  • roles/cloudaicompanion.user
  • roles/serviceusage.serviceUsageViewer

  ロールの付与については、プロジェクト、フォルダ、組織へのアクセスを管理するをご覧ください。

• カスタムロールを作成して付与します。

  作成するカスタムロールには、Gemini にアクセスするために次の権限が必要です。

  • cloudaicompanion.companions.generateChat
  • cloudaicompanion.companions.generateCode
  • serviceusage.services.get

次のステップ

• Gemini for Google Cloud で利用できる生成 AI アシスタンスの種類の詳細について学習する。
• Gemini for Google Cloud がデータを使用する方法について学習する。
• Gemini 管理者コントロールにアクセスして管理する方法を学習する。