Fundamentação Web para empresas

Esta página descreve a fundamentação na Web para controlos de conformidade empresariais e como usar a API Web Grounding for Enterprise para gerar respostas fundamentadas 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, cuidados de saúde e o setor público.

Se não precisar dos controlos de conformidade adicionais, use o Ground com a Pesquisa Google, porque oferece acesso a um índice da Web mais amplo e ainda mais atualizado.

Vista geral

A fundamentação Web para empresas usa um índice Web que é usado para gerar respostas fundamentadas. O serviço não regista dados de clientes e suporta os VPC Service Controls. Para mais informações, consulte o artigo Controlos de segurança para IA generativa. Uma vez que não são mantidos dados de clientes, as chaves de encriptação geridas pelo cliente (CMEK) e a transparência de acesso (AxT) não são aplicáveis.

Atualidade e organização do índice

O índice da Web do Web Grounding for Enterprise é selecionado automaticamente para satisfazer as necessidades esperadas dos clientes nos verticais de cuidados de saúde, finanças e setor público. Embora os horários de atualização específicos possam variar, o conteúdo que muda rapidamente é atualizado a cada 6 horas e o índice completo é atualizado a cada 24 horas.

Escolher um produto

A escolha da ferramenta de fundamentação certa depende das necessidades específicas da sua organização relativamente aos controlos de conformidade e à atualidade das informações necessárias.

  • Fundamentação com a Pesquisa Google: esta é a opção recomendada para os clientes que procuram a mais alta qualidade e atualidade nas respetivas respostas fundamentadas. A atualidade refere-se à antiguidade das informações da Web que estão a ser usadas para gerar a resposta. É fundamental para exemplos de utilização em que o acesso às informações mais atualizadas e abrangentes da Web é essencial. A fundamentação com a Pesquisa Google armazena registos de fiabilidade durante um máximo de 30 dias, de acordo com os Termos Específicos do Serviço. Google não é preparada com dados de clientes processados pela fundamentação com a Pesquisa Google.

  • Fundamentação na Web para empresas: esta solução foi concebida especificamente para clientes empresariais que têm requisitos de conformidade rigorosos que incluem "não registar dados de clientes". A fundamentação na Web para empresas é a escolha preferencial para organizações em setores altamente regulamentados que requerem os controlos de conformidade adicionais. O Web Grounding for Enterprise não armazena dados de clientes.

Modelos suportados

Esta secção apresenta os modelos que suportam a fundamentação na Web para empresas.

Use a API

Esta secção fornece pedidos de exemplo da utilização da API de IA generativa Gemini 2 no Vertex AI para criar respostas fundamentadas com o Gemini. Para usar a API, tem de definir os seguintes campos:

  • Contents.parts.text: a consulta de texto que os utilizadores querem enviar para a API.
  • tools.enterpriseWebSearch: quando esta ferramenta é fornecida, o Gemini pode usar a fundamentação na Web para empresas.

Python

Instalação

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 gen com o 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_VERTEXAI=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-2.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 seguintes variáveis por valores:

  • PROJECT_NUMBER: o número do seu projeto.
  • LOCATION: a região para processar o pedido. Para usar o global endpoint, exclua a localização do nome do endpoint e configure a localização do recurso para global.
  • PROMPT: o 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.0-flash:generateContent -d '
  {
    "contents": [{
      "role": "user",
      "parts": [{
        "text": PROMPT
      }]
    }],
    "tools": [{
      "enterpriseWebSearch": {
      }
    }]
  }
  '

Use sugestões da Pesquisa Google

Quando usa a fundamentação na Web para empresas e recebe sugestões de pesquisa na sua resposta, tem de apresentar as sugestões de pesquisa em produção e nas suas aplicações.

Em concreto, tem de apresentar as consultas de pesquisa incluídas nos metadados da resposta fundamentada. A resposta inclui:

  • "content": a resposta gerada pelo MDI/CE.
  • "webSearchQueries": as consultas a usar para sugestões de pesquisa.

Por exemplo, no seguinte fragmento de código, 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?"],
    }
  }
]

Pode usar este resultado e apresentá-lo através de sugestões de pesquisa.

Requisitos para sugestões de pesquisa

Seguem-se os requisitos para sugestões:

Requisito Descrição
Fazer
  • Embora esteja em conformidade com os requisitos de apresentação, a sugestão de pesquisa é apresentada exatamente como fornecida, sem alterações.
  • Quando interage com a sugestão de pesquisa, é direcionado diretamente para a página de resultados da pesquisa (SRP).
O que não deve fazer
  • Inclua todos os ecrãs ou passos adicionais entre o toque do utilizador e a apresentação da página de resultados da pesquisa.
  • Apresentar outros resultados da pesquisa ou sugestões junto à sugestão de pesquisa ou à resposta do MDG fundamentado associado.

Requisitos da Rede de Display

Seguem-se os requisitos de apresentação:

  • Apresentar a sugestão de pesquisa exatamente como é fornecida e não fazer modificações nas cores, nos tipos de letra nem no aspeto. Certifique-se de que a sugestão de pesquisa é renderizada conforme especificado nos seguintes exemplos, como o modo claro e escuro:

  • Sempre que for apresentada uma resposta fundamentada, a sugestão de pesquisa correspondente deve permanecer visível.
  • Para a imagem corporativa, tem de seguir rigorosamente as diretrizes da Google para a utilização por terceiros das caraterísticas da marca Google, disponíveis no Centro de recursos da marca.
  • Quando usa a fundamentação na Web para empresas, são apresentados chips de sugestões de pesquisa. O campo que contém os chips de sugestões tem de ter a mesma largura que a resposta fundamentada do MDI/CE.

Comportamento ao tocar

Quando um utilizador toca no chip, é direcionado diretamente para uma página de resultados da pesquisa (SRP) para o termo de pesquisa apresentado no chip. A SRP pode ser aberta no navegador na aplicação ou numa aplicação de navegador separada. É importante não minimizar, remover nem obstruir a apresentação da página de resultados da pesquisa de forma alguma. A simulação animada seguinte ilustra a interação de tocar para aceder à página de resultados da pesquisa.

Exemplo de app/computador

Código para implementar uma sugestão de pesquisa

Quando usa a API para fundamentar uma resposta à pesquisa, a resposta do modelo fornece um estilo HTML e CSS compatível no campo renderedContent, que implementa para apresentar sugestões de pesquisa na sua aplicação.

O que se segue?