Gemini Code Assist Standard und Enterprise einrichten

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

Hinweis: Die Schritte 1 bis 4 werden in der Regel von einem Administrator ausgeführt.

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

2. Einzelnen Nutzern in Ihrer Organisation Lizenzen zuweisen

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

4. IAM-Rollen in einem Google Cloud-Projekt zuweisen

5. Die Nutzer Ihrer Organisation installieren das Gemini Code Assist-Plug‑in, um Gemini Code Assist Standard oder Enterprise in einer IDE zu verwenden. Dieser Schritt ist für Gemini CLI-Nutzer nicht erforderlich.

Gemini Code Assist-Abo kaufen

Eine Liste der in den einzelnen Versionen verfügbaren Funktionen finden Sie unter Unterstützte Funktionen.

Bei neuen Gemini Code Assist-Kunden mit Rechnungskonten, die noch nie ein Gemini Code Assist-Abo hatten, wenden wir im ersten Monat automatisch Guthaben an, das bis zu 50 kostenlosen Lizenzen entspricht, unabhängig von der Gemini Code Assist-Version. Nachdem die ursprünglichen kostenlosen Lizenz-Guthaben zugewiesen wurden, können Sie die Anzahl der kostenlosen Guthaben nicht mehr erhöhen. Außerdem können Sie die Gemini Code Assist-Version im ersten Monat nicht ändern.

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

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

   Admin für Gemini aufrufen

   Die Seite Admin for Gemini wird geöffnet.

2. Wählen Sie Gemini Code Assist erhalten aus.

   Wenn Sie nicht die erforderliche consumerprocurement.orders.place-Berechtigung haben, ist diese Schaltfläche deaktiviert. Wenn für das mit dem Projekt verknüpfte Rechnungskonto bereits ein Gemini Code Assist-Abo vorhanden ist, wird diese Schaltfläche als Gemini Code Assist verwalten angezeigt und Sie können Ihr Abo bearbeiten.

   Die Seite Gemini Code Assist-Abo abschließen wird geöffnet.

3. Wählen Sie unter Select Gemini Code Assist subscription Edition (Gemini Code Assist-Aboversion auswählen) eine Gemini Code Assist-Version aus. Wählen Sie Gemini Code Assist-Versionen vergleichen aus, um eine detaillierte Liste der Funktionen zu sehen, die für jede Version verfügbar sind.

   Wähle dann Weiter aus.

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

   • Aboname.
   • Anzahl der Lizenzen im Abo. Wenn Sie die Enterprise-Version erwerben, müssen Sie mindestens 10 Lizenzen kaufen.
   • Abozeitraum (monatlich oder jährlich) Bei einem Jahresabo erhältst du einen Rabatt, der monatlich abgerechnet wird, anstatt einer einmaligen Zahlung.

5. Wählen Sie Weiter aus, um das Abo zu bestätigen.

6. Wenn Sie den Bedingungen zustimmen, wählen Sie Ich stimme den Kaufbedingungen zu und dann Abo bestätigen aus.

7. Wählen Sie Weiter: Gemini-Lizenzzuweisungen verwalten aus.

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

Lizenzen zuweisen

Vor der Nutzung von Gemini Code Assist muss jedem einzelnen Nutzer, der Zugriff in der Organisation erhalten soll, eine Lizenz zugewiesen werden.

Bei neuen Gemini Code Assist-Kunden mit Rechnungskonten, die noch nie ein Gemini Code Assist-Abo hatten, wenden wir im ersten Monat automatisch Guthaben an, das bis zu 50 kostenlosen Lizenzen entspricht, unabhängig von der Gemini Code Assist-Version. Nachdem die ursprünglichen kostenlosen Lizenz-Guthaben zugewiesen wurden, können Sie die Anzahl der kostenlosen Guthaben nicht mehr erhöhen. Außerdem können Sie die Gemini Code Assist-Version im ersten Monat nicht ändern.

Console

Wenn Sie einzelnen Nutzern in der API Console Gemini-Lizenzen zuweisen möchten, benötigen Sie die folgenden Berechtigungen für das Abrechnungskonto:

• billing.accounts.get
• billing.accounts.list
• consumerprocurement.orders.get
• consumerprocurement.orders.list
• consumerprocurement.orders.modify
• consumerprocurement.orders.place
• consumerprocurement.licensePools.enumerateLicensedUsers
• consumerprocurement.licensePools.get
• consumerprocurement.licensePools.update
• consumerprocurement.licensePools.assign
• consumerprocurement.licensePools.unassign

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

   Zu Gemini für Google Cloud

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

3. Klicken Sie auf Lizenzen zuweisen. Ein Dialogfeld zur Auswahl von Nutzern 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

Verwenden Sie die Methode billingAccounts.orders.licensePool.assign, um Gemini-Lizenzen mit der API zuzuweisen.

1. Sie benötigen die IAM-Berechtigung (Identity and Access Management) consumerprocurement.licensePools.assign für das Rechnungskonto, das den Lizenzpool enthält, dessen Lizenz Sie zuweisen möchten.

2. Erstellen Sie eine JSON-Datei, die folgende Informationen enthält:

   {
     "usernames": [
       USER_EMAILS
     ]
   }
   

   Dabei ist USER_EMAILS eine durch Kommas getrennte Liste von Nutzerkonten, denen die Lizenz zugewiesen wird. Beispiel: "[e-mail]", "[e-mail]"

3. Verwenden Sie cURL, um die Methode aufzurufen:

   curl -X POST --data-binary @JSON_FILE_NAME \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "X-Goog-User-Project: PROJECT_ID" \
     -H "Content-Type: application/json" \
     "https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/"

   Ersetzen Sie Folgendes:

   • JSON_FILE_NAME: der Pfad für die JSON-Datei, die Sie in Schritt 2 erstellt haben.
   • PROJECT_ID: die ID für ein Projekt. Die Kontingentnutzung und die mit der API-Anfrage verbundenen Gebühren werden auf dieses Projekt angerechnet.
   • BILLING_ACCOUNT_ID: die ID des Rechnungskontos, das dem Lizenzpool zugeordnet ist.
   • ORDER_ID: die Bestell-ID. Wenn Sie die Bestell-ID nicht kennen, können Sie sie abrufen, indem Sie die mit Ihrem Abrechnungskonto verknüpften Bestellungen auflisten.

Wenn der Vorgang erfolgreich war, sieht die Antwort in etwa so aus:

  {}

Sie müssen jetzt die Gemini for Google Cloud API in einem oder mehreren Projekten aktivieren, die mit diesem Rechnungskonto verknüpft sind. Nutzer sehen Gemini Code Assist erst, wenn Sie es in mindestens einem Projekt aktivieren.

Gemini for Google Cloud API in einem Cloud-Projekt aktivieren

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

Console

1. Wenn Sie die Gemini for Google Cloud API aktivieren möchten, rufen Sie die Seite Gemini for Google Cloud auf.

   Zu Gemini für 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 Cloud-Projekt für alle Nutzer mit den erforderlichen IAM-Rollen verfügbar.

gcloud

Zur Verwendung einer lokalen Entwicklungsumgebung müssen Sie die gcloud CLI installieren und initialisieren.

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

2. Aktivieren Sie die Gemini for Google Cloud API für Gemini mit dem gcloud services enable-Befehl:

   gcloud services enable cloudaicompanion.googleapis.com
   

   Wenn Sie die Gemini for Google Cloud API in einem anderen 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 Cloud-Projekt-ID.

   Die Ausgabe sieht 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 im angegebenen Cloud-Projekt für alle Nutzer mit den erforderlichen IAM-Rollen verfügbar.

Firewall für API-Traffic zwischen Ihrer IDE und Google konfigurieren

Zusätzlich zur Aktivierung von Gemini for Google Cloud müssen Nutzer hinter Firewalls auch Traffic für die folgenden APIs zulassen:

• oauth2.googleapis.com: Wird verwendet, um sich in Google Cloud anzumelden.
• serviceusage.googleapis.com: Wird verwendet, um zu prüfen, ob das Gemini Code Assist-Projekt des Nutzers richtig konfiguriert ist.
• cloudaicompanion.googleapis.com: Der primäre Gemini für Google Cloud API-Endpunkt.
• cloudcode-pa.googleapis.com: Eine interne API, die IDE-bezogene Funktionen bietet.
• cloudresourcemanager.googleapis.com: Wird in den IDEs für die Projektauswahl verwendet. Die Resource Manager API ist möglicherweise nicht erforderlich, wenn die Projekte explizit in Ihrer Datei settings.json konfiguriert sind.
• people.googleapis.com: Bietet Zugriff auf Informationen zu Profilen und Kontakten.
• firebaselogging-pa.googleapis.com: Eine interne API, die zum Senden von Produkttelemetriedaten verwendet wird, einschließlich Ereignissen dazu, ob Vorschläge akzeptiert wurden.
• feedback-pa.googleapis.com: Eine interne API, die zum Senden von Feedback in der IDE verwendet wird.
• apihub.googleapis.com: Wird von der Cloud Code API Browser-Funktion verwendet.
• lh3.googleusercontent.com und lh5.googleusercontent.com: werden verwendet, um Nutzerfotos abzurufen.

IP-Adressen für Google Cloud-Standarddomains ermitteln

Damit Ihre IDE eine Verbindung zu Google Cloud-APIs herstellen kann, muss Ihre Firewall ausgehenden TCP-Traffic zu den öffentlich dokumentierten IP-Adressbereichen von Google zulassen. Diese Bereiche werden dynamisch von Google verwaltet.

Sie haben mehrere Möglichkeiten, eine Liste von IP-Bereichen für den Zugriff auf Google Cloud-Domains zu führen:

• Verwenden Sie unsere veröffentlichten Listen oder automatisieren Sie ein Script, um Google-IP-Adressbereiche abzurufen.
• Verwenden Sie die virtuelle IP-Adresse private.googleapis.com.
• Verwenden Sie Private Service Connect.

Optional: VPC Service Controls konfigurieren

Wenn Ihre Organisation einen Dienstperimeter hat, müssen Sie die folgenden Ressourcen dem Perimeter hinzufügen:

• Gemini for Google Cloud API
• Gemini Code Assist API

Wenn Sie Gemini Code Assist Standard oder Enterprise außerhalb Ihres Dienstperimeters verwenden, müssen Sie auch die Ingress-Richtlinie ändern, um den Zugriff auf diese Dienste zu ermöglichen.

Weitere Informationen finden Sie unter VPC Service Controls für Gemini konfigurieren.

IAM-Rollen in einem Google Cloud-Projekt zuweisen

In diesem Abschnitt wird beschrieben, wie Sie Nutzern die IAM-Rollen „Gemini for Google Cloud User“ und „Service Usage Consumer“ zuweisen.

Console

1. Wenn Sie die für die Verwendung von Gemini erforderlichen IAM-Rollen gewähren möchten, rufen Sie die Seite IAM & Verwaltung auf.

   IAM & Verwaltung aufrufen

2. Suchen Sie in der Spalte Hauptkonto das 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 for Google Cloud User aus.

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

6. Klicken Sie auf Speichern.

gcloud

Zur Verwendung einer lokalen Entwicklungsumgebung müssen Sie die gcloud CLI installieren und initialisieren.

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

2. 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 Folgendes:

   • PROJECT_ID: die ID Ihres Cloud-Projekts,z. B. 1234567890.
   • PRINCIPAL: die Kennung für das Prinzipal, z. B. user:[e-mail].

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

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

3. Wiederholen Sie den vorherigen Schritt für die Rolle roles/serviceusage.serviceUsageConsumer.

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

Alle Nutzer, denen diese Rollen zugewiesen wurden, können in der API Console des angegebenen Projekts auf Gemini for Google Cloud-Funktionen zugreifen. Weitere Informationen finden Sie unter Gemini für Google Cloud – Übersicht.

Gemini Code Assist-Plug-in installieren

Die Nutzer Ihrer Organisation installieren das Gemini Code Assist-Plug‑in in ihrer bevorzugten unterstützten IDE.

VS Code

1. Klicken Sie in VS Code auf Erweiterungen oder drücken Sie Ctrl/Cmd+Shift+X, um die Ansicht Erweiterungen zu öffnen.

2. Suchen Sie nach Gemini Code Assist.

3. Klicken Sie auf Installieren.

4. Starten Sie VS Code neu, wenn Sie dazu aufgefordert werden.

   Nach erfolgreicher Installation der Erweiterung wird Gemini Code Assist in der Aktivitätsleiste angezeigt und kann verwendet werden. Wenn Sie Ihre Gemini Code Assist-Installation weiter konfigurieren möchten, können Sie Ihre Einstellungen über die Anwendungstaskleiste auf oberster Ebene festlegen: Rufen Sie Code > Einstellungen > Einstellungen > Erweiterungen auf und suchen Sie nach Gemini Code Assist.

IntelliJ

1. Klicken Sie auf settings IDE- und Projekteinstellungen > Plug-ins.
2. Suchen Sie auf dem Tab Marketplace nach Gemini Code Assist.
3. Klicken Sie auf Installieren, um das Plug-in zu installieren.
4. Klicken Sie nach Abschluss der Installation auf IDE neu starten.

5. Wenn die IDE neu gestartet wird, wird Gemini Code Assist in der Aktivitätsleiste angezeigt.

   

Die Nutzer können jetzt Gemini Code Assist Standard oder Enterprise in ihrer IDE verwenden. Weitere Informationen zu den unterstützten Funktionen:

• Übersicht über Code-Funktionen
• Chatfunktionen

Die folgenden Anleitungen erleichtern Ihnen den Einstieg:

• Mit Gemini Code Assist programmieren
• Mit Gemini Code Assist chatten

Liste der Verzeichnisse, in denen Gemini Code Assist Informationen im Cache speichert

In der folgenden Tabelle finden Sie eine Liste der Verzeichnisse, in denen Gemini Code Assist Erweiterungsinformationen wie Authentifizierungstokens speichert:

Windows

• %LOCALAPPDATA%/cloud-code
• %LOCALAPPDATA%/google-vscode-extension

macOS

• ~/Library/Application Support/cloud-code
• ~/Library/Application Support/google-vscode-extension

Linux

• ~/.cache/cloud-code
• ~/.cache/google-vscode-extension

Bei Google anmelden und ein Google Cloud-Projekt auswählen

Nachdem Nutzer Gemini Code Assist in ihren IDEs installiert haben, müssen sie sich in ihren Google-Konten anmelden. Wenn sie Gemini Code Assist Standard oder Enterprise zum ersten Mal in ihrer IDE verwenden, müssen sie ein Google Cloud-Projekt auswählen.

VS Code

Wenn Sie ein Google Cloud-Projekt ohne aktivierte Gemini for Google Cloud API auswählen, erhalten Sie eine Benachrichtigung mit der Option, die API über die IDE zu aktivieren. Wählen Sie im Benachrichtigungsfenster API aktivieren aus, um die API für Ihr Projekt zu aktivieren. Weitere Informationen finden Sie unter Gemini Code Assist Standard und Enterprise für ein Projekt einrichten.

Wenn Sie die Anleitung zum Programmieren mit Gemini Code Assist lieber direkt in Ihrer IDE durchgehen möchten, klicken Sie auf VS Code starten und folgen Sie der Anleitung, um eine Verbindung zu Google Cloud herzustellen und Gemini Code Assist Standard oder Enterprise zu aktivieren.

VS Code starten

Andernfalls können Sie so vorgehen:

1. Starten Sie Ihre IDE.

2. Klicken Sie in der Aktivitätsleiste auf Gemini Code Assist.

3. Klicken Sie im Chatfenster von Gemini Code Assist auf Bei Google Cloud anmelden.

4. Wenn Sie aufgefordert werden, Gemini Code Assist das Öffnen der externen Website zu erlauben, klicken Sie auf Öffnen.

5. Folge der Anleitung, um dich in deinem Google-Konto anzumelden.

6. Wenn Sie gefragt werden, ob Sie Gemini Code Assist von Google heruntergeladen haben, klicken Sie auf Anmelden.

   Hinweis :Wenn bei Ihren Anmeldeversuchen immer wieder ein Zeitüberschreitungsfehler auftritt, finden Sie im bekannten Problem Bei Anmeldeversuchen tritt immer wieder ein Zeitüberschreitungsfehler auf weitere Informationen zur Fehlerbehebung.

   Sie sind jetzt mit Google Cloud verbunden.

   So wählen Sie ein Google Cloud-Projekt aus, für das die Gemini für Google Cloud API aktiviert ist:

7. Klicken Sie in der Statusleiste von Gemini Code Assist auf Gemini Code Assist.

   

8. Wählen Sie im Menü Gemini Code Assist die Option Gemini Code-Projekt auswählen aus.

9. Wählen Sie ein Google Cloud-Projekt aus, für das die Gemini for Google Cloud API aktiviert ist.

   Gemini Code Assist Standard oder Enterprise ist einsatzbereit.

   

IntelliJ

So melden Sie sich in Ihrem Google-Konto an:

1. Klicken Sie in der Aktivitätsleiste auf spark Gemini Code Assist.

2. Klicken Sie auf Bei Google anmelden.

3. Wählen Sie auf der Seite, die im Webbrowser geöffnet wird, Ihr Google-Konto aus.

4. Klicken Sie auf dem Bildschirm, auf dem Sie aufgefordert werden, zu bestätigen, dass Sie diese App von Google heruntergeladen haben, auf Anmelden.

   Gemini Code Assist ist jetzt für den Zugriff auf Ihr Konto autorisiert.

   Wenn Sie Gemini Code Assist Standard oder Enterprise zum ersten Mal in Ihrer IDE verwenden, müssen Sie als Nächstes ein Google Cloud-Projekt auswählen. Gehen Sie dazu so vor:

5. Kehren Sie zu Ihrer IDE zurück. Wenn Sie im Fenster des Gemini Code Assist-Tools damit einverstanden sind, dass Google die zur Verwendung von Gemini Code Assist erforderlichen APIs in Ihrem Namen für das ausgewählte Projekt aktiviert, klicken Sie auf GCP-Projekt auswählen, um fortzufahren.

6. Suchen Sie im Dialogfeld Google Cloud-Projekt auswählen nach Ihrem Google Cloud-Projekt und wählen Sie es aus. Klicken Sie dann auf OK.

7. Klicken Sie auf FERTIGSTELLEN.

Ihr Google Cloud-Projekt ist ausgewählt und die Gemini Code Assist API ist aktiviert. Sie können jetzt Gemini Code Assist Standard oder Enterprise in Ihrer IDE verwenden.

Erweiterte Einrichtungsaufgaben

Anstatt die API Console oder gcloud zum Zuweisen vordefinierter IAM-Rollen zu verwenden, haben Sie folgende Möglichkeiten:

• Verwenden Sie die IAM REST APIs oder IAM-Clientbibliotheken, um Rollen zuzuweisen.

  Wenn Sie diese Schnittstellen verwenden, müssen Sie die vollqualifizierten Rollennamen angeben:

  • 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 zuweisen.

  Für alle benutzerdefinierten Rollen, die Sie erstellen, benötigen Sie die folgenden Berechtigungen, um auf Gemini Code Assist Standard und Enterprise zuzugreifen:

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

• Lizenzen zuweisen und verwalten

  Für alle benutzerdefinierten Rollen, die Sie erstellen, sind die folgenden Berechtigungen erforderlich, damit Sie Gemini Code Assist-Lizenzen zuweisen und verwalten 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

Damit eine der oben genannten Berechtigungen funktioniert, muss die Gemini for Google Cloud API im selben Google Cloud-Projekt aktiviert sein, in dem Sie die jeweilige Berechtigung zugewiesen haben.

Nächste Schritte

• Weitere Informationen zu den Arten von generativer KI-Unterstützung, die in Gemini für Google Cloud verfügbar sind
• Weitere Informationen dazu, wie Gemini for Google Cloud Ihre Daten verwendet
• Informationen zum Zugriff auf und zur Verwaltung von Gemini Code Assist Standard- und Enterprise-Administratorsteuerungen
• Informationen zum Konfigurieren der Codeanpassung für Gemini Code Assist Enterprise
• VPC Service Controls für Gemini Code Assist Standard und Enterprise konfigurieren