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
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
Nella console Google Cloud , vai alla pagina Amministrazione di Gemini.
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 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
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 esempiodswg1
perData Sharing with Google
.
Se il comando ha esito positivo, restituisce un corpo della risposta che mostra
enablePreviewDataSharing
impostato sutrue
:{ "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.
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 aggiungib1
. Ad esempio, utilizzadswg1b1
perData 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
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 di Gemini.
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 esempiodswg1
perData Sharing with Google
.
Se il comando ha esito positivo, restituisce un corpo della risposta che mostra
enablePreviewDataSharing
impostato sufalse
:{ "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 }