Gemini Cloud Assist in Cloud Billing einrichten

Führen Sie die Schritte in diesem Dokument aus, um Gemini Cloud Assist in der Cloud-Abrechnung einzurichten:

  1. Aktivieren Sie die Gemini for Google Cloud API in einem Google Cloud-Projekt. Dieser Schritt wird in der Regel von einem Administrator ausgeführt.

  2. Weisen Sie im Google Cloud-Projekt IAM-Rollen (Identity and Access Management) den Nutzern zu, die auf Cloud Billing-Berichte zugreifen. Dieser Schritt wird in der Regel von einem Administrator ausgeführt.

  3. Wenn Nutzer Zugriff auf Cloud Billing-Berichte und Gemini Cloud Assist in Cloud Billing benötigen, gewähren Sie ihnen IAM-Rollen im Cloud Billing-Konto, das mit dem Projekt verknüpft ist, in dem die Gemini for Google Cloud API aktiviert ist. Dieser Schritt wird in der Regel von einem Administrator ausgeführt.

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

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

Console

  1. Rufen Sie die Seite Gemini for Google Cloud auf, um die Gemini for Google Cloud API zu aktivieren.

    Gemini for Google Cloud aufrufen

  2. Klicken Sie auf die Projektauswahl Projekt auswählen.

    Cloud Billing-Nutzern mit Berechtigungen auf Rechnungskontoebene für das Cloud-Rechnungskonto empfehlen wir, ein FinOps-Administrationsprojekt zu verwenden, das die API enthält.

  3. Klicken Sie auf Aktivieren.

    Die Seite wird aktualisiert und der Status API aktiviert wird angezeigt.

gcloud

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

    Activate Cloud Shell

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

    Cloud Billing-Nutzern mit Berechtigungen auf Rechnungskontoebene für das Cloud-Rechnungskonto empfehlen wir, ein FinOps-Administrationsprojekt zu verwenden, das die API enthält.

  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.

Nachdem Sie die Gemini for Google Cloud API im angegebenen Google Cloud-Projekt aktiviert haben, ist Gemini Cloud Assist jetzt für alle Nutzer verfügbar, die die erforderlichen IAM-Rollen für das angegebene Projekt haben.

IAM-Rollen in einem Google Cloud-Projekt zuweisen

In diesem Abschnitt wird beschrieben, wie Sie die erforderlichen Projektberechtigungen gewähren, um Gemini Cloud Assist verwenden zu können. Weisen Sie Nutzern (Hauptkonten) im Google Cloud-Projekt, in dem Sie die Gemini for Google Cloud API aktiviert haben, die folgenden IAM-Rollen zu:

  • Gemini für Google Cloud-Nutzer
  • Service Usage-Nutzer

Console

  1. Wenn Sie die IAM-Rollen gewähren möchten, die für die Verwendung von Gemini for Google Cloud erforderlich sind, rufen Sie die Seite IAM und Verwaltung auf.

    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 Gemini für Google Cloud-Nutzer aus.

  5. Klicken Sie auf Weitere Rolle hinzufügen und wählen Sie Verbraucher der Dienstnutzung 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 für 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 mit den folgenden Informationen:

    - 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 (Hauptkonten), denen diese Rollen zugewiesen wurden, können in der Google Cloud Console des angegebenen Projekts auf Gemini for Google Cloud-Funktionen zugreifen. Wenn die Projektnutzer auch Zugriff auf Cloud Billing-Berichte haben, können sie Gemini Cloud Assist in den Cloud Billing-Berichten verwenden, um mithilfe von KI Kostenberichte zu erstellen und wichtige Informationen aus den Kostenberichten zusammenzufassen. Weitere Informationen finden Sie unter Gemini Cloud Assist in Cloud Billing – Übersicht.

Erweiterte IAM-Einrichtungsaufgaben für Projekte

Anstatt vordefinierte IAM-Rollen für ein Projekt über die Google Cloud Console oder die gcloud CLI zu gewähren, haben Sie folgende Möglichkeiten:

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

    Wenn Sie diese Oberflächen verwenden, verwenden Sie die vollqualifizierten 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 von Ihnen erstellten benutzerdefinierten Rollen für Projekt-Berechtigungen benötigen die folgenden Berechtigungen für den Zugriff auf Gemini für Google Cloud:

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

IAM-Rollen in einem Cloud Billing-Konto gewähren

Nutzern, die Zugriff auf Cloud Billing-Berichte benötigen, müssen Sie Berechtigungen für das Cloud Billing-Konto erteilen, die für den Zugriff auf die Seite Berichte ausreichen. Wenn Sie Gemini Cloud Assist im Abrechnungsbericht verwenden möchten, gewähren Sie Zugriff auf das Cloud-Rechnungskonto, das mit dem Projekt verknüpft ist, in dem die Gemini for Google Cloud API aktiviert ist.

Nächste Schritte