Gemini Code Assist einrichten

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

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

  2. Aktivieren Sie die Cloud AI Companion API in einem Google Cloud-Projekt. Dieser Schritt wird normalerweise von einem Administrator ausgeführt.

  3. IAM-Rollen (Identity and Access Management) in einem Google Cloud-Projekt zuweisen Dieser Schritt wird normalerweise von einem Administrator ausgeführt.

  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. Das Tool 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 Verträge mit Google Cloud haben, wenden Sie sich an unser Vertriebsteam, bevor Sie ein Abo erwerben.

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

    Zu Gemini for 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 Code Assist nutzen.

  4. Wenn du dazu aufgefordert wirst, wähle ein Rechnungskonto aus und klicke dann auf Weiter zur Seite „Administrator 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 Laufzeit der Zusicherung (monatlich oder jährlich) und der Anzahl der Lizenzen im Abo.

    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 mit dem Ende der aktuellen Laufzeit. Sie müssen den Kaufvorgang noch einmal durchlaufen, um die Lizenzen wiederzuerlangen.

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

  7. Wenn du mit den Nutzungsbedingungen einverstanden bist, klicke auf Kauf abschließen und bestätige dein Abo.

Die Abrechnung für Gemini ist jetzt aktiviert. Sie müssen jetzt in einem oder mehreren Projekten, die mit diesem Rechnungskonto verknüpft sind, die Cloud AI Companion API aktivieren. 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 for Google Cloud

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

  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 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 Consumer“ zu gewähren.

Console

  1. Rufen Sie die Seite IAM & Verwaltung auf, um die IAM-Rollen zu gewähren, die zur 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-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. 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: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. Gewähren Sie die Rolle „Service Usage-Nutzer“:

    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, können innerhalb des angegebenen Projekts in der Google Cloud Console auf Gemini für Google Cloud-Features zugreifen. Weitere Informationen finden Sie unter Gemini für Google Cloud – Übersicht.

Optional: Gemini Code Assist in einer IDE verwenden

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

Erweiterte Einrichtungsaufgaben

Anstatt die Google Cloud Console oder die gcloud CLI zu verwenden, um vordefinierte IAM-Rollen zuzuweisen, haben Sie folgende Möglichkeiten:

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

    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

    Alle benutzerdefinierten Rollen, die Sie erstellen, benötigen die folgenden Berechtigungen für den Zugriff auf Gemini:

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

Nächste Schritte