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.

Verifica le autorizzazioni IAM

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

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

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 migliorare il 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 di Gemini nella console Google Cloud .

Seleziona una delle seguenti opzioni:

Console

Verifica di disporre delle seguenti autorizzazioni IAM (Identity and Access Management) 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
Nella console Google Cloud , vai alla pagina Amministrazione per Gemini.

Vai a Gemini per Google Cloud

Viene caricata la pagina Gemini in Google Cloud.
Fai clic su Impostazioni nel menu di navigazione a sinistra.

Viene caricata la pagina Impostazioni.
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.

Verifica di disporre delle seguenti autorizzazioni IAM (Identity and Access Management) 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

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

Ottieni un token di autenticazione:

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

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 saperne di più sull'autenticazione, consulta Autenticati per usare REST.

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
}

Seleziona una delle seguenti opzioni:

Console

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
Nella console Google Cloud , vai alla pagina Amministrazione per Gemini.

Vai a Gemini per Google Cloud

Viene caricata la pagina Gemini in Google Cloud.
Fai clic su Impostazioni nel menu di navigazione a sinistra.

Viene caricata la pagina Impostazioni.
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.

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

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

Ottieni il token:

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

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

Visualizza altre impostazioni di Gemini in Google Cloud per l'amministratore.

Configurare la condivisione di prompt e risposte per Gemini Cloud Assist Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Verifica le autorizzazioni IAM

Configurare la condivisione di prompt e risposte di Gemini Cloud Assist

Abilitare la condivisione di prompt e risposte per Gemini Cloud Assist

Console

API

Disattivare la condivisione di prompt e risposte per Gemini Cloud Assist

Console

API

Passaggi successivi

Configurare la condivisione di prompt e risposte per Gemini Cloud Assist