Weitergabe von Prompts und Antworten für Gemini Cloud Assist konfigurieren

In diesem Dokument wird beschrieben, wie Sie die Weitergabe von Prompts und Antworten für Gemini Cloud Assist für ein Projekt über die Google Cloud Console oder eine API konfigurieren.

Wenn diese Option aktiviert ist, verarbeitet Google die Prompts und Antworten aller Gemini Cloud Assist-Nutzer im Projekt zum Zweck der Produktverbesserung. So kann Google Gemini Cloud Assist leistungsfähiger machen. Google speichert anonymisierte Prompts und Antworten zu diesem Projekt maximal zwei Jahre lang. Die Prompts und Antworten Ihrer Organisation werden niemals zum Trainieren oder Feinabstimmen von LLM-Modellen verwendet.

Sie können diese Einstellung jederzeit ändern.

Hinweis

Um die erforderlichen Berechtigungen zum Konfigurieren der Weitergabe von Prompts und Antworten für Gemini Cloud Assist zu erhalten, bitten Sie Ihren Administrator, Ihnen die vordefinierte IAM-Rolle **Gemini Cloud Assist Identity and Access Management** (roles/geminicloudassist.admin) zuzuweisen. Diese Rolle enthält alle erforderlichen Berechtigungen zum Aufrufen und Ändern der Administratoreinstellungen für Gemini Cloud Assist.

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

Erforderliche Berechtigungen

  • cloudaicompanion.dataSharingWithGoogleSettings.create
  • cloudaicompanion.dataSharingWithGoogleSettings.update
  • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsCreate
  • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsUse
    • Wenn Sie direkte API-Anfragen verwenden, ist diese Berechtigung erforderlich speziell für das TARGET_PROJECT.

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

  • cloudaicompanion.instance.queryEffectiveSetting
  • cloudaicompanion.instance.queryEffectiveSettingBindings
  • cloudaicompanion.dataSharingWithGoogleSettings.list
  • cloudaicompanion.dataSharingWithGoogleSettings.get
  • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsGet
  • settingBindings.dataSharingWithGoogleSettingsUpdate
  • settingBindings.dataSharingWithGoogleSettingsDelete

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

Weitergabe von Prompts und Antworten für Gemini Cloud Assist aktivieren

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. Achten Sie im Abschnitt Datenweitergabe für Gemini Cloud Assist darauf, dass die Option Unterstützen Sie Google beim Verbessern von Gemini Cloud Assist, indem Sie Ihre Prompts und Antworten weitergeben ausgewählt ist.

  5. Klicken Sie auf Speichern.

API

Wenn Sie die Datenweitergabe für Gemini Cloud Assist aktivieren möchten, erstellen Sie eine Einstellung mit der dataSharingWithGoogleSettings.create Methode und wenden Sie die Einstellung mit der zugehörigen settingBindings.create Methode an.

  1. Erstellen Sie die Einstellung und einen einstellungsspezifischen Wert:

    1. Rufen Sie einen Authentifizierungstoken ab:

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

    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 '{
    "enablePreviewDataSharing": true
    }' \
  "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings?dataSharingWithGoogleSettingId=SETTING_ID"

      Ersetzen Sie Folgendes:

      • CONTAINER_PROJECT_NAME: Geben Sie die ID des übergeordneten Projekts ein.
      • SETTING_ID: Geben Sie einen eindeutigen Namen für die Einstellung ein, z. B. dswg1 für Data Sharing with Google.

      Wenn der Befehl erfolgreich ist, wird ein Antworttext zurückgegeben, in dem enablePreviewDataSharing auf true gesetzt ist:

      {
  "name": "projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings/SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "enablePreviewDataSharing": true
}

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

  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_NAME",
      "product": "GEMINI_CLOUD_ASSIST"
      }' \
    "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings/SETTING_ID/settingBindings?settingBindingId=BINDING_ID"

    Ersetzen Sie Folgendes:

    • TARGET_PROJECT_NAME: Geben Sie das Zielprojekt ein, auf das die Einstellung angewendet werden soll.
    • SETTING_ID: Verwenden Sie dieselbe SETTING_ID wie beim Erstellen der Einstellung, hängen Sie aber b1 an. Verwenden Sie beispielsweise dswg1b1 für Data Sharing with Google.

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

    {
  "name": "projects/<var>CONTAINER_PROJECT_NAME</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_NAME</var>/locations/global/dataSharingWithGoogleSettings/<var>SETTING_ID</var>/settingBindings/<var>BINDING_ID</var>",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Weitergabe von Prompts und Antworten für Gemini Cloud Assist deaktivieren

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. Achten Sie im Abschnitt Datenweitergabe für Gemini Cloud Assist darauf, dass die Option Unterstützen Sie Google beim Verbessern von Gemini Cloud Assist, indem Sie Ihre Prompts und Antworten weitergeben nicht ausgewählt ist.

  5. Klicken Sie auf Speichern.

API

Wenn Sie die Weitergabe von Prompts und Antworten für Gemini Cloud Assist deaktivieren möchten, verwenden Sie die dataSharingWithGoogleSettings.patch Methode.

  1. Token abrufen:

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

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

    curl -X PATCH \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "enablePreviewDataSharing": false
    } ' \
  "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings?dataSharingWithGoogleSettingId=SETTING_ID"

    Dieser PATCH-Befehl ist nur erfolgreich, wenn die Einstellungsressource bereits vorhanden ist, nachdem Sie die Weitergabe von Prompts und Antworten aktiviert haben.

    Ersetzen Sie Folgendes:

    • CONTAINER_PROJECT_NAME: Geben Sie die ID des übergeordneten Projekts ein.
    • SETTING_ID: Geben Sie den Namen der vorhandenen Einstellung ein, z. B. dswg1 für Data Sharing with Google.

    Wenn der Befehl erfolgreich ist, wird ein Antworttext zurückgegeben, in dem enablePreviewDataSharing auf false gesetzt ist:

    {
  "name": "projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings/SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "enablePreviewDataSharing": false
}

Nächste Schritte