Configurare la condivisione di prompt e risposte per Gemini Cloud Assist

Questo documento descrive come configurare la condivisione di prompt e risposte di Gemini Cloud Assist per un progetto utilizzando la console Google Cloud o un'API.

Prima di iniziare

  • Verifica che il tuo progetto Google Cloud sia collegato a un account di fatturazione.

Verifica le autorizzazioni IAM

Per configurare la condivisione di prompt e risposte per Gemini Cloud Assist, puoi concedere il ruolo Amministratore impostazioni Gemini in Google Cloud (roles/cloudaicompanion.settingsAdmin) predefinito di Identity and Access Management (IAM), che include tutte le autorizzazioni richieste per tutte le impostazioni di amministratore di Gemini for Google Cloud .

In alternativa, puoi aggiornare qualsiasi ruolo IAM personalizzato con autorizzazioni IAM specifiche, descritte in dettaglio nelle sezioni seguenti.

Configurare la condivisione di prompt e risposte di Gemini Cloud Assist

Le sezioni seguenti forniscono i passaggi necessari per configurare Gemini Cloud Assist in modo da condividere i prompt e le risposte della tua organizzazione con Google per il miglioramento del prodotto. Questa impostazione indica a Google di elaborare i prompt e le risposte di tutti gli utenti di Gemini Cloud Assist nel progetto ai fini del miglioramento del prodotto, il che aiuta Google a migliorare Gemini Cloud Assist.

Per impostazione predefinita, Google non esamina né i prompt che gli utenti digitano e inviano a Gemini Cloud Assist né le risposte che vengono restituite. Ciò limita la capacità di Google di migliorare Gemini Cloud Assist comprendendo meglio quali argomenti sono importanti per la tua organizzazione e la qualità delle nostre risposte. Se attivi la condivisione di prompt e risposte per un progetto, Google memorizza i prompt e le risposte anonimizzati inviati dal progetto per un massimo di due anni. I prompt e le risposte della tua organizzazione non vengono mai utilizzati per addestrare o perfezionare alcun modello LLM.

Se attivi la condivisione di prompt e risposte con Google, puoi disattivarla in qualsiasi momento visitando la pagina Amministrazione per Gemini nella console Google Cloud .

Abilitare la condivisione di prompt e risposte per Gemini Cloud Assist

Seleziona una delle seguenti opzioni:

Console

  1. Verifica di disporre delle seguenti autorizzazioni Identity and Access Management (IAM) nel progetto proprietario dell'abbonamento:

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • dataSharingWithGoogleSettings.create
    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.get
    • dataSharingWithGoogleSettings.update
    • settingBindings.dataSharingWithGoogleSettingsCreate
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsUpdate
    • settingBindings.dataSharingWithGoogleSettingsUse

  2. Nella console Google Cloud , vai alla pagina Amministrazione di Gemini.

    Vai a Gemini per Google Cloud

    Viene caricata la pagina Gemini in Google Cloud.

  3. Fai clic su Impostazioni nel menu di navigazione a sinistra.

    Viene caricata la pagina Impostazioni.

  4. Fai clic su Attiva la condivisione dei dati per condividere prompt e risposte con Google per tutti gli utenti di Gemini Cloud Assist nel progetto.

API

Per attivare la condivisione dei dati per Gemini Cloud Assist, utilizza il metodo CreateDataSharingWithGoogleSetting.

  1. Verifica di disporre delle seguenti autorizzazioni Identity and Access Management (IAM) nel progetto proprietario dell'abbonamento:

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • dataSharingWithGoogleSettings.create
    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.get
    • dataSharingWithGoogleSettings.update
    • settingBindings.dataSharingWithGoogleSettingsCreate
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsUpdate
    • settingBindings.dataSharingWithGoogleSettingsUse

  2. Crea l'impostazione e un valore specifico per l'impostazione:

    1. Ottieni un token di autenticazione:

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

    2. Esegui questo comando per creare l'impostazione:

      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"

      Sostituisci quanto segue:

      • CONTAINER_PROJECT_NAME: inserisci l'ID progetto principale.
      • SETTING_ID: inserisci un nome univoco per l'impostazione, ad esempio dswg1 per Data Sharing with Google.

      Se il comando ha esito positivo, restituisce un corpo della risposta che mostra enablePreviewDataSharing impostato su true:

      {
  "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
}

      Per ulteriori informazioni sull'autenticazione, consulta Autenticazione per l'utilizzo di REST.

  3. Crea l'associazione dell'impostazione:

      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"

    Sostituisci quanto segue:

    • TARGET_PROJECT_NAME: inserisci il progetto di destinazione a cui deve essere applicata l'impostazione.
    • SETTING_ID: utilizza lo stesso SETTING_ID quando hai creato l'impostazione, ma aggiungi b1. Ad esempio, utilizza dswg1b1 per Data Sharing with Google.

    Se il comando ha esito positivo, restituisce i metadati dell'operazione nel seguente formato:

    {
  "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
}

Disattivare la condivisione di prompt e risposte per Gemini Cloud Assist

Seleziona una delle seguenti opzioni:

Console

  1. Verifica di disporre delle seguenti autorizzazioni Identity and Access Management (IAM) nel progetto in cui vuoi modificare le impostazioni:

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.get
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsDelete
    • settingBindings.dataSharingWithGoogleSettingsUse

  2. Nella console Google Cloud , vai alla pagina Amministrazione di Gemini.

    Vai a Gemini per Google Cloud

    Viene caricata la pagina Gemini in Google Cloud.

  3. Fai clic su Impostazioni nel menu di navigazione a sinistra.

    Viene caricata la pagina Impostazioni.

  4. Fai clic su Disattiva la condivisione dei dati per interrompere la condivisione di prompt e risposte con Google per tutti gli utenti di Gemini Cloud Assist nel progetto.

API

Per disattivare la condivisione dei dati per Gemini Cloud Assist, utilizza il metodo DeleteDataSharingWithGoogleSetting.

  1. Verifica di disporre delle seguenti autorizzazioni Identity and Access Management (IAM) nel progetto in cui vuoi modificare le impostazioni:

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.delete
    • dataSharingWithGoogleSettings.get
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsUpdate
    • settingBindings.dataSharingWithGoogleSettingsUse

  2. Disattiva la condivisione di prompt e risposte per l'impostazione specificata:

    1. Ottieni il token:

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

    2. Esegui questo comando per disattivare l'impostazione:

      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"

      Questo comando PATCH ha esito positivo solo se la risorsa di impostazione esiste già da quando hai attivato la condivisione di prompt e risposte.

      Sostituisci quanto segue:

      • CONTAINER_PROJECT_NAME: inserisci l'ID progetto principale.
      • SETTING_ID: inserisci il nome dell'impostazione esistente, ad esempio dswg1 per Data Sharing with Google.

      Se il comando ha esito positivo, restituisce un corpo della risposta che mostra enablePreviewDataSharing impostato su false:

      {
  "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
}

Passaggi successivi