Configurar o compartilhamento de comandos e respostas do Gemini Cloud Assist

Observação :o uso desta oferta de produtos e recursos em pré-GA do Gemini Cloud Assist está sujeito ao Google Cloud Contrato, incluindo os Termos da Oferta Pré-GA dos Google Cloud Termos de Serviço Específicos, com as alterações inseridas pelos termos do Programa Trusted Tester do Gemini para Google Cloud .

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

Quando ativada, o Google processa 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. O Google armazena comandos e respostas anônimos enviados pelo projeto por um período máximo de dois anos. Os comandos e as respostas da sua organização nunca são usados para treinar ou ajustar nenhum modelo de LLM.

Essa configuração pode ser alterada a qualquer momento.

Antes de começar

Para receber as permissões necessárias para configurar o compartilhamento de comandos e respostas do Gemini Cloud Assist, peça ao administrador para conceder a você o papel predefinido do Identity and Access Management (IAM) Administrador do Gemini Cloud Assist (roles/geminicloudassist.admin), que inclui todas as permissões necessárias para visualizar e modificar as configurações de administrador do Gemini Cloud Assist.

Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

• cloudaicompanion.dataSharingWithGoogleSettings.create
• cloudaicompanion.dataSharingWithGoogleSettings.update
• cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsCreate
• cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsUse
  • Se você estiver usando solicitações diretas de API, essa permissão será necessária especificamente para o TARGET_PROJECT.

As seguintes são permissões adicionais necessárias se você estiver usando o console do Google Cloud :

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

É possível conseguir essas permissões com outros papéis predefinidos ou funções personalizadas.

Ativar o compartilhamento de comandos e respostas do Gemini Cloud Assist

Selecione uma das seguintes opções:

Console

1. Abra o console do Google Cloud .

   Acessar o console do Google Cloud

2. Em qualquer página do console Google Cloud , clique em brilho Abrir ou fechar o chat do Gemini Cloud Assist.

   O painel do Cloud Assist é aberto.

3. Clique em Mais ações () e em Configurações do Cloud Assist no menu suspenso.

   O painel de configurações Gerenciar o Gemini Cloud Assist é aberto.

4. Na seção Compartilhamento de dados do Gemini Cloud Assist, verifique se a opção Ajude o Google a melhorar o Gemini Cloud Assist compartilhando seus comandos e respostas está selecionada.

5. Clique em Salvar.

API

Para ativar o compartilhamento de dados pessoais do Gemini Cloud Assist, crie uma configuração com o método dataSharingWithGoogleSettings.create e aplique-a usando o método settingBindings.create associado.

1. Crie a configuração e um valor específico dela:

   1. Consiga um token de autenticação:

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

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

      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"
      

      Substitua:

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

      Se o comando for bem-sucedido, ele vai 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 mais informações sobre autenticação, consulte Autenticar para usar REST.

2. 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?settingBindingId=BINDING_ID"
   

   Substitua:

   • TARGET_PROJECT_NAME: insira o projeto de destino a que a configuração deve ser aplicada.
   • SETTING_ID: use o mesmo SETTING_ID de quando criou a configuração, mas adicione b1 ao final. Por exemplo, use dswg1b1 para Data Sharing with Google.

   Se o comando for bem-sucedido, ele vai 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
   }
   

Desativar o compartilhamento de comandos e respostas do Gemini Cloud Assist

Selecione uma das seguintes opções:

Console

1. Abra o console do Google Cloud .

   Acessar o console do Google Cloud

2. Em qualquer página do console Google Cloud , clique em brilho Abrir ou fechar o chat do Gemini Cloud Assist.

   O painel do Cloud Assist é aberto.

3. Clique em Mais ações () e em Configurações do Cloud Assist no menu suspenso.

   O painel de configurações Gerenciar o Gemini Cloud Assist é aberto.

4. Na seção Compartilhamento de dados pessoais com o Gemini Cloud Assist, verifique se a opção Ajude o Google a melhorar o Gemini Cloud Assist compartilhando seus comandos e respostas não está selecionada.

5. Clique em Salvar.

API

Para desativar o compartilhamento de comandos e respostas do Gemini Cloud Assist, use o método dataSharingWithGoogleSettings.patch.

1. Receba o token:

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

2. Execute o comando a seguir para desativar a configuração:

   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"
   

   Esse comando PATCH só será bem-sucedido se o recurso de configuração já existir desde que você ativou o compartilhamento de comandos e respostas.

   Substitua:

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

   Se o comando for bem-sucedido, ele vai 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
   }
   

A seguir

• Conheça as configurações de administrador do Gemini Cloud Assist

• Desativar o Gemini Cloud Assist