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:

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

  2. Weisen Sie Nutzern in Ihrer Organisation Lizenzen zu.

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

  4. Weisen Sie IAM-Rollen (Identity and Access Management) in einem Projekt in Google Cloud zu.

  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 Nutzer von Gemini CLI oder von Gemini in Android Studio 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, gewähren wir unabhängig von der Gemini Code Assist-Version automatisch ein Guthaben im Wert von bis zu 50 kostenlosen Lizenzen für den ersten Monat. Nachdem die ursprünglichen Guthaben für kostenlose Lizenzen 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 Cloudhaben, wenden Sie sich an unser Vertriebsteam, bevor Sie ein Abo abschließen.

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

    Zu Administrator für Gemini

    Die Seite Administrator für Gemini wird geöffnet.

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

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

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

  3. Wählen Sie unter 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 verfügbaren Funktionen in jeder Version zu sehen.

    Wählen Sie 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.
    • Abolaufzeit (monatlich oder jährlich). Bei einem Jahresabo erhalten Sie einen rabattierten Preis, der monatlich in Rechnung gestellt wird. Es handelt sich also nicht um eine einmalige Zahlung.

    Neue Abos sind standardmäßig auf automatische Lizenzzuweisung eingerichtet. Nutzer in Ihrer Organisation erhalten automatisch eine Lizenz, wenn sie Gemini Code Assist in einer unterstützten IDE verwenden und alle folgenden Bedingungen erfüllt sind:

    • Der Nutzer hat ein Projekt ausgewählt, das mit dem Rechnungskonto des Abos verknüpft ist.
    • Der Nutzer hat die IAM-Berechtigung cloudaicompanion.licences.selfAssign für das ausgewählte Projekt.

    Nachdem Sie Gemini Code Assist eingerichtet haben, können Sie Lizenzen manuell zuweisen.

  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 Nächster Schritt: Gemini-Lizenzzuweisungen verwalten aus.

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

Lizenzen zuweisen

Damit Nutzer eine Gemini Code Assist-Lizenz verwenden können, muss ihnen für ein Projekt, in dem die API bereits aktiviert ist, die Rolle „Gemini for Google Cloud User“ oder eine entsprechende Berechtigung zugewiesen sein.

Bei neuen Gemini Code Assist-Kunden mit Rechnungskonten, die noch nie ein Gemini Code Assist-Abo hatten, gewähren wir unabhängig von der Gemini Code Assist-Version automatisch ein Guthaben im Wert von bis zu 50 kostenlosen Lizenzen für den ersten Monat. Nachdem die ursprünglichen Guthaben für kostenlose Lizenzen 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.

Neue Abos sind standardmäßig auf automatische Lizenzzuweisung eingerichtet. Nutzer in Ihrer Organisation erhalten automatisch eine Lizenz, wenn sie Gemini Code Assist in einer unterstützten IDE verwenden und alle folgenden Bedingungen erfüllt sind:

  • Der Nutzer hat ein Projekt ausgewählt, das mit dem Rechnungskonto des Abos verknüpft ist.
  • Der Nutzer hat die IAM-Berechtigung cloudaicompanion.licences.selfAssign für das ausgewählte Projekt.

Lizenzen, die 30 Tage lang inaktiv sind, werden automatisch einem anderen Nutzer in Ihrer Organisation zugewiesen, der die oben genannten Bedingungen erfüllt.

Wenn alle verfügbaren Lizenzen im Abo zugewiesen sind, erhalten Nutzer, die ohne Lizenz auf Gemini Code Assist zugreifen möchten, eine Fehlermeldung, dass eine Lizenz erforderlich ist.

Nachdem Sie Gemini Code Assist eingerichtet haben, können Sie die Lizenzzuweisungen aufrufen, indem Sie die Seite Administrator für Gemini aufrufen, Ihr Rechnungskonto auswählen, auf Gemini Code Assist-Abo verwalten klicken und dann den Tab Lizenzverwaltung auswählen. Wenn Sie die Lizenzzuweisungen genauer steuern möchten, können Sie auf diesem Tab auch von der automatischen Lizenzverwaltung zur manuellen Lizenzverwaltung wechseln.

Die Gemini for Google Cloud API muss in einem oder mehreren Projekten aktiviert sein, die mit diesem Rechnungskonto verknüpft sind. Nutzer sehen Gemini Code Assist erst, wenn die API mindestens in einem Projekt aktiviert ist.

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

In diesem Abschnitt werden die Schritte beschrieben, die zum Aktivieren der Gemini for Google Cloud API in einem Projekt in Google Cloud erforderlich sind. Gemini Code Assist benötigt ein Google Cloud -Projekt, um API-Zugriff, Kontingente und Abrechnung zu verwalten. Aktivieren Sie daher die Gemini for Google Cloud API in einem Google Cloud Projekt Ihrer Wahl. Erst dann können Nutzer auf Gemini Code Assist zugreifen.

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. Wählen Sie in der Projektauswahl ein Projekt aus.

  3. Klicken Sie auf Aktivieren.

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

gcloud CLI

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

    Activate Cloud Shell

    1. Wählen Sie in der Projektauswahl ein 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 Projekt inGoogle Cloud aktivieren möchten, fügen Sie den Parameter --project hinzu:

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

      Ersetzen Sie dabei PROJECT_ID durch die ID Ihres Projekts in Google Cloud .

      Die Ausgabe sieht 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 Projekt inGoogle Cloud 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 der Gemini for Google Cloud API müssen Nutzer hinter Firewalls auch zulassen, dass Traffic für die folgenden APIs durchgelassen wird:

  • oauth2.googleapis.com: wird verwendet, um sich in Google Cloudanzumelden.
  • 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 for 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 der 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 Produkttelemetrie 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 Standarddomains in Google Cloud bestimmen

Damit die Verbindung von Ihrer IDE zu Google Cloud APIs möglich ist, 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 Domains in Google Cloud zu führen:

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 Richtlinie für eingehenden Traffic ä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 Projekt in Google Cloud 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 IAM-Rollen zuweisen möchten, die für die Verwendung von Gemini erforderlich sind, rufen Sie die Seite IAM und Verwaltung auf.

    Zu „IAM und Verwaltung“

  2. Klicken Sie auf Zugriff gewähren und geben Sie dann den Namen des Hauptkontos ein, dem Sie Zugriff auf Gemini gewähren möchten.

  3. Klicken Sie im Bereich Zugriff gewähren auf Weitere Rolle hinzufügen.

  4. Wählen Sie unter Rollen zuweisen die Option Gemini for Google Cloud User aus.

  5. Klicken Sie auf Rollen hinzufügen und wählen Sie Service Usage Consumer aus.

  6. Klicken Sie auf Speichern.

gcloud CLI

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

    Activate Cloud Shell

    1. Wählen Sie in der Projektauswahl ein Projekt aus.

    2. Rolle „Gemini for Google Cloud User“ gewähren

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

      Ersetzen Sie Folgendes:

      • PROJECT_ID: die ID IhresGoogle Cloud -Projekts, z. B. 1234567890.
      • PRINCIPAL: die Kennung für das Hauptkonto, z. B. user:cloudysanfrancisco@gmail.com.

      Es wird eine Liste von Richtlinienbindungen ausgegeben, 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 derGoogle Cloud Console des angegebenen Projekts auf die Funktionen von Gemini for Google Cloud zugreifen. Weitere Informationen finden Sie unter Gemini for Google Cloud .

Gemini Code Assist-Plug-in installieren

Die Nutzer Ihrer Organisation installieren das Gemini Code Assist-Plug‑in in ihrer bevorzugten unterstützten IDE. Nutzer unterstützter JetBrains-IDEs sollten der IntelliJ-Anleitung folgen.

VS Code

  1. Klicken Sie in VS Code auf Erweiterungssymbol 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. Nach dem Neustart der IDE wird Gemini Code Assist in der Aktivitätsleiste angezeigt.

    Das Symbol für Gemini Code Assist wird 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 erhalten Sie unter den folgenden Links:

Die folgenden Anleitungen erleichtern Ihnen den Einstieg:

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

In Google anmelden und ein Projekt in Google Cloud auswählen

Der nächste Schritt nach der Installation von Gemini Code Assist in IDE ist die Anmeldung beim Google-Konto. Nutzer, die Gemini Code Assist Standard oder Enterprise zum ersten Mal in ihrer IDE verwenden, wählen ein Projekt in Google Cloud aus. Das ist dasselbe Projekt, das zum Einrichten von Gemini Code Assist verwendet wurde. Es dient zur Verwaltung von API-Zugriff, Kontingent und Abrechnung.

VS Code

Wenn Sie ein Projekt in Google Cloud ohne aktivierte Gemini for Google Cloud API auswählen, erhalten Sie eine Benachrichtigung, in der Sie die API über die IDE aktivieren können. Wählen Sie im Benachrichtigungsfenster API aktivieren aus, um die API für Ihr Projekt zu aktivieren.

Wenn Sie die Anleitung Mit Gemini Code Assist programmieren lieber direkt in Ihrer IDE Schritt für Schritt 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 gehen Sie so vor:

  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 In Google Cloud anmelden.

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

  5. Folgen Sie den Anweisungen, um sich in Ihrem Google-Konto anzumelden.

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

    Sie sind jetzt mit Google Cloudverbunden.

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

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

    Die Gemini-Statusleiste ist verfügbar.

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

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

    Gemini Code Assist Standard oder Enterprise kann jetzt verwendet werden.

    Das Gemini-Symbol in der Statusleiste ist auf „Normal“ eingestellt.

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 In Google anmelden. Alternativ können Sie auf Link kopieren klicken und die URL in Ihren Browser einfügen.

  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 Anwendung 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 Projekt in Google Cloudauswä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 Google Cloud-Projekt auswählen, um fortzufahren.

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

  7. Klicken Sie auf FERTIG.

Ihr Projekt in Google Cloud 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

In den folgenden Abschnitten werden erweiterte Einrichtungsaufgaben beschrieben, mit denen Sie Gemini Code Assist anpassen können.

Erweiterte IAM-Hinweise

Anstatt die Google Cloud Console oder die gcloud CLI zum Zuweisen vordefinierter IAM-Rollen zu verwenden, können Sie eine der folgenden Aktionen ausführen:

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

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

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

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

  • Erstellen Sie benutzerdefinierte Rollen und weisen Sie sie zu.

    Alle benutzerdefinierten Rollen, die Sie erstellen, benötigen die folgenden Berechtigungen, damit Sie auf Gemini Code Assist Standard und Enterprise zugreifen können:

    • 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
  • Weisen Sie Lizenzen zu und verwalten Sie sie.

    Alle benutzerdefinierten Rollen, die Sie erstellen, benötigen die folgenden Berechtigungen, 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 die oben genannten Berechtigungen funktionieren, muss die Gemini for Google Cloud API im selben Projekt in Google Cloud aktiviert sein, in dem Sie die jeweilige Berechtigung zugewiesen haben.

Release-Version des Projekts in Google Cloud ändern

Wir veröffentlichen Gemini Code Assist-Funktionen in verschiedenen Release-Versionen, entweder allgemein verfügbar oder als Vorabversion. Wenn Sie Gemini Code Assist einrichten, wird Ihr Projekt automatisch auf die Release-Version „Allgemein verfügbar“ festgelegt.

Sie können die Release-Version für Gemini Code Assist jederzeit in die Vorabversion oder zurück in die allgemein verfügbare Version ändern.

Nächste Schritte