Configurar o compartilhamento de comandos e respostas do Gemini Cloud Assist

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

Quando ativado, 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 o Administrador do Gemini Cloud Assist (roles/geminicloudassist.admin) papel predefinido do Identity and Access Management (IAM), 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 da API, essa permissão será necessária especificamente para o TARGET_PROJECT.

As permissões a seguir são necessárias se você está usando o Google Cloud console:

  • cloudaicompanion.instances.queryEffectiveSetting
  • cloudaicompanion.instances.queryEffectiveSettingBindings
  • cloudaicompanion.dataSharingWithGoogleSettings.list
  • cloudaicompanion.dataSharingWithGoogleSettings.get
  • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsGet
  • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsUpdate
  • cloudaicompanion.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 Google Cloud console.

    Acessar o Google Cloud console

  2. Em qualquer página do Google Cloud console, clique no brilho e em 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, selecione Ajude o Google a melhorar o Gemini Cloud Assist compartilhando seus comandos e respostas.

  5. Clique em Salvar.

API

Para ativar o compartilhamento de dados pessoais do Gemini Cloud Assist, crie uma configuração com o dataSharingWithGoogleSettings.create método e aplique a configuração usando o settingBindings.create método 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/locations/global/dataSharingWithGoogleSettings?dataSharingWithGoogleSettingId=SETTING_ID"

      Substitua:

      • CONTAINER_PROJECT: 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/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",
      "product": "GEMINI_CLOUD_ASSIST"
      }' \
    "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT/locations/global/dataSharingWithGoogleSettings/SETTING_ID/settingBindings?settingBindingId=BINDING_ID"

    Substitua:

    • TARGET_PROJECT: 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/CONTAINER_PROJECT/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/TARGET_PROJECT/locations/global/dataSharingWithGoogleSettings/SETTING_ID/settingBindings/BINDING_ID",
    "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 Google Cloud console.

    Acessar o Google Cloud console

  2. Em qualquer página do Google Cloud console, clique no brilho e em 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, selecione Ajude o Google a melhorar o Gemini Cloud Assist compartilhando seus comandos e respostas.

  5. Clique em Salvar.

API

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

  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/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: 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/locations/global/dataSharingWithGoogleSettings/SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "enablePreviewDataSharing": false
}

A seguir