O Parallel Web Systems (em inglês) oferece uma API de pesquisa que dá acesso a dados da Web disponíveis publicamente e otimizados para uso por modelos de linguagem grandes para embasamento. Nesta página, explicamos como restringir as respostas do Gemini usando o Parallel.
O embasamento com a Parallel na Gemini Enterprise Agent Platform é uma oferta separada (conforme definido no seu Contrato Google Cloud ) que conecta os modelos do Gemini a dados da Web públicos fornecidos pela API de pesquisa da Parallel Web Systems. Esse serviço dá ao Gemini acesso a informações atualizadas de bilhões de páginas da Web para garantir respostas mais atuais e factuais.
Casos de uso
O embasamento com Parallel é adequado para casos de uso como os seguintes:
- Usar dados da Web para fins de conclusão ou enriquecimento de informações.
- Agentes de várias etapas que exigem pesquisas na Web mais profundas para perguntas mais complexas.
- Como criar uma API que integra dados de pesquisa na Web.
- Assistentes voltados para funcionários que permitem aos usuários finais fazer perguntas e criar relatórios complexos usando as informações mais recentes da Web.
- Aplicativos voltados ao consumidor, como varejo e viagens, que permitem ao usuário tomar decisões de compra fundamentadas.
- Agentes automatizados que são executados de forma autônoma para realizar tarefas automatizadas, como análise de notícias e verificações de KYC.
- Agentes verticais (de vendas, programação, finanças) recebendo o contexto mais recente e atualizado da Web.
Exemplo
Quem ganhou o Grande Prêmio de F1 de Las Vegas de 2025?
| Sem embasamento | Com embasamento |
|---|---|
| O Grande Prêmio de Las Vegas de 2025 ainda não aconteceu. A corrida está programada para acontecer no fim de semana de 20 a 22 de novembro de 2025. Portanto, o vencedor é desconhecido. | O vencedor do Grande Prêmio de F1 de Las Vegas de 2025 foi Max Verstappen, da Red Bull Racing. A corrida aconteceu em 22 de novembro de 2025. Fontes:domínio1.com, domínio2.com, ... |
Modelos compatíveis
O embasamento com a Pesquisa Google Paralela na Web é compatível com os seguintes modelos:
- Gemini 2.5 Flash (
gemini-2.5-flash) - Gemini 2.5 Flash-Lite (
gemini-2.5-flash-lite) - Gemini 2.5 Pro (
gemini-2.5-pro) - Gemini 3.1 Pro (
gemini-3.1-pro-preview) - Gemini 3.1 Flash Lite (
gemini-3.1-flash-lite) - Gemini 3.5 Flash (
gemini-3.5-flash)
Antes de começar
Para usar o embasamento com a Pesquisa Google Paralela na Web, configure seu acesso. Você tem duas opções:
Assine o Grounding com a pesquisa paralela na Web diretamente no Google Cloud Marketplace para uma integração simplificada no seu ambiente de nuvem atual. Uma oferta de retenção de dados zero também está disponível para cargas de trabalho sensíveis. Para usar a ZDR, você precisa assinar a oferta e definir a flag
enable_zero_data_retentioncorrespondente nas solicitações de API.Use uma chave de API do Parallel existente.
Assinar no Google Cloud Marketplace (recomendado)
A integração pelo Google Cloud Marketplace permite gerenciar o serviço de embasamento com pesquisa paralela na Web diretamente no Google Cloud. Para começar, assine o serviço de embasamento com pesquisa paralela na Web no Google Cloud Marketplace, aceite os Termos de Serviço e confira os preços.
Traga sua própria chave de API
Se preferir gerenciar o faturamento paralelo e o acesso à API separadamente, forneça sua própria chave de API. Para usar esse método, você precisa receber uma chave de API da plataforma para desenvolvedores do Parallel. Essa chave de API é usada diretamente nas suas solicitações da API REST para o Gemini.
Embasar respostas do Gemini com o recurso Paralelo
Solicite respostas embasadas do Gemini usando o Agent Studio no console Google Cloud , o SDK de IA Generativa do Google ou a API REST. Para ter o melhor desempenho, recomendamos usar as configurações padrão para parâmetros opcionais, a menos que você precise de valores não padrão.
Se você assinou o Grounding com a pesquisa paralela na Web no Google Cloud Marketplace , verifique se a conta de faturamento usada na assinatura está ativa no seu projetoGoogle Cloud .
Antes de executar as amostras, conclua os pré-requisitos, incluindo fazer uma assinatura no Google Cloud Marketplace ou fornecer uma chave da API Parallel.
Cada exemplo de SDK lê seu projeto e local nas variáveis de ambiente
mostradas na guia. No exemplo de código, substitua MODEL_ID pelo ID de um modelo compatível, como gemini-2.5-flash.
Console
Para embasar as respostas do Gemini com a pesquisa paralela na Web usando o Agent Studio na Gemini Enterprise Agent Platform, siga estas etapas:
No console Google Cloud , acesse a página Agent Studio.
No painel lateral, em Configurações do modelo, na seção Embasamento, ative a opção Parceiros (Resultados da pesquisa de parceiros de embasamento).
Selecione Pesquisa na Web paralela como o parceiro de embasamento e clique em Aplicar. Para usar a pesquisa paralela na Web, primeiro é necessário assinar o serviço no Google Cloud Marketplace.
Insira o comando na caixa de texto e envie.
Agora, suas respostas aos comandos usam o Embasamento com a Pesquisa Google Paralela na Web.
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 import types
client = genai.Client()
response = client.models.generate_content(
model="MODEL_ID",
contents="Who won the 2025 Las Vegas F1 Grand Prix?",
config=types.GenerateContentConfig(
tools=[
types.Tool(
parallel_ai_search=types.ToolParallelAiSearch(
# Optional. Omit api_key if you subscribed to Grounding with
# Parallel Web Search on Google Cloud Marketplace. Otherwise,
# provide your Parallel API key.
# api_key="API_KEY",
# Optional. Customize the search. See the REST tab for the
# full list of supported parameters. Keys inside custom_configs
# are Parallel.ai Search API params (snake_case).
custom_configs={
"mode": "basic",
"max_results": 10,
"source_policy": {"include_domains": ["wikipedia.org"]},
},
)
)
],
),
)
print(response.text)
# Example response:
# Max Verstappen won the 2025 Las Vegas F1 Grand Prix ...
# The grounding metadata contains the web sources used to ground the response.
print(response.candidates[0].grounding_metadata.grounding_chunks)
Para personalizar a pesquisa, defina o campo custom_configs de ToolParallelAiSearch. Esse campo aceita os mesmos parâmetros opcionais descritos na guia REST, como source_policy, excerpts, max_results e mode.
Java
Saiba como instalar ou atualizar o Java.
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
import com.google.genai.Client;
import com.google.genai.types.GenerateContentConfig;
import com.google.genai.types.GenerateContentResponse;
import com.google.genai.types.Tool;
import com.google.genai.types.ToolParallelAiSearch;
import java.util.List;
import java.util.Map;
public class ParallelGroundingSample {
public static void main(String[] args) {
try (Client client = Client.builder().build()) {
GenerateContentConfig config =
GenerateContentConfig.builder()
.tools(
// Omit apiKey if you subscribed to Grounding with Parallel Web
// Search on Google Cloud Marketplace. Otherwise, set apiKey to
// your Parallel API key.
Tool.builder()
.parallelAiSearch(
ToolParallelAiSearch.builder()
// Optional. Customize the search. See the REST tab
// for the full list of supported parameters. Keys
// inside customConfigs are Parallel.ai Search API
// params (snake_case).
.customConfigs(
Map.of(
"mode", "basic",
"max_results", 10,
"source_policy",
Map.of(
"include_domains",
List.of("wikipedia.org"))))
.build())
.build())
.build();
GenerateContentResponse response =
client.models.generateContent(
"MODEL_ID", "Who won the 2025 Las Vegas F1 Grand Prix?", config);
System.out.println(response.text());
}
}
}
Para personalizar a pesquisa, defina o campo customConfigs de ToolParallelAiSearch. Esse campo aceita os mesmos parâmetros opcionais descritos na guia REST, como source_policy, excerpts, max_results e mode.
Node.js
Instalar
npm install @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
import {GoogleGenAI} from '@google/genai';
const ai = new GoogleGenAI({});
const response = await ai.models.generateContent({
model: 'MODEL_ID',
contents: 'Who won the 2025 Las Vegas F1 Grand Prix?',
config: {
tools: [
// Omit apiKey if you subscribed to Grounding with Parallel Web Search on
// Google Cloud Marketplace. Otherwise, set apiKey to your Parallel API key.
{
parallelAiSearch: {
// Optional. Customize the search. See the REST tab for the full
// list of supported parameters. Keys inside customConfigs are
// Parallel.ai Search API params (snake_case).
customConfigs: {
mode: 'basic',
max_results: 10,
source_policy: {include_domains: ['wikipedia.org']},
},
},
},
],
},
});
console.log(response.text);
Para personalizar a pesquisa, defina o campo customConfigs da ferramenta parallelAiSearch. Esse campo aceita os mesmos parâmetros opcionais descritos na guia REST, como source_policy, excerpts, max_results e mode.
REST
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- LOCATION: a região para processar a solicitação. Para usar o endpoint global, exclua o local do nome do endpoint e configure o local do recurso como "global".
- PROJECT_ID: o ID do projeto do Google Cloud .
- MODEL_ID: o ID do modelo que será usado.
- TEXT: o comando de texto a ser enviado para o modelo.
- API_KEY: sua chave de API para a Pesquisa na Web paralela. Se você especificar uma chave de API e também tiver uma assinatura do Grounding com pesquisa paralela na Web no Google Cloud Marketplace, a chave de API terá precedência.
- ENABLE_ZERO_DATA_RETENTION: opcional. Mude para a versão ZDR da Pesquisa Paralela na Web para ativar a retenção de dados zero em cargas de trabalho sensíveis. Defina como
truepara usar a oferta de ZDR na sua solicitação. Você precisa ter uma assinatura da oferta específica do ZDR para que essas solicitações sejam bem-sucedidas. Se não for especificado, o padrão será a versão padrão. A versão do ZDR está disponível apenas no Google Cloud Marketplace. - EXCLUDE_DOMAINS: opcional. Lista de domínios a serem excluídos das fontes de embasamento. Se especificado, as fontes desses domínios serão excluídas. Os valores aceitáveis são domínios (www.example.com) ou extensões de domínio que começam com um ponto ( .gov, .edu, .co.uk). É possível especificar até 200 domínios.
- INCLUDE_DOMAINS (opcional): lista de domínios a serem incluídos nas fontes de embasamento. Se especificado, as fontes desses domínios serão incluídas. Os valores aceitáveis são domínios (www.example.com) ou extensões de domínio que começam com um ponto ( .gov, .edu, .co.uk). É possível especificar até 200 domínios.
- MAX_CHARS_PER_RESULT: opcional. O número máximo de caracteres a serem incluídos em cada trecho de resultado da pesquisa. Se não for especificado, o padrão será
30000. O intervalo permitido é[1000, 100000]. - MAX_CHARS_TOTAL: opcional. O número máximo total de caracteres de todos os trechos de resultados da pesquisa. Se não for especificado,
100000será usado como padrão para . O intervalo permitido é[1000, 1000000]. - MAX_RESULTS: opcional. O número máximo de resultados da pesquisa a serem usados para embasamento. Se não for especificado,
10será usado como padrão para . O intervalo permitido é[1, 20]. - MODE (opcional): modo a ser usado na solicitação,
basicouadvanced. O padrão ébasic. Considere o modoadvancedse quiser resultados de pesquisa mais completos, mas com maior latência. - SEARCH_LOCATION: opcional: código do país ISO 3166-1 alfa-2 para resultados de pesquisa segmentados por região geográfica. Exemplo:
"us".
Método HTTP e URL:
POST https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:generateContent
Corpo JSON da solicitação:
{
"contents": [{
"role": "user",
"parts": [{
"text": "TEXT"
}]
}],
"tools": [{
"parallelAiSearch": {
"api_key": "API_KEY",
"enable_zero_data_retention": ENABLE_ZERO_DATA_RETENTION,
"customConfigs": {
"mode": "MODE",
"location": "SEARCH_LOCATION",
"max_results": MAX_RESULTS,
"source_policy": {
"exclude_domains": ["EXCLUDE_DOMAINS"],
"include_domains": ["INCLUDE_DOMAINS"]
},
"excerpts": {
"max_chars_per_result": MAX_CHARS_PER_RESULT,
"max_chars_total": MAX_CHARS_TOTAL
}
}
}
}],
"model": "projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID"
}
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a seguinte.
Cota
A cota padrão é de 200 comandos por minuto. Para pedir um aumento nos limites de taxa, informe seu caso de uso e requisitos ao contato adequado:
Se você assinou o Grounding com a pesquisa paralela na Web no Google Cloud Marketplace:entre em contato com a equipe da sua Conta do Google.
Se você fornecer sua própria chave de API:entre em contato com support@parallel.ai e com a equipe da sua Conta do Google.
Faturamento
O uso do embasamento com a Pesquisa Google Paralela na Web gera as seguintes cobranças:
Consumo de tokens do Gemini:você pode receber cobranças por:
- Tokens de comando
- Tokens de raciocínio
- Tokens de saída
Para saber mais informações, consulte Preços.
Fundamentação do Gemini com seus dados:para mais informações, consulte Preços.
Preços para o uso da API Parallel Web Search:
Se você assinou o Grounding com a pesquisa paralela na Web no Google Cloud Marketplace, consulte a seção Preços paralelos no Google Cloud Marketplace para mais informações.
Se você fornecer sua própria chave de API, consulte o site paralelo para mais informações.