Configurar o compartilhamento de prompts e respostas para o Gemini Cloud Assist

Este documento descreve como configurar o compartilhamento de prompt e resposta do Gemini Cloud Assist para um projeto usando o Google Cloud console ou uma API.

Antes de começar

  • Garanta o seu Google Cloud o projeto está anexado a uma conta de cobrança.

(Opcional) Conceder permissões de IAM

Para configurar o compartilhamento de prompts e respostas para o Gemini Cloud Assist, você precisa ter permissões específicas de Gerenciamento de Identidade e Acesso (IAM), detalhadas nas seções a seguir. Certifique-se de que essas permissões sejam adicionadas às funções personalizadas do IAM .

Como alternativa, você pode conceder a função predefinida do Gemini para o administrador de configurações do Google Cloud ( roles/cloudaicompanion.settingsAdmin ) do IAM, que inclui todas as permissões necessárias para todos os Gemini para Google Cloud configurações do administrador.

(Opcional) Vincular permissões a configurações e destinos

Se você estiver configurando o Gemini para Google Cloudconfigurações do administrador no Google Cloud console, então você pode pular esta seção.

Para configurar o Gemini para Google Cloud Configurações do administrador com a API Gemini para Google Cloud , você deve primeiro criar configurações e, em seguida, criar vinculações para "vincular" essas configurações e destinos (como instância, tópico ou projetos) para produtos específicos (como Gemini Cloud Assist ou Gemini Code Assist).

Todas as permissões para criar e atualizar configurações estão no nível do projeto.

Configurar o compartilhamento de prompts e respostas do Gemini Cloud Assist

As seções a seguir fornecem as etapas necessárias para configurar o Gemini Cloud Assist para compartilhar os prompts e respostas da sua organização com o Google para aprimoramento do produto. Esta configuração instrui o Google a processar os prompts e respostas de todos os usuários do Gemini Cloud Assist no projeto para fins de aprimoramento do produto, o que ajuda o Google a aprimorar o Gemini Cloud Assist.

Por padrão, o Google não tem acesso para registrar ou examinar os prompts que seus usuários digitam e enviam ao Gemini Cloud Assist, nem as respostas que são enviadas de volta. Isso limita a capacidade do Google de aprimorar o Gemini Cloud Assist, entendendo melhor quais tópicos são importantes para sua organização e a qualidade das nossas respostas. Se você ativar o compartilhamento de prompts e respostas para um projeto, o Google armazenará prompts e respostas anonimizados enviados pelo projeto por no máximo 180 dias. Os prompts e respostas da sua organização nunca serão usados ​​para treinar ou ajustar qualquer modelo de LLM.

Se você habilitar o compartilhamento de prompts e respostas com o Google , poderá desabilitá-lo a qualquer momento visitando a página Admin for Gemini no Google Cloud console.

Habilitar compartilhamento de prompts e respostas para o Gemini Cloud Assist

Selecione uma das seguintes opções:

Console

  1. Certifique-se de ter as seguintes permissões de Gerenciamento de Identidade e Acesso (IAM) no projeto que possui a assinatura:

    • dataSharingWithGoogleSettings.create
    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.get
    • dataSharingWithGoogleSettings.update
    • settingBindings.dataSharingWithGoogleSettingsCreate
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsUpdate
    • settingBindings.dataSharingWithGoogleSettingsUse

  2. No Google Cloud console, vá para a página Admin do Gemini .

    Vá para Gemini para Google Cloud

    A página do Gemini para Google Cloud é carregada.

  3. Clique em Configurações no menu de navegação à esquerda.

    A página Configurações é carregada.

  4. Clique em Ativar compartilhamento de dados para compartilhar prompts e respostas com o Google para todos os usuários do Gemini Cloud Assist no projeto.

O uso desses dados pelo Google é regido pela Google Cloud Acordo, incluindo os Termos da Oferta Pré-GA da Google Cloud Termos de serviço específicos , complementados pelos termos do Gemini para Google Cloud Programa de Testador Confiável .

API

Para habilitar o compartilhamento de dados para o Gemini Cloud Assist, use o método CreateDataSharingWithGoogleSetting .

  1. Certifique-se de ter as seguintes permissões de Gerenciamento de Identidade e Acesso (IAM) no projeto que possui a assinatura:

    • dataSharingWithGoogleSettings.create
    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.get
    • dataSharingWithGoogleSettings.update
    • settingBindings.dataSharingWithGoogleSettingsCreate
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsUpdate
    • settingBindings.dataSharingWithGoogleSettingsUse

  2. Crie a configuração e um valor específico da configuração:

    1. Obter um token de autenticação :

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

    2. Execute o seguinte comando para criar a configuração:

      curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "enable_customer_data_sharing": true
    }' \
  "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings?data_sharing_with_google_setting_id=SETTING_ID"

      Substitua o seguinte:

      • CONTAINER_PROJECT_NAME : Insira o ID do projeto pai.
      • SETTING_ID : insira um nome de configuração exclusivo, como dswg1 para Data Sharing with Google .

      Se o comando for bem-sucedido, ele retornará um corpo de resposta que mostra o enablePreviewDataSharing definido como 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
}

      Para obter mais informações sobre autenticação, consulte Autenticar para usar REST .

  3. Crie a vinculação de configuração:

      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?setting_binding_id=BINDING_ID"

    Substitua o seguinte:

    • TARGET_PROJECT_NAME : Insira o projeto de destino ao qual a configuração deve ser aplicada.
    • SETTING_ID : use o mesmo SETTING_ID usado na criação da configuração, mas anexe b1 . Por exemplo, use dswg1b1 para Data Sharing with Google .

    Se o comando for bem-sucedido, ele retornará os metadados da operação no seguinte 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
}

O uso desses dados pelo Google é regido pela Google Cloud Acordo, incluindo os Termos da Oferta Pré-GA da Google Cloud Termos de serviço específicos , complementados pelos termos do Gemini para Google Cloud Programa de Testador Confiável .

Desativar o compartilhamento de prompts e respostas para o Gemini Cloud Assist

Selecione uma das seguintes opções:

Console

  1. Certifique-se de ter as seguintes permissões de Gerenciamento de Identidade e Acesso (IAM) no projeto no qual deseja modificar as configurações:

    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.get
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsDelete
    • settingBindings.dataSharingWithGoogleSettingsUse

  2. No Google Cloud console, vá para a página Admin do Gemini .

    Vá para Gemini para Google Cloud

    A página do Gemini para Google Cloud é carregada.

  3. Clique em Configurações no menu de navegação à esquerda.

    A página Configurações é carregada.

  4. Clique em Desativar compartilhamento de dados para parar de compartilhar prompts e respostas com o Google para todos os usuários do Gemini Cloud Assist no projeto.

API

Para desabilitar o compartilhamento de dados do Gemini Cloud Assist, use o método DeleteDataSharingWithGoogleSetting .

  1. Certifique-se de ter as seguintes permissões de Gerenciamento de Identidade e Acesso (IAM) no projeto no qual deseja modificar as configurações:

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

  2. Desabilite o compartilhamento de prompts e respostas para a configuração especificada:

    1. Obtenha o token:

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

    2. Execute o seguinte comando para desabilitar a configuração:

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

      Este comando PATCH só terá sucesso se o recurso de configuração já existir quando você habilitou o compartilhamento de prompt e resposta .

      Substitua o seguinte:

      • CONTAINER_PROJECT_NAME : Insira o ID do projeto pai.
      • SETTING_ID : insira o nome da configuração existente, como dswg1 para Data Sharing with Google .

      Se o comando for bem-sucedido, ele retornará um corpo de resposta que mostra enablePreviewDataSharing definido como 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
}

O que vem a seguir