Gemini Code Assist einrichten

Bevor Sie Gemini Code Assist verwenden können, muss Ihr Team die in diesem Dokument beschriebenen Einrichtungsschritte ausführen:

  1. Kaufen Sie ein Abo für Gemini Code Assist.

  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. Wenden Sie sich an unser Vertriebsteam, um dieses Angebot in Anspruch zu nehmen.

Standardversion

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

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

Hinweis: Sie benötigen die IAM-Berechtigung (Identity and Access Management) consumerprocurement.orders.place, um ein Gemini-Abo zu erwerben. 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.

    Gemini for Google Cloud aufrufen

    Die Seite Gemini for Google Cloud wird geöffnet.

  2. Klicken Sie auf Gemini Code Assist nutzen. Wenn Ihr Projekt bereits Gemini Code Assist erstellt haben, wird dieser Text angezeigt. Gemini Code Assist verwalten

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

  3. Füllen Sie unter Abo konfigurieren die Felder aus, um das Abo zu konfigurieren. Dazu gehören:

    • Name des Abos.
    • Anzahl der Lizenzen im Abo.
    • Abolaufzeit (monatlich oder jährlich). Mit einem Jahresabo erhalten einen rabattierten Preis, der monatlich in Rechnung gestellt wird, als eine einmalige Zahlung.
    • Automatische Verlängerung Ihres Abos nach Ablauf der Mindestvertragslaufzeit (monatlich oder jährlich). Durch die automatische Verlängerung bleiben Ihr Abo und Ihre Lizenzen aktiv. Wenn das Abo nicht automatisch verlängert wird, endet es mit dem Ende der aktuellen Laufzeit. müssen Sie den Kaufvorgang noch einmal durchlaufen Lizenzen.

  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 wird jetzt erworben. Jetzt müssen Sie 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 Administrator für Gemini auf.

    Zur Seite „Admin 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

Wenn Sie Gemini-Lizenzen mit der API zuweisen möchten, 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 Rechnungskonto-ID
  • ORDER_ID: die IAM-Richtlinie

Anfragetext:

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

Die Ausgabe sieht in etwa so aus:

{}

Die Antwort ist leer, wenn die Lizenz erfolgreich zugewiesen wurde.

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 beschrieben, die zum Aktivieren des Gemini für die Google Cloud API in einem Google Cloud-Projekt.

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 der Status Aktiviert wird angezeigt. 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 dem 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 für Google Cloud ist jetzt in den angegebenen Google Cloud-Projekt an alle Nutzer mit der Erforderliche IAM-Rollen.

IAM-Rollen in einem Google Cloud-Projekt zuweisen

In diesem Abschnitt werden die Schritte beschrieben, die erforderlich sind, um Gemini für Google Cloud-Nutzer zu gewähren. und Service Usage Consumer IAM-Rollen.

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 ein Hauptkonto, dem Sie Zugriff auf Gemini gewähren möchten, und klicken Sie dann in dieser Zeile auf Hauptkonto bearbeiten.

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

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

  5. Klicken Sie auf Weitere Rolle hinzufügen und wählen Sie Service Usage-Nutzer 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-Nutzer“ 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, die Folgendes enthält:

    - 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 mit den folgenden Informationen:

    - 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 for Google Cloud – Übersicht.

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

Die Nutzer in Ihrer Organisation installieren Gemini Code Assist in ihrem bevorzugte 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 Zu gewährende IAM-Clientbibliotheken Rollen.

    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 benutzerdefinierten Rollen, die Sie erstellen, benötigen Sie die folgenden Berechtigungen, um auf Gemini Code Assist zuzugreifen:

    • 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 benutzerdefinierten Rollen, die Sie erstellen, benötigen Sie die folgenden Berechtigungen, um auf Gemini Code Assist zuzugreifen:

    • 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

Beachten Sie außerdem, dass die Gemini for Google Cloud API in dem Google Cloud-Projekt aktiviert sein muss, in dem Sie die einzelnen Berechtigungen zugewiesen haben, damit die entsprechenden Berechtigungen funktionieren.

Nächste Schritte