Configurar o embasamento do Gemini Cloud Assist

Este documento descreve como configurar o embasamento para o Gemini Cloud Assist usando o console Google Cloud 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 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 menor qualidade 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 de Serviço.

Antes de começar

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

  2. 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 de Administrador das configurações do Gemini para Google Cloud (roles/cloudaicompanion.settingsAdmin) 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 da 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 console do Google Cloud :

    • cloudaicompanion.instance.queryEffectiveSetting
    • cloudaicompanion.instance.queryEffectiveSettingBindings
    • cloudaicompanion.geminiGcpEnablementSettings.get
    • cloudaicompanion.settingBindings.geminiGcpEnablementSettingsGet
    • 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. No console Google Cloud , acesse Gemini Cloud Assist e clique em Configurações.

    Acesse configurações

  2. Selecione a opção de embasamento que você quer usar.

  3. 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 em que a configuração será aplicada. Normalmente, o projeto de destino e o projeto de 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/<var>CONTAINER_PROJECT</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</var>/locations/global/geminiGcpEnablementSettings/<var>GROUNDING_SETTING_ID</var>/settingBindings/<var>GROUNDING_BINDING_ID</var>",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

A seguir