Configurar o Gemini para as configurações de administrador do Google Cloud

Este documento descreve como acessar e usar as configurações de administrador do Gemini para Google Cloud para configurar mudanças para todos os usuários no projeto. É possível gerenciar as configurações de administrador usando o console do Google Cloud ou uma API.

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

Se você estiver configurando as configurações de administrador do Gemini para Google Cloud no console do Google Cloud, pule esta seção.

Para configurar as configurações de administrador do Gemini Google Cloud com a API Gemini para o Google Cloud, primeiro crie as configurações e depois as vinculações para "vincular" essas configurações e destinos (como instância, tópico ou projetos) para produtos específicos (como o Gemini Cloud Assist ou o Gemini Code Assist).

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

Configurar o Gemini Cloud Assist para compartilhar comandos e respostas com o Google

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

Por padrão, o Google não tem acesso para registrar ou examinar os comandos que os usuários digitam e enviam para o Gemini Cloud Assist, nem as respostas que são enviadas de volta. Isso limita a capacidade do Google de melhorar 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 comandos e respostas para um projeto, o Google vai armazenar comandos e respostas enviados do projeto de forma anônima por um máximo de 180 dias. Os comandos e as respostas da sua organização nunca são usados para treinar ou ajustar qualquer modelo de LLM.

Se você ativar o compartilhamento de comandos e respostas com o Google, é possível desativar a qualquer momento abrindo a página Administrador do Gemini no console do Google Cloud.

Ativar o compartilhamento de comandos e respostas para o Gemini Cloud Assist

Selecione uma das seguintes opções:

Console

  1. Verifique se você tem as seguintes permissões do Identity and Access Management (IAM) na conta de faturamento proprietária da assinatura:

    • dataSharingWithGoogleSettings.create
    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.get
    • dataSharingWithGoogleSettings.update
    • settingBindings.dataSharingWithGoogleSettingsCreate
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsUpdate
    • settingBindings.dataSharingWithGoogleSettingsUse
  2. No console do Google Cloud, acesse a página Administrador do Gemini.

    Acessar o Gemini para Google Cloud

    A página 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 o compartilhamento de dados para compartilhar comandos e respostas com o Google para todos os usuários do Gemini Cloud Assist no projeto.

O uso desses dados pelo Google é regido pelo Google Cloud contrato, incluindo os Termos de Produtos pré-GA dos Google Cloud Termos de Serviço específicos, complementados pelos termos do Gemini no Programa Trusted Tester Google Cloud .

API

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

  1. Verifique se você tem as seguintes permissões do Identity and Access Management (IAM) na conta de faturamento proprietária da 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.

    1. Receba o token:

      TOKEN=$(gcloud auth print-access-token)
      
    2. Defina a API regional:

      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"
      

      Substitua:

      • CONTAINER_PROJECT_NAME: insira o ID do projeto pai.
      • SETTING_ID: insira um nome exclusivo de configuração, 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
      }
      
  3. Crie a vinculação de configuração:

      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"
    

    Substitua:

    • TARGET_PROJECT_NAME: insira o projeto de destino em que a configuração será aplicada.
    • SETTING_ID: use o mesmo SETTING_ID quando você criou a configuração, mas anexe-o com b1. Por exemplo, use dswg1b1 para Data Sharing with Google.

    Se o comando for bem-sucedido, ele vai retornar os metadados da operação no formato a seguir:

    {
    "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 pelo Google Cloud contrato, incluindo os Termos de Produtos pré-GA dos Google Cloud Termos específicos de serviço, complementados pelos termos do Gemini no Programa Trusted Tester Google Cloud .

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

Selecione uma das seguintes opções:

Console

  1. Verifique se você tem as seguintes permissões do Identity and Access Management (IAM) no projeto em que quer modificar as configurações:

    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.get
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsDelete
    • settingBindings.dataSharingWithGoogleSettingsUse
  2. No console do Google Cloud, acesse a página Administrador do Gemini.

    Acessar o Gemini para Google Cloud

    A página 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 o compartilhamento de dados para interromper o compartilhamento de comandos e respostas com o Google para todos os usuários do Gemini Cloud Assist no projeto.

API

Para desativar o compartilhamento de dados para o Gemini Cloud Assist, use o método DeleteDataSharingWithGoogleSetting.

  1. Verifique se você tem as seguintes permissões do Identity and Access Management (IAM) no projeto em que quer modificar as configurações:

    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.delete
    • dataSharingWithGoogleSettings.get
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsUpdate
    • settingBindings.dataSharingWithGoogleSettingsUse
  2. Crie a configuração e um valor específico.

    1. Receba o token:

      TOKEN=$(gcloud auth print-access-token)
      
    2. Defina a API regional:

      REGIONAL_API="cloudaicompanion.googleapis.com"
      
    3. Execute o comando a seguir para criar a configuração.

      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"
      

      Substitua:

      • CONTAINER_PROJECT_NAME: insira o ID do projeto pai.
      • SETTING_ID: insira o nome da configuração atual, 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 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
      }