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

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

Antes de começar

  • Verifique se o projeto Google Cloud está vinculado a uma conta de faturamento.

(Opcional) Conceder permissões do IAM

Para configurar o compartilhamento de comandos e respostas do Gemini Cloud Assist, você precisa ter permissões específicas do Identity and Access Management (IAM), que são detalhadas nas seções a seguir. Verifique se essas permissões foram adicionadas a papéis personalizados do IAM.

Como alternativa, é possível conceder o papel predefinido do IAM Administrador das configurações do Gemini para Google Cloud (roles/cloudaicompanion.settingsAdmin), que inclui todas as permissões necessárias para todas as configurações de administrador do Gemini para Google Cloud .

Configurar o compartilhamento de comandos e respostas do Gemini Cloud Assist

As seções a seguir mostram as etapas necessárias para configurar o Gemini Cloud Assist e compartilhar comandos 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 examina os comandos que seus usuários digitam e enviam para o Gemini Cloud Assist nem as respostas enviadas de volta. Isso limita a capacidade do Google de melhorar o Gemini Cloud Assist ao entender melhor quais assuntos são importantes para sua organização e a qualidade das nossas respostas. Se você ativar o compartilhamento de comandos e respostas em um projeto, o Google vai armazenar 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.

Se você ativar o compartilhamento de comandos e respostas com o Google, poderá desativar a qualquer momento acessando a página Admin do Gemini no console do Google Cloud .

Ativar o compartilhamento de comandos e respostas do 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 proprietário da assinatura:

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

  2. No console 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 pessoais para compartilhar comandos e respostas com o Google para todos os usuários do Gemini Cloud Assist no projeto.

API

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

  1. Verifique se você tem as seguintes permissões do Identity and Access Management (IAM) no projeto proprietário da assinatura:

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • 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 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.

  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?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 você criou a configuração, mas adicione 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 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. Verifique se você tem as seguintes permissões do Identity and Access Management (IAM) no projeto em que quer modificar as configurações:

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.get
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsDelete
    • settingBindings.dataSharingWithGoogleSettingsUse

  2. No console 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 pessoais 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 do 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:

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.delete
    • dataSharingWithGoogleSettings.get
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsUpdate
    • settingBindings.dataSharingWithGoogleSettingsUse

  2. Desative o compartilhamento de comandos e respostas para a configuração especificada:

    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