Gemini Code Assist einrichten

Vor der Verwendung Gemini Code Assist, wie Sie die in diesem Dokument beschriebenen Einrichtungsschritte ausführen:

  1. Kaufen Sie ein Gemini Code Assist-Abo.

  2. Weisen Sie einzelnen Nutzern in Ihrer Organisation Lizenzen zu.

  3. Aktivieren Sie die Gemini for Google Cloud API in einem Google Cloud-Projekt.

  4. IAM-Rollen (Identity and Access Management) in einem Google Cloud-Projekt gewähren

  5. Die Nutzer in Ihrer Organisation installieren das Cloud Code-Plug-in für die Verwendung Gemini Code Assist in einer IDE

Gemini Code Assist-Abo kaufen

Die Schritte zum Kauf eines Gemini Code Assist-Abos hängen davon ab, welche Version Sie erwerben: Enterprise oder Standard. Eine Liste der in den einzelnen Versionen verfügbaren Funktionen finden Sie unter Unterstützte Funktionen.

Enterprise-Version

Gemini Code Assist Enterprise ist bis zum 31. März 2025 für 19 $ pro Monat und Nutzer bei einer Vertragsdauer von 12 Monaten verfügbar. Unser Vertriebsteam kontaktieren um dieses Werbeangebot zu nutzen.

Standardversion

Gemini Code Assist Standard kann ohne eine Abo bis zum 8. November 2024 kostenlos, begrenzt auf einen Nutzer pro Abrechnung Konto. Organisationen mit mehreren Nutzern pro Rechnungskonto müssen Folgendes erwerben: ein Abo, wie in diesem Abschnitt beschrieben.

Wenn Sie Verträge mit Google Cloud haben, wenden Sie sich bitte an unser Vertriebsteam, bevor Sie ein Abo erwerben.

Hinweis: Sie benötigen die consumerprocurement.orders.place IAM-Berechtigung (Identity and Access Management) zum Kauf von Gemini Abo. Die Berechtigung consumerprocurement.orders.place ist enthalten in die IAM-Rolle roles/billing.admin oder die Rolle roles/consumerprocurement.orderAdmin. Alternativ können Sie die Berechtigung einer benutzerdefinierten Rolle hinzufügen.

  1. Rufen Sie die Seite Gemini für Google Cloud auf.

    Zu Gemini for Google Cloud

    Die Seite Gemini for Google Cloud wird geöffnet.

  2. Klicken Sie auf Gemini Code Assist nutzen. Wenn für Ihr Projekt bereits Gemini Code Assist verwendet wird, wird anstelle dieses Textes Gemini Code Assist verwalten angezeigt.

    Die Seite Gemini Code Assist-Abo abrufen wird geöffnet.

  3. Füllen Sie unter Abo konfigurieren die Felder aus, um den -Abonnement, einschließlich der folgenden:

    • Aboname
    • Anzahl der Lizenzen im Abo.
    • Abolaufzeit (monatlich oder jährlich). Bei einem Jahresabo erhalten Sie einen Rabattpreis, der nicht einmalig, sondern monatlich in Rechnung gestellt wird.
    • Automatische Verlängerung Ihres Abos nach Ablauf der Vertragslaufzeit (monatlich oder jährlich) endet. Durch die automatische Verlängerung bleiben Ihr Abo und Ihre Lizenzen aktiv. Wenn das Abo nicht automatisch verlängert wird, endet es am Ende der aktuellen Laufzeit. Sie müssen dann den Kaufprozess noch einmal durchlaufen und die Lizenzen neu zuweisen.

  4. Klicken Sie auf Weiter, um die Abodetails zu prüfen.

  5. Wenn Sie den Bedingungen zustimmen, wählen Sie Ich stimme den Bedingungen dieses Kaufs zu aus. und klicken Sie dann auf Abo bestätigen.

  6. Klicken Sie auf Weiter: Gemini-Lizenzzuweisungen verwalten.

Das Abo für Gemini Code Assist wurde jetzt gekauft. Sie müssen jetzt die Gemini-Lizenzzuweisungen in Ihrer Organisation verwalten.

Lizenzen zuweisen

Vor der Nutzung von Gemini Code Assist benötigt jeder Nutzer in Ihrer Organisation eine Lizenz.

Console

So weisen Sie einzelnen Nutzern Gemini-Lizenzen in der Google Cloud Console benötigen Sie die folgenden Berechtigungen:

  • billing.accounts.get
  • consumerprocurement.orders.get
  • consumerprocurement.licensePools.get
  • consumerprocurement.licensePools.enumerateLicensedUsers
  • consumerprocurement.licensePools.assign

  1. Rufen Sie die Seite Verwaltung für Gemini auf.

    Zu „Administrator für Gemini“

  2. Wählen Sie das Abo aus, das Sie ändern möchten, und klicken Sie auf Abo ändern.

  3. Klicken Sie auf Lizenzen zuweisen. Ein Dialogfeld zur Nutzerauswahl wird angezeigt. Wenn Sie nach bestimmten Nutzern suchen möchten, geben Sie deren Namen in das Suchfeld ein.

  4. Wählen Sie einen oder mehrere Nutzer aus der Liste aus und klicken Sie auf Weiter.

  5. Wählen Sie die Gemini-Dienste aus, für die Sie Lizenzen zuweisen möchten.

  6. Klicken Sie auf Lizenzen zuweisen.

API

Um Gemini-Lizenzen über die API zuzuweisen, benötigen Sie die Berechtigung consumerprocurement.licensePools.assign.

HTTP-Methode: POST

URL: https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/

Ersetzen Sie Folgendes:

  • BILLING_ACCOUNT_ID: die ID des Rechnungskontos
  • ORDER_ID: die IAM-Richtlinie

Anfragetext:

    {
        "usernames": [
                  "dana@example.com",
                  "lee@example.com"
        ]
    }

Die Ausgabe sieht in etwa so aus:

{}

Wenn die Lizenz erfolgreich zugewiesen wurde, ist die Antwort leer.

Sie müssen jetzt die Gemini für Google Cloud API in einem oder weitere Projekte, die mit diesem Rechnungskonto verknüpft sind. Für Nutzer nicht sichtbar Gemini Code Assist verwenden, bis Sie ihn in mindestens einem Projekt aktivieren.

Gemini for Google Cloud API in einem Google Cloud-Projekt aktivieren

In diesem Abschnitt werden die Schritte zum Aktivieren der Gemini for Google Cloud API in einem Google Cloud-Projekt beschrieben.

Console

  1. Rufen Sie zum Aktivieren der Gemini für Google Cloud API die Seite Gemini für Google Cloud

    Zu Gemini for Google Cloud

  2. Klicken Sie auf die Projektauswahl Projekt auswählen.

  3. Klicken Sie auf Aktivieren.

    Die Seite wird aktualisiert und zeigt den Status Aktiviert an. Gemini ist jetzt im ausgewählten Google Cloud-Projekt für alle Nutzer verfügbar, die die erforderlichen IAM-Rollen haben.

gcloud

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

    Activate Cloud Shell

  2. Wählen Sie im Menü „Projektauswahl“ Ihr Projekt aus.

  3. Aktivieren Sie die Gemini for Google Cloud API für Gemini mit den Befehl gcloud services enable:

    gcloud services enable cloudaicompanion.googleapis.com

    Wenn Sie die Gemini for Google Cloud API in einem anderen Google Cloud-Projekt aktivieren möchten, fügen Sie den Parameter --project hinzu:

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

    Ersetzen Sie PROJECT_ID durch Ihre Google Cloud-Projekt-ID.

    Die Ausgabe sieht in etwa so aus:

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

Gemini for Google Cloud ist jetzt im angegebenen Google Cloud-Projekt für alle Nutzer verfügbar, die die erforderlichen IAM-Rollen haben.

Erforderliche APIs für Nutzer hinter Firewalls

Neben der Aktivierung der Gemini für Google Cloud API können Nutzer, die sich hinter Firewalls schützen, auch Außerdem müssen die folgenden APIs aktiviert werden:

  • oauth2.googleapis.com: zur Anmeldung in Google Cloud verwendet.
  • serviceusage.googleapis.com: Wird verwendet, um zu prüfen, ob das Gemini Code Assist-Projekt des Nutzers richtig konfiguriert ist.
  • cloudcode-pa.googleapis.com: eine interne API, die IDE-bezogene Funktionen.
  • cloudresourcemanager.googleapis.com: Wird in den IDEs für Projektauswahlen verwendet. Die Resource Manager API ist möglicherweise nicht erforderlich, wenn die Projekte in der Datei settings.json explizit konfiguriert sind.
  • people.googleapis.com: Zugriff auf Informationen über Profile und Kontakte bietet.
  • firebaselogging-pa.googleapis.com: Eine interne API, die zum Senden von Produktmesswerten verwendet wird, einschließlich Ereignissen, die angeben, ob Vorschläge akzeptiert wurden.
  • feedback-pa.googleapis.com: Eine interne API, die für die Einreichung von Feedback in der IDE verwendet wird.
  • apihub.googleapis.com: Wird von der Cloud Code API-Browserfunktion verwendet.

IAM-Rollen in einem Google Cloud-Projekt gewähren

In diesem Abschnitt werden die Schritte beschrieben, die erforderlich sind, um Nutzern die IAM-Rollen „Gemini for Google Cloud User“ und „Service Usage Consumer“ zu gewähren.

Console

  1. Zum Zuweisen der IAM-Rollen, die für die Verwendung erforderlich sind Gemini erhalten Sie unter IAM & Verwaltung.

    IAM & Verwaltung aufrufen

  2. Suchen Sie in der Spalte Hauptkonto nach Hauptkonto, für das Sie die Zugriff auf Gemini gewähren möchten, und klicken Sie Wählen Sie in dieser Zeile Hauptkonto bearbeiten aus.

  3. Klicken Sie im Bereich Berechtigungen bearbeiten auf Weitere Rolle hinzufügen.

  4. Wählen Sie unter Rolle auswählen die Option Gemini for Google Cloud-Nutzer aus.

  5. Klicken Sie auf Weitere Rolle hinzufügen und wählen Sie Nutzer der Dienstnutzung aus.

  6. Klicken Sie auf Speichern.

gcloud

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

    Activate Cloud Shell

  2. Wählen Sie im Menü „Projektauswahl“ Ihr Projekt aus.

  3. Weisen Sie die Rolle „Gemini for Google Cloud User“ zu:

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

    Ersetzen Sie PRINCIPAL durch die Kennung des Hauptkontos. Die Kennung hat das Format user|group|serviceAccount:email oder domain:domain, z. B. user:cloudysanfrancisco@gmail.com, group:admins@example.com, serviceAccount:test123@example.domain.com oder domain:example.domain.com.

    Die Ausgabe ist eine Liste von Richtlinienbindungen mit den folgenden Informationen:

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

  4. Weisen Sie die Rolle „Service Usage-Nutzer“ zu:

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

    Die Ausgabe ist eine Liste von Richtlinienbindungen, die Folgendes enthält:

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

Weitere Informationen finden Sie unter Einzelne Rolle zuweisen und gcloud projects add-iam-policy-binding

Alle Nutzer, denen diese Rollen gewährt wurden, haben Zugriff Gemini für Google Cloud-Features in der Google Cloud Console innerhalb des angegebenen Projekts. Weitere Informationen finden Sie unter Gemini für Google Cloud

Cloud Code-Plug-in installieren, um Gemini Code Assist in einer IDE zu verwenden

Die Nutzer Ihrer Organisation installieren Gemini Code Assist in ihrer bevorzugten IDE. Hier finden Sie weitere Informationen:

Aufgaben für die erweiterte Einrichtung

Anstatt vordefinierte IAM-Rollen über die Google Cloud Console oder die gcloud CLI zu gewähren, haben Sie folgende Möglichkeiten:

  • Verwenden Sie IAM REST APIs oder IAM-Clientbibliotheken, um Rollen zu gewähren.

    Wenn Sie diese Oberflächen verwenden, verwenden Sie die vollständig qualifizierten Rollennamen:

    • roles/cloudaicompanion.user
    • roles/serviceusage.serviceUsageConsumer

    Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

  • Benutzerdefinierte Rollen erstellen und gewähren

    Für alle von Ihnen erstellten benutzerdefinierten Rollen sind die folgenden Berechtigungen erforderlich, damit Sie auf Gemini Code Assist zugreifen können:

    • cloudaicompanion.companions.generateChat
    • cloudaicompanion.companions.generateCode
    • cloudaicompanion.instances.completeCode
    • cloudaicompanion.instances.completeTask
    • cloudaicompanion.instances.generateCode
    • cloudaicompanion.instances.generateText
    • serviceusage.services.enable

  • Lizenzen zuweisen und verwalten.

    Für alle von Ihnen erstellten benutzerdefinierten Rollen sind die folgenden Berechtigungen erforderlich, damit Sie auf Gemini Code Assist zugreifen können:

    • consumerprocurement.orders.get
    • consumerprocurement.orders.licensePools..*
    • consumerprocurement.orders.licensePools.update
    • consumerprocurement.orders.licensePools.get
    • consumerprocurement.orders.licensePools.assign
    • consumerprocurement.orders.licensePools.unassign
    • consumerprocurement.orders.licensePools.enumerateLicensedUsers

Für jede der vorgenannten Nutzungserlaubnisse gilt außerdem Folgendes: Gemini für die Google Cloud API muss im selben Google Cloud-Projekt aktiviert werden, in dem Sie den einzelnen Berechtigungen zugewiesen haben.

Nächste Schritte