Embasamento na Web para empresas

Esta página descreve o embasamento na Web para controles de compliance corporativo e como usar a API Web Grounding for Enterprise para gerar respostas embasadas na Web. O conteúdo indexado é um subconjunto do que está disponível na Pesquisa Google e adequado para clientes em setores altamente regulamentados, como finanças, saúde e setor público.

Se você não precisar dos controles de compliance adicionais, use Embasamento com a Pesquisa Google, porque ele oferece acesso a um índice da Web mais amplo e atualizado.

Visão geral

O embasamento na Web para empresas usa um índice da Web que é usado para gerar respostas embasadas. O serviço não registra dados do cliente e oferece suporte a controles de serviço de VPC. Para mais informações, consulte Controles de segurança para IA generativa. Como nenhum dado do cliente é mantido, as chaves de criptografia gerenciadas pelo cliente (CMEK) e a Transparência no acesso (AxT) não são aplicáveis.

Atualização e curadoria do índice

O índice da Web do embasamento na Web para empresas é selecionado automaticamente para atender às necessidades esperadas de clientes nos setores de saúde, finanças e público. Embora as programações de atualização específicas possam variar, o conteúdo de mudança rápida é atualizado a cada 6 horas, e todo o índice é atualizado a cada 24 horas.

Escolher um produto

A escolha da ferramenta de embasamento certa depende das necessidades específicas da sua organização em relação aos controles de compliance e à atualização necessária das informações.

  • Embasamento com a Pesquisa Google: essa é a opção recomendada para clientes que buscam a mais alta qualidade e atualização nas respostas embasadas. A atualização se relaciona à atualidade das informações da Web que estão sendo usadas para gerar a resposta. É fundamental para casos de uso em que o acesso às informações mais atualizadas e abrangentes da Web é essencial. O embasamento com a Pesquisa Google armazena registros de confiabilidade por até três dias, de acordo com os Termos específicos de serviço. Google não treina com dados do cliente processados pelo embasamento com a Pesquisa Google.

  • Embasamento na Web para empresas: essa solução foi projetada especificamente para clientes corporativos que têm requisitos de compliance rigorosos, que incluem "nenhum registro de dados do cliente". O embasamento na Web para empresas é a escolha preferencial para organizações em setores altamente regulamentados que exigem os controles de compliance adicionais. O embasamento na Web para empresas não armazena dados do cliente.

Modelos compatíveis

Esta seção lista os modelos que oferecem suporte ao embasamento na Web para empresas.

Clique para expandir os modelos compatíveis

O Gemini 3 Pro e o Gemini 3 Pro Image são limitados a 5.000 consultas de pesquisa por dia.

Usar a API

Esta seção fornece exemplos de solicitações de uso da API de IA generativa Gemini 2 na Gemini Enterprise Agent Platform para criar respostas embasadas com o Gemini. Para usar a API, defina os seguintes campos:

  • Contents.parts.text: a consulta de texto que os usuários querem enviar à API.
  • tools.enterpriseWebSearch: quando essa ferramenta é fornecida, o embasamento na Web para empresas pode ser usado pelo Gemini.

Python

Instalar

pip install --upgrade google-genai

Para saber mais, consulte a documentação de referência do SDK.

Defina variáveis de ambiente para usar o SDK de IA generativa do Google com a Vertex AI: 

# Replace the `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` values
# with appropriate values for your project.
export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT
export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_ENTERPRISE=True
 

from google import genai
from google.genai.types import (
    EnterpriseWebSearch,
    GenerateContentConfig,
    HttpOptions,
    Tool,
)

client = genai.Client(http_options=HttpOptions(api_version="v1"))

response = client.models.generate_content(
    model="gemini-3.5-flash",
    contents="When is the next total solar eclipse in the United States?",
    config=GenerateContentConfig(
        tools=[
            # Use Enterprise Web Search Tool
            Tool(enterprise_web_search=EnterpriseWebSearch())
        ],
    ),
)

print(response.text)
# Example response:
# 'The next total solar eclipse in the United States will occur on ...'

REST

Substitua as variáveis a seguir por valores:

  • PROJECT_NUMBER: seu número do projeto.
  • LOCATION: a região para processar a solicitação. Para usar o global endpoint, exclua o local do nome do endpoint e configure o local do recurso como global.
  • PROMPT: seu comando.
  curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" -H "x-server-timeout: 60" https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/publishers/google/models/gemini-2.5-flash:generateContent -d '
  {
    "contents": [{
      "role": "user",
      "parts": [{
        "text": PROMPT
      }]
    }],
    "tools": [{
      "enterpriseWebSearch": {
      }
    }]
  }
  '

Usar as sugestões da Pesquisa Google

Quando você usa o embasamento na Web para empresas e recebe sugestões de pesquisa na resposta, é necessário mostrar as sugestões de pesquisa na produção e nos aplicativos.

Especificamente, é necessário mostrar as consultas de pesquisa incluídas nos metadados da resposta embasada. A resposta inclui:

  • "content": a resposta gerada pelo LLM.
  • "webSearchQueries": as consultas a serem usadas para sugestões de pesquisa.

Por exemplo, no snippet de código a seguir, o Gemini responde a um comando baseado na Pesquisa que pergunta sobre um tipo de planta tropical.

"predictions": [
  {
    "content": "Monstera is a type of vine that thrives in bright indirect light…",
    "groundingMetadata": {
      "webSearchQueries": ["What's a monstera?"],
    }
  }
]

Use as sugestões de pesquisa para mostrar essa saída.

Requisitos para sugestões de pesquisa

Confira a seguir os requisitos para sugestões:

Requisito Descrição
O que fazer
O que não fazer
  • Inclua telas ou etapas adicionais entre o toque do usuário e a exibição do SRP.
  • Mostre outros resultados ou sugestões da pesquisa ao lado da sugestão de pesquisa ou da resposta do LLM fundamentada associada.

Requisitos de exibição

Confira a seguir os requisitos de exibição:

  • Mostre a sugestão de pesquisa exatamente como ela foi fornecida e não modifique as cores, as fontes ou a aparência. Verifique se a sugestão de pesquisa é renderizada conforme especificado nas simulações a seguir, como os modos claro e escuro:

  • Sempre que uma resposta fundamentada for exibida, a sugestão de pesquisa correspondente deverá permanecer visível.
  • Para branding, siga rigorosamente as diretrizes do Google para o uso de características da marca do Google por terceiros no Centro de recursos da marca.
  • Ao usar o embasamento na Web para empresas, os ícones de sugestão de pesquisa são exibidos. O campo que contém os ícones de sugestão precisa ter a mesma largura da resposta fundamentada do LLM.

Comportamento ao tocar

Quando um usuário toca no ícone, ele é direcionado para uma página de resultados da pesquisa (SRP) com o termo de pesquisa exibido no ícone. O SRP pode ser aberto no navegador no aplicativo ou em um aplicativo de navegador separado. É importante não minimizar, remover ou obstruir a exibição do SRP de maneira alguma. O modelo animado a seguir ilustra a interação do toque para o SRP.

exemplo de app/desktop

Código para implementar uma sugestão de pesquisa

Quando você usa a API para fundamentar uma resposta para a pesquisa, a resposta do modelo fornece estilo HTML e CSS compatível no campo renderedContent, que você implementa para mostrar sugestões de pesquisa no seu aplicativo.

A seguir

  • Para saber mais sobre como basear modelos do Gemini nos seus dados, consulte Embasamento com o Agent Search.
  • Para aprender sobre as práticas recomendadas de IA responsável e os filtros de segurança da Gemini Enterprise Agent Platform's, consulte IA responsável.