Configurare la condivisione di prompt e risposte per Gemini Cloud Assist

Google Cloud

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

Quando è abilitata, Google elabora 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. Google archivia i prompt e le risposte anonimi inviati dal progetto per un massimo di due anni. I prompt e le risposte della tua organizzazione non vengono mai utilizzati per addestrare o ottimizzare alcun modello LLM.

Puoi cambiare questa impostazione in qualsiasi momento.

Prima di iniziare

Per ottenere le autorizzazioni necessarie per configurare la condivisione di prompt e risposte per Gemini Cloud Assist, chiedi all'amministratore di concederti il ruolo predefinito di Identity and Access Management (IAM) Amministratore di Gemini Cloud Assist (roles/geminicloudassist.admin), che include tutte le autorizzazioni necessarie per visualizzare e modificare le impostazioni dell'amministratore di Gemini Cloud Assist.

Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

  • cloudaicompanion.dataSharingWithGoogleSettings.create
  • cloudaicompanion.dataSharingWithGoogleSettings.update
  • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsCreate
  • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsUse
    • Se utilizzi richieste API dirette, questa autorizzazione è richiesta in modo specifico per TARGET_PROJECT.

Di seguito sono riportate le autorizzazioni aggiuntive richieste se utilizzi la console: Google Cloud

  • cloudaicompanion.instance.queryEffectiveSetting
  • cloudaicompanion.instance.queryEffectiveSettingBindings
  • cloudaicompanion.dataSharingWithGoogleSettings.list
  • cloudaicompanion.dataSharingWithGoogleSettings.get
  • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsGet
  • settingBindings.dataSharingWithGoogleSettingsUpdate
  • settingBindings.dataSharingWithGoogleSettingsDelete

Potresti essere in grado di ottenere queste autorizzazioni con altri ruoli predefiniti o ruoli personalizzati.

Abilita la condivisione di prompt e risposte per Gemini Cloud Assist

Seleziona una delle seguenti opzioni:

Console

  1. Apri la Google Cloud console.

    Vai alla Google Cloud console

  2. In qualsiasi pagina della Google Cloud console, fai clic sulla stella Apri o chiudi la chat di Gemini Cloud Assist.

    Si apre il riquadro Cloud Assist.

  3. Fai clic su Altre azioni (), quindi su Impostazioni di Cloud Assist nel menu a discesa.

    Si apre il riquadro delle impostazioni Gestisci Gemini Cloud Assist.

  4. Nella sezione Condivisione dei dati per Gemini Cloud Assist, assicurati che sia selezionata l'opzione Aiuta Google a migliorare Gemini Cloud Assist condividendo i prompt e le risposte.

  5. Fai clic su Salva.

API

Per abilitare la condivisione dei dati per Gemini Cloud Assist, crea un'impostazione con il dataSharingWithGoogleSettings.create metodo e applicala utilizzando il settingBindings.create metodo associato.

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

    1. Ottieni un token di autenticazione:

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

    2. Esegui il comando seguente 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 padre.
      • SETTING_ID: inserisci un nome di impostazione univoco, 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.

  2. Crea l'associazione di impostazioni:

      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 aggiungici 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
}

Disabilita la condivisione di prompt e risposte per Gemini Cloud Assist

Seleziona una delle seguenti opzioni:

Console

  1. Apri la Google Cloud console.

    Vai alla Google Cloud console

  2. In qualsiasi pagina della Google Cloud console, fai clic sulla stella Apri o chiudi la chat di Gemini Cloud Assist.

    Si apre il riquadro Cloud Assist.

  3. Fai clic su Altre azioni (), quindi su Impostazioni di Cloud Assist nel menu a discesa.

    Si apre il riquadro delle impostazioni Gestisci Gemini Cloud Assist.

  4. Nella sezione Condivisione dei dati per Gemini Cloud Assist, assicurati che l'opzione Aiuta Google a migliorare Gemini Cloud Assist condividendo i prompt e le risposte non sia selezionata.

  5. Fai clic su Salva.

API

Per disabilitare la condivisione di prompt e risposte per Gemini Cloud Assist, utilizza il dataSharingWithGoogleSettings.patch metodo.

  1. Ottieni il token:

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

  2. Esegui il comando seguente per disabilitare 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 abilitato la condivisione di prompt e risposte.

    Sostituisci quanto segue:

    • CONTAINER_PROJECT_NAME: inserisci l'ID progetto padre.
    • 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