Gemini Code Assist einrichten

Hinweis: Gemini Code Assist kann bis zum 11. Juli 2024 kostenlos getestet werden und ist auf einen Nutzer pro Rechnungskonto beschränkt. Organisationen können hier eine Lizenz erwerben.

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

1. Optional: Kaufen Sie ein Abo für Gemini Code Assist. Gemini Code Assist kann bis zum 11. Juli 2024 kostenlos getestet werden und ist auf einen Nutzer pro Rechnungskonto beschränkt.

2. Aktivieren Sie die Cloud AI Companion API in einem Google Cloud-Projekt. In der Regel führt ein Administrator diesen Schritt aus.

3. IAM-Rollen (Identity and Access Management) in einem Google Cloud-Projekt zuweisen In der Regel führt ein Administrator diesen Schritt aus.

4. Optional: Installieren Sie das Cloud Code-Plug-in, um Gemini Code Assist in einer IDE zu verwenden.

Optional: Gemini Code Assist-Abo kaufen

Gemini Code Assist kann bis zum 11. Juli 2024 ohne Abo kostenlos getestet werden und ist auf einen Nutzer pro Rechnungskonto beschränkt. 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 erwerben.

Hinweis: Sie benötigen die IAM-Berechtigung billing.subscriptions.create (Identity and Access Management), um ein Gemini-Abo zu erwerben. Die Berechtigung billing.subscriptions.create ist in der IAM-Rolle roles/billing.admin enthalten. Sie können die Berechtigung auch einer benutzerdefinierten Rolle hinzufügen.

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

   Zu Gemini für Google Cloud

   Die Seite Gemini für Google Cloud wird geöffnet.

2. Wählen Sie Gemini Code Assist aus.

   Der Bereich Gemini Code Assist wird angezeigt.

3. Klicken Sie auf Gemini-Codeassistent abrufen.

4. Wenn Sie dazu aufgefordert werden, wählen Sie ein Rechnungskonto aus und klicken Sie dann auf Weiter zur Seite „Admin für Gemini“.

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

5. Füllen Sie unter Abo konfigurieren die Felder aus, um das Abo zu konfigurieren, einschließlich der Zusicherungsdauer (monatlich oder jährlich) und der Anzahl der Lizenzen im Abo.

   Hinweis: Für ein Jahresabo wird jeden Monat der ermäßigte Jahrespreis berechnet, nicht als einmalige Zahlung.

   Wählen Sie aus, ob Sie Ihr Abo nach Ablauf der Laufzeit (monatlich oder jährlich) automatisch verlängern möchten. Durch die automatische Verlängerung bleiben Ihr Abo und Ihre Lizenzen aktiv. Wenn das Abo nicht automatisch verlängert wird, endet es zum Ende der aktuellen Laufzeit und Sie müssen den Kaufvorgang noch einmal durchlaufen, um die Lizenzen wiederherzustellen.

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

7. Wenn Sie den Bedingungen zustimmen, klicken Sie auf Kauf abschließen und bestätigen Sie Ihr Abo.

Die Abrechnung ist jetzt für Gemini aktiviert. Sie müssen jetzt die Cloud AI Companion API in einem oder mehreren Projekten aktivieren, die mit diesem Rechnungskonto verknüpft sind. Nutzer sehen Gemini erst, wenn Sie es in mindestens einem Projekt aktiviert haben.

Cloud AI Companion API in einem Google Cloud-Projekt aktivieren

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

Console

1. Rufen Sie die Seite Gemini für Google Cloud auf, um die Cloud AI Companion API zu aktivieren.

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

gcloud

1. Aktivieren Sie Cloud Shell in der Google Cloud Console.

   Cloud Shell aktivieren

2. Wählen Sie im Projektauswahlmenü ein Projekt aus.

3. Aktivieren Sie die Cloud AI Companion API für Gemini mit dem Befehl gcloud services enable:

   gcloud services enable cloudaicompanion.googleapis.com
   

   Wenn Sie die Cloud AI Companion 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 im angegebenen Google Cloud-Projekt für alle Nutzer mit den erforderlichen IAM-Rollen verfügbar.

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

In diesem Abschnitt werden die Schritte beschrieben, die erforderlich sind, um Nutzern die IAM-Rollen „Cloud AI Companion User“ und „Service Usage Viewer“ zu gewähren.

Console

1. Rufen Sie die Seite IAM & Verwaltung auf, um die IAM-Rollen zu gewähren, die für die Verwendung von Gemini erforderlich sind.

   IAM & Verwaltung aufrufen

2. Suchen Sie in der Spalte Hauptkonto ein Hauptkonto, für das Sie den Zugriff auf Gemini aktivieren 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 Cloud AI Companion User aus.

5. Klicken Sie auf Weitere Rolle hinzufügen und wählen Sie Service Usage-Betrachter aus.

6. Klicken Sie auf Speichern.

gcloud

1. Aktivieren Sie Cloud Shell in der Google Cloud Console.

   Cloud Shell aktivieren

2. Wählen Sie im Projektauswahlmenü ein Projekt aus.

3. Gewähren Sie die Rolle „Cloud AI Companion User“:

   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:[e-mail], group:[e-mail], serviceAccount:[e-mail] oder domain:example.domain.com.

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

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

4. Gewähren Sie die Rolle „Service Usage-Betrachter“:

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

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

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

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

Alle Nutzer, denen diese Rollen gewährt wurden, können innerhalb des angegebenen Projekts in der Google Cloud Console auf Gemini für Google Cloud-Features zugreifen. Weitere Informationen finden Sie in der Übersicht zu Gemini für Google Cloud.

Optional: Gemini-Codeassistent in einer IDE verwenden

Wenn Sie Entwickler sind und Gemini in Ihrer IDE verwenden möchten, müssen Sie das Cloud Code-Plug-in installieren. Hier finden Sie weitere Informationen:

• Cloud Workstations: Code mit Gemini Code Assist
• Cloud Shell-Editor: Code mit Gemini Code Assist
• Cloud Code for VS Code: Code mit Gemini Code Assist
• Cloud Code for IntelliJ und andere JetBrains-IDEs: Code with Gemini Code Assist

Erweiterte Einrichtungsaufgaben

Anstatt die Google Cloud Console oder die gcloud CLI zu verwenden, um vordefinierte IAM-Rollen zu gewähren, können Sie einen der folgenden Schritte ausführen:

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

  Wenn Sie diese Benutzeroberflächen verwenden, verwenden Sie die voll qualifizierten Rollennamen:

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

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

• Benutzerdefinierte Rollen erstellen und gewähren

  Alle von Ihnen erstellten benutzerdefinierten Rollen benötigen die folgenden Berechtigungen für den Zugriff auf Gemini:

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

Nächste Schritte

• Weitere Informationen zu den Arten der Unterstützung mit generativer KI, die in Gemini für Google Cloud verfügbar sind
• So verwendet Gemini for Google Cloud Ihre Daten.
• Informationen zum Zugreifen auf und Verwalten der Gemini-Administratoreinstellungen