Configurar o embasamento do Gemini Cloud Assist

O embasamento permite conectar o Gemini Cloud Assist a fontes externas da Web pela Vertex AI, oferecendo respostas mais precisas e atualizadas. Este documento descreve como configurar o embasamento no console Google Cloud ou com uma API.

Tipos de embasamento disponíveis:

  • Embasamento com a Pesquisa Google (recomendado): instrui o Gemini Cloud Assist a usar a Pesquisa Google para respostas mais completas e atualizadas. Algumas ofertas, como residência de dados, transparência no acesso e chaves de criptografia gerenciadas pelo cliente (CMEK), 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 qualidade inferior em comparação com o embasamento com a Pesquisa Google, essa é a opção preferida para setores altamente regulamentados que exigem conformidade estrita 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 um tratamento especial de dados para seus comandos e respostas, conforme descrito nos Google Cloud termos do 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 projeto Google Cloud .

  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 papel do IAM Administrador das configurações do Gemini para Google Cloud (roles/cloudaicompanion.settingsAdmin) no seu 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 da API, essa permissão será necessária especificamente para TARGET_PROJECT.

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

    • 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 console do Google Cloud .

    Acessar o console do Google Cloud

  2. Em qualquer página do console do 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. 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 que você especificou 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