Configure a partilha de comandos e respostas para o Gemini Cloud Assist

Este documento descreve como configurar a partilha de comandos e respostas do Gemini Cloud Assist para um projeto através da Google Cloud consola ou de uma API.

Antes de começar

  • Verifique se o seu Google Cloud projeto está associado a uma conta de faturação.

Valide as autorizações de IAM

Para configurar a partilha de comandos e respostas para o Gemini Cloud Assist, pode conceder a função predefinida de administrador das definições do Gemini para o Google Cloud (roles/cloudaicompanion.settingsAdmin) de gestão de identidade e acesso (IAM), que inclui todas as autorizações necessárias para todas as definições de Google Cloud administrador do Gemini.

Em alternativa, pode atualizar quaisquer funções de IAM personalizadas com autorizações de IAM específicas, que são detalhadas nas secções seguintes.

Configure a partilha de comandos e respostas do Gemini Cloud Assist

As secções seguintes fornecem os passos necessários para configurar o Gemini Cloud Assist de modo a partilhar os comandos e as respostas da sua organização com a Google para melhoria do produto. Esta definição indica à Google que processe os comandos e as respostas de todos os utilizadores do Gemini Cloud Assist no projeto para fins de melhoria do produto, o que ajuda a Google a melhorar o Gemini Cloud Assist.

Por predefinição, a Google não examina os comandos que os seus utilizadores escrevem e enviam para o Gemini Cloud Assist nem as respostas que são enviadas de volta. Isto limita a capacidade do Google de melhorar o Gemini Cloud Assist, compreendendo melhor os tópicos importantes para a sua organização e a qualidade das nossas respostas. Se ativar a partilha de comandos e respostas para um projeto, a Google armazena comandos e respostas anónimos enviados a partir do projeto durante um máximo de dois anos. Os comandos e as respostas da sua organização nunca são usados para preparar nem ajustar nenhum modelo de LLM.

Se ativar a partilha de comandos e respostas com a Google, pode desativá-la em qualquer altura acedendo à página Administração do Gemini na Google Cloud consola.

Ative a partilha de comandos e respostas para o Gemini Cloud Assist

Selecione uma das seguintes opções:

Consola

  1. Verifique se tem as seguintes autorizações da gestão de identidade e de acesso (IAM) no projeto proprietário da subscrição:

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

  2. Na Google Cloud consola, aceda à página Administração do Gemini.

    Aceder ao Gemini para Google Cloud

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

  3. Clique em Definições no menu de navegação do lado esquerdo.

    A página Definições é carregada.

  4. Clique em Ativar partilha de dados para partilhar comandos e respostas com a Google para todos os utilizadores do Gemini Cloud Assist no projeto.

API

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

  1. Verifique se tem as seguintes autorizações da gestão de identidade e de acesso (IAM) no projeto proprietário da subscrição:

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

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

    1. Obtenha um token de autenticação:

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

    2. Execute o seguinte comando para criar a definiçã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 o seguinte:

      • CONTAINER_PROJECT_NAME: introduza o ID do projeto principal.
      • SETTING_ID: introduza um nome de definição exclusivo, como dswg1 para Data Sharing with Google.

      Se o comando for bem-sucedido, devolve um corpo da 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 a autenticação, consulte o artigo Autentique-se para usar REST.

  3. Crie a associação de definições:

      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 o seguinte:

    • TARGET_PROJECT_NAME: introduza o projeto de destino ao qual a definição deve ser aplicada.
    • SETTING_ID: use o mesmo SETTING_ID quando criou a definição, mas acrescente-lhe b1. Por exemplo, use dswg1b1 para Data Sharing with Google.

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

Desative a partilha de comandos e respostas para o Gemini Cloud Assist

Selecione uma das seguintes opções:

Consola

  1. Confirme que tem as seguintes autorizações de gestão de identidade e de acesso (IAM) no projeto onde quer modificar as definições:

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

  2. Na Google Cloud consola, aceda à página Administração do Gemini.

    Aceder ao Gemini para Google Cloud

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

  3. Clique em Definições no menu de navegação do lado esquerdo.

    A página Definições é carregada.

  4. Clique em Desativar partilha de dados para parar de partilhar comandos e respostas com a Google para todos os utilizadores do Gemini Cloud Assist no projeto.

API

Para desativar a partilha de dados do Gemini Cloud Assist, use o método DeleteDataSharingWithGoogleSetting.

  1. Confirme que tem as seguintes autorizações de gestão de identidade e de acesso (IAM) no projeto onde quer modificar as definições:

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

  2. Desative a partilha de comandos e respostas para a definição especificada:

    1. Obtenha o token:

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

    2. Execute o seguinte comando para desativar a definiçã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"

      Este comando PATCH só é bem-sucedido se o recurso de definição já existir desde que ativou a partilha de comandos e respostas.

      Substitua o seguinte:

      • CONTAINER_PROJECT_NAME: introduza o ID do projeto principal.
      • SETTING_ID: introduza o nome da definição existente, como dswg1 para Data Sharing with Google.

      Se o comando for bem-sucedido, devolve um corpo da 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
}

O que se segue?