Configurar o embasamento do Gemini Cloud Assist

Este documento descreve como configurar o embasamento para o Gemini Cloud Assist usando o Google Cloud console ou uma API. O embasamento é fornecido pela Vertex AI.

Tipos de embasamento disponíveis:

  • Embasamento com a Pesquisa Google (recomendado): instrui o Gemini Cloud Assist a usar a Pesquisa Google para receber as respostas mais abrangentes e atualizadas. Algumas ofertas, como residência de dados, transparência no acesso e chaves de criptografia gerenciadas pelo cliente (CMEK, na sigla em inglês), não são compatíveis com essa opção.

  • Embasamento na Web para empresas: usa um subconjunto restrito de conteúdo da Web. Embora isso possa levar a respostas de menor qualidade em comparação com o Embasamento com a Pesquisa Google, essa é a opção preferencial para setores altamente regulamentados que exigem conformidade rigorosa com a residência de dados, como finanças, saúde e setor público.

Por padrão, o Gemini Cloud Assist usa o Embasamento com a Pesquisa Google para melhorar a qualidade das respostas aos seus comandos. O uso do Embasamento com a Pesquisa Google envolve o tratamento especial de dados para seus comandos e respostas, conforme descrito nos Google Cloud Termos de Serviço.

Antes de começar

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

  2. Verifique se o Gemini Cloud Assist está configurado para seu Google Cloud projeto.

  3. Para receber as permissões necessárias para configurar o embasamento do Gemini Cloud Assist, peça ao administrador para conceder a você o Administrador das configurações do Gemini para Google Cloud (roles/cloudaicompanion.settingsAdmin) papel do Identity and Access Management (IAM) no projeto. Esse papel predefinido contém as permissões necessárias para gerenciar 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.geminiGcpEnablementSettings.create
    • cloudaicompanion.geminiGcpEnablementSettings.update
    • cloudaicompanion.settingBindings.geminiGcpEnablementSettingsCreate
    • cloudaicompanion.settingBindings.geminiGcpEnablementSettingsUse
      • Se você estiver usando solicitações diretas de API, essa permissão será necessária especificamente para o TARGET_PROJECT.

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

    • cloudaicompanion.instances.queryEffectiveSetting
    • cloudaicompanion.instances.queryEffectiveSettingBindings
    • cloudaicompanion.geminiGcpEnablementSettings.get
    • cloudaicompanion.settingBindings.geminiGcpEnablementSettingsGet
    • cloudaicompanion.settingBindings.geminiGcpEnablementSettingsUpdate

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

Configurar o embasamento 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 em spark 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. Selecione a opção de embasamento que você quer usar.

  5. Clique em Salvar.

API

Para configurar o embasamento do Gemini Cloud Assist usando a API, crie um recurso geminiGcpEnablementSettings que defina o tipo de embasamento, usando o método geminiGcpEnablementSettings.create. Em seguida, aplique a configuração usando o método settingBindings.create associado para vincular a configuração a um projeto.

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

    1. Consiga um token de autenticação:

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

      Para mais informações sobre autenticação, consulte Autenticar para usar REST.

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

      curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "webGroundingType": "GROUNDING_TYPE"
    }' \
  "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT/locations/global/geminiGcpEnablementSettings?geminiGcpEnablementSettingId=GROUNDING_SETTING_ID"

      Substitua:

      • CONTAINER_PROJECT: o ID do projeto que armazena os dados de configuração.
      • GROUNDING_TYPE: o tipo de embasamento, que é GROUNDING_WITH_GOOGLE_SEARCH ou WEB_GROUNDING_FOR_ENTERPRISE.
      • GROUNDING_SETTING_ID: um nome exclusivo para identificar esses dados de configuração específicos, como gt1.

      Se o comando for bem-sucedido, ele vai retornar um corpo de resposta que mostra o webGroundingType definido como sua seleção:

      {
  "name": "projects/CONTAINER_PROJECT/locations/global/geminiGcpEnablementSettings/GROUNDING_SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "webGroundingType": "GROUNDING_TYPE"
}

  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/geminiGcpEnablementSettings/GROUNDING_SETTING_ID/settingBindings?settingBindingId=GROUNDING_BINDING_ID"

    Substitua:

    • TARGET_PROJECT: o ID do projeto a que a configuração deve ser aplicada. Normalmente, o projeto de destino e o projeto do contêiner são os mesmos.
    • CONTAINER_PROJECT: o ID do projeto que armazena os dados de configuração.
    • GROUNDING_SETTING_ID: o GROUNDING_SETTING_ID especificado ao criar a configuração.
    • GROUNDING_BINDING_ID: um ID exclusivo para identificar esse recurso de vinculação de configuração específico, como b1.

    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/geminiGcpEnablementSettings/GROUNDING_SETTING_ID/settingBindings/GROUNDING_BINDING_ID",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

A seguir