Configurare Gemini per le impostazioni di amministrazione di Google Cloud

Questo documento descrive come accedere e utilizzare le impostazioni di amministratore di Gemini perGoogle Cloud per configurare le modifiche per tutti gli utenti del progetto. Puoi gestire le impostazioni di amministrazione utilizzando la console Google Cloud o un'API.

(Facoltativo) Associa le autorizzazioni a impostazioni e target

Se stai configurando Gemini per le impostazioni Google Cloud dell'amministratore nella console Google Cloud, puoi saltare questa sezione.

Per configurare le Google Cloud impostazioni di amministrazione di Gemini con l'API Gemini for Google Cloud, devi prima creare le impostazioni, poi le associazioni per "associare" queste impostazioni e i target (ad esempio istanze, argomenti o progetti) per prodotti specifici (ad esempio Gemini Cloud Assist o Gemini Code Assist).

Tutte le autorizzazioni per creare e aggiornare le impostazioni sono a livello di progetto.

Configurare Gemini Cloud Assist per condividere prompt e risposte con Google

Le sezioni seguenti descrivono i passaggi necessari per configurare Gemini Cloud Assist in modo che condivida con Google i prompt e le risposte della tua organizzazione 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 a fini di miglioramento del prodotto, il che aiuta Google a migliorare Gemini Cloud Assist.

Per impostazione predefinita, Google non ha accesso ai log o non può esaminare i prompt digitati e inviati dagli utenti a Gemini Cloud Assist né le risposte inviate. 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 180 giorni. 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.

Attivare la condivisione di prompt e risposte per Gemini Cloud Assist

Seleziona una delle seguenti opzioni:

Console

  1. Assicurati di disporre delle seguenti autorizzazioni Identity and Access Management (IAM) nell'account di fatturazione proprietario dell'abbonamento:

    • 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 for 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.

L'utilizzo di questi dati da parte di Google è regolato dal Google Cloud contratto, inclusi i Termini dell'offerta pre-GA dei Google Cloud Termini di servizio specifici, integrati dai termini del programma Trusted Tester di Google Cloud Gemini.

API

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

  1. Assicurati di disporre delle seguenti autorizzazioni Identity and Access Management (IAM) nell'account di fatturazione proprietario dell'abbonamento:

    • 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 il token:

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

    2. Imposta l'API regionale:

      curl -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' -d '{
    "enable_customer_data_sharing": true,
  } ' -X POST "https://$REGIONAL_API/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings?data_sharing_with_google_setting_id=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 va a buon fine, 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
}

  3. Crea l'associazione delle impostazioni:

      curl \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
      "target": "projects/TARGET_PROJECT_NAME"
    }' \
  -X POST \ "https://$REGIONAL_API/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings/SETTING_ID/settingBindings?setting_binding_id=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 va a buon fine, 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
}

L'utilizzo di questi dati da parte di Google è regolato dal Google Cloud contratto, inclusi i Termini dell'offerta pre-GA dei Google Cloud Termini di servizio specifici, integrati dai termini del programma Trusted Tester di Google Cloud Gemini.

Disattivare la condivisione di prompt e risposte per Gemini Cloud Assist

Seleziona una delle seguenti opzioni:

Console

  1. Assicurati di disporre delle seguenti autorizzazioni IAM (Gestione di identità e accessi) sul progetto in cui vuoi modificare le impostazioni:

    • 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 for 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 smettere di condividere 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. Assicurati di disporre delle seguenti autorizzazioni IAM (Gestione di identità e accessi) sul progetto in cui vuoi modificare le impostazioni:

    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.delete
    • dataSharingWithGoogleSettings.get
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsUpdate
    • settingBindings.dataSharingWithGoogleSettingsUse

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

    1. Ottieni il token:

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

    2. Imposta l'API regionale:

      REGIONAL_API="cloudaicompanion.googleapis.com"

    3. Esegui il seguente comando per creare l'impostazione.

      curl -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' -d '{
    "enable_customer_data_sharing": false,
  } ' -X POST "https://$REGIONAL_API/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings?data_sharing_with_google_setting_id=SETTING_ID"

      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 va a buon fine, 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
}