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): 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.

  • Web Grounding for Enterprise: Es wird eine eingeschränkte Teilmenge von Webinhalten verwendet. 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 beschrieben.

Hinweis

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

  2. 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.instance.queryEffectiveSetting
    • cloudaicompanion.instance.queryEffectiveSettingBindings
    • cloudaicompanion.geminiGcpEnablementSettings.get
    • cloudaicompanion.settingBindings.geminiGcpEnablementSettingsGet
    • 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. Rufen Sie in der Google Cloud -Konsole Gemini Cloud Assist auf und klicken Sie dann auf Einstellungen.

    Einstellungen aufrufen

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

  3. Klicken Sie auf Speichern.

API

Wenn Sie die Fundierung für Gemini Cloud Assist über die 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 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 ausgeführt wurde, 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/<var>CONTAINER_PROJECT</var>/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/<var>TARGET_PROJECT</var>/locations/global/geminiGcpEnablementSettings/<var>GROUNDING_SETTING_ID</var>/settingBindings/<var>GROUNDING_BINDING_ID</var>",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Nächste Schritte