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 di un progetto. Puoi gestire le impostazioni di amministrazione per un progetto utilizzando la Console Google Cloud o un'API.

Prima di iniziare

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

Configurare le impostazioni per i progetti in una cartella

Quando abiliti Gemini Cloud Assist per tutte le API nella cartella, tutte le impostazioni di Gemini Cloud Assist sono disattivate per impostazione predefinita. Devi modificare le impostazioni per ogni progetto nella cartella.

(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 amministratore di Gemini con l'API Gemini for Google Cloud, devi prima creare le impostazioni, poi creare 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 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 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) nel progetto 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) nel progetto 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:

      REGIONAL_API="cloudaicompanion.googleapis.com"

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

      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. Disattiva la condivisione di prompt e risposte per l'impostazione specificata:

    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 disattivare l'impostazione:

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

      Questo comando PATCH ha esito positivo solo se la risorsa di impostazione esiste già da quando hai abilitato 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 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
}

Passaggi successivi