Fundierung für Gemini Cloud Assist konfigurieren

Mit Fundierung können Sie Gemini Cloud Assist über Vertex AI mit externen Webquellen verbinden und so genauere und aktuellere Antworten erhalten. In diesem Dokument wird beschrieben, wie Sie die Fundierung in der Google Cloud Console oder mit einer API konfigurieren.

Verfügbare Fundierungstypen:

• Fundierung mit der Google Suche (empfohlen): Weist Gemini Cloud Assist an, die Google Suche für die umfassendsten und aktuellsten Antworten zu verwenden. Bestimmte Angebote wie Datenstandort, Access Transparency und kundenverwaltete 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 führen als die Fundierung mit der Google Suche, ist aber die bevorzugte Option für stark regulierte Branchen, die strenge Anforderungen an den Datenspeicherort erfüllen müssen, 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 für den Dienst 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 zuzuweisen, um die erforderlichen Berechtigungen zum Konfigurieren von Grounding 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 speziell für TARGET_PROJECT erforderlich.

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

   • 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 Cloud Assist-Bereich wird geöffnet.

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

   Der Einstellungsbereich 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 mit der Methode geminiGcpEnablementSettings.create eine geminiGcpEnablementSettings-Ressource, die den Fundierungstyp definiert. Anschließend wenden Sie die Einstellung mit der zugehörigen Methode settingBindings.create 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 Typ der Fundierung, 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 gesetzt 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 Ressource für die Einstellung, 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