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, use o Ground com a Pesquisa Google, porque oferece acesso a um índice da Web mais amplo.

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. 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.

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 generativa 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 sua região.
  • TEXT: 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": TEXT
      }]
    }],
    "tools": [{
      "enterpriseWebSearch": {
      }
    }]
  }
  '

O que se segue?