Fundierung für Gemini Cloud Assist konfigurieren

In diesem Dokument wird beschrieben, wie Sie die Fundierung für Gemini Cloud Assist über die Google Cloud Console oder eine API konfigurieren. Die Fundierung wird von Vertex AI bereitgestellt.

Verfügbare Fundierungstypen:

• Fundierung mit der Google Suche (empfohlen): Gemini Cloud Assist wird angewiesen, die Google Suche für die umfassendsten und aktuellsten Antworten zu verwenden. Bestimmte Angebote wie Datenstandort, Access Transparency und vom Kunden verwaltete Verschlüsselungsschlüssel (Customer-Managed Encryption Keys, CMEK) werden bei dieser Option nicht unterstützt.

• Webfundierung für Unternehmen: Nutzt eine eingeschränkte Teilmenge von Webinhalten. Dies kann zwar zu Antworten von geringerer Qualität im Vergleich zur Fundierung mit der Google Suche führen, ist aber die bevorzugte Option für stark regulierte Branchen, die eine strenge Compliance in Bezug auf den Datenstandort erfordern, z. B. das Finanz- und Gesundheitswesen sowie der öffentliche Sektor.

Standardmäßig verwendet Gemini Cloud Assist die Fundierung mit der Google Suche, um die Qualität der Antworten auf Ihre Prompts zu verbessern. Die Verwendung der Fundierung mit der Google Suche erfordert eine spezielle Datenverarbeitung für Ihre Prompts und Antworten, wie in den Google Cloud Nutzungsbedingungen beschrieben.

Hinweis

1. Prüfen Sie, ob Ihr Google Cloud Projekt mit einem Rechnungskonto verknüpft ist.

2. Prüfen Sie, ob Gemini Cloud Assist für Ihr Google Cloud Projekt eingerichtet ist.

3. Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Gemini for Google Cloud Settings Admin (roles/cloudaicompanion.settingsAdmin) für Ihr Projekt zu erteilen, um die erforderlichen Berechtigungen zum Konfigurieren der Fundierung für Gemini Cloud Assist zu erhalten. Diese vordefinierte Rolle enthält die Berechtigungen, die zum Verwalten der Administratoreinstellungen für Gemini Cloud Assist erforderlich sind.

   Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

   Erforderliche Berechtigungen

   • cloudaicompanion.geminiGcpEnablementSettings.create
   • cloudaicompanion.geminiGcpEnablementSettings.update
   • cloudaicompanion.settingBindings.geminiGcpEnablementSettingsCreate
   • cloudaicompanion.settingBindings.geminiGcpEnablementSettingsUse
     • Wenn Sie direkte API-Anfragen verwenden, ist diese Berechtigung erforderlich speziell für die TARGET_PROJECT.

   Die folgenden zusätzlichen Berechtigungen sind erforderlich, wenn Sie die Console verwenden: Google Cloud

   • cloudaicompanion.instances.queryEffectiveSetting
   • cloudaicompanion.instances.queryEffectiveSettingBindings
   • cloudaicompanion.geminiGcpEnablementSettings.get
   • cloudaicompanion.settingBindings.geminiGcpEnablementSettingsGet
   • cloudaicompanion.settingBindings.geminiGcpEnablementSettingsUpdate

Möglicherweise erhalten Sie diese Berechtigungen im Rahmen anderer vordefinierter Rollen oder benutzerdefinierter Rollen.

Fundierung für Gemini Cloud Assist konfigurieren

Wählen Sie eine der folgenden Optionen aus:

Console

1. Öffnen Sie die Google Cloud Console.

   Zur Google Cloud Console

2. Klicken Sie auf einer beliebigen Seite der Google Cloud Console auf spark Gemini Cloud Assist-Chat öffnen oder schließen.

   Der Bereich Cloud Assist wird geöffnet.

3. Klicken Sie auf Weitere Aktionen (), und dann im Drop-down-Menü auf Cloud Assist-Einstellungen.

   Der Bereich Gemini Cloud Assist verwalten wird geöffnet.

4. Wählen Sie die gewünschte Fundierungsoption aus.

5. Klicken Sie auf Speichern.

API

Wenn Sie die Fundierung für Gemini Cloud Assist mit der API konfigurieren möchten, erstellen Sie eine geminiGcpEnablementSettings-Ressource, die den Fundierungstyp definiert. Verwenden Sie dazu die geminiGcpEnablementSettings.create -Methode. Anschließend wenden Sie die Einstellung mit der zugehörigen settingBindings.create Methode an, um die Einstellung an ein Projekt zu binden.

1. Erstellen Sie die Einstellung und einen einstellungsspezifischen Wert:

   1. Rufen Sie einen Authentifizierungstoken ab:

      TOKEN=$(gcloud auth print-access-token)
      

      Weitere Informationen zur Authentifizierung finden Sie unter Für die Verwendung von REST authentifizieren.

   2. Führen Sie den folgenden Befehl aus, um die Einstellung zu erstellen:

      curl -X POST \
        -H "Authorization: Bearer $TOKEN" \
        -H 'Content-Type: application/json' \
        -d '{
          "webGroundingType": "GROUNDING_TYPE"
          }' \
        "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT/locations/global/geminiGcpEnablementSettings?geminiGcpEnablementSettingId=GROUNDING_SETTING_ID"
      

      Ersetzen Sie Folgendes:

      • CONTAINER_PROJECT: Die Projekt-ID des Projekts, in dem die Einstellungsdaten gespeichert sind.
      • GROUNDING_TYPE: Der Fundierungstyp, entweder GROUNDING_WITH_GOOGLE_SEARCH oder WEB_GROUNDING_FOR_ENTERPRISE.
      • GROUNDING_SETTING_ID: Ein eindeutiger Name zur Identifizierung dieser bestimmten Einstellungsdaten, z. B. gt1.

      Wenn der Befehl erfolgreich ist, wird ein Antworttext zurückgegeben, in dem webGroundingType auf Ihre Auswahl festgelegt ist:

      {
        "name": "projects/CONTAINER_PROJECT/locations/global/geminiGcpEnablementSettings/GROUNDING_SETTING_ID",
        "createTime": "2025-01-23T15:22:49.717166932Z",
        "updateTime": "2025-01-23T15:22:49.717166932Z",
        "webGroundingType": "GROUNDING_TYPE"
      }
      

2. Erstellen Sie die Bindung für die Einstellung:

     curl -X POST \
       -H "Authorization: Bearer $TOKEN" \
       -H 'Content-Type: application/json' \
       -d '{
         "target": "projects/TARGET_PROJECT",
         "product": "GEMINI_CLOUD_ASSIST"
         }' \
       "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT/locations/global/geminiGcpEnablementSettings/GROUNDING_SETTING_ID/settingBindings?settingBindingId=GROUNDING_BINDING_ID"
   

   Ersetzen Sie Folgendes:

   • TARGET_PROJECT: Die Projekt-ID des Projekts, auf das die Einstellung angewendet werden soll. In der Regel sind das Zielprojekt und das Containerprojekt identisch.
   • CONTAINER_PROJECT: Die Projekt-ID des Projekts, in dem die Einstellungsdaten gespeichert sind.
   • GROUNDING_SETTING_ID: Die GROUNDING_SETTING_ID, die Sie beim Erstellen der Einstellung angegeben haben.
   • GROUNDING_BINDING_ID: Eine eindeutige ID zur Identifizierung dieser bestimmten Einstellungsbindungsressource, z. B. b1.

   Wenn der Befehl erfolgreich ist, werden die Metadaten des Vorgangs im folgenden Format zurückgegeben:

   {
     "name": "projects/CONTAINER_PROJECT/locations/global/operations/operation-1737646069712-62c6140bb04bb-49261230-43701daf",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.cloudaicompanion.v1.OperationMetadata",
       "createTime": "2025-01-23T15:27:50.076075570Z",
       "target": "projects/TARGET_PROJECT/locations/global/geminiGcpEnablementSettings/GROUNDING_SETTING_ID/settingBindings/GROUNDING_BINDING_ID",
       "verb": "create",
       "requestedCancellation": false,
       "apiVersion": "v1"
     },
     "done": false
   }
   

Nächste Schritte

• Weitere Administratoreinstellungen für Gemini Cloud Assist ansehen.