O Parallel Web Systems 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 embasar 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 em tempo real de bilhões de páginas da Web para garantir respostas mais atualizadas e factuais.
Casos de uso
O embasamento com o Parallel é adequado para casos de uso como os seguintes:
- Usar dados da Web para fins de preenchimento ou enriquecimento de informações.
- Agentes de vários saltos que exigem pesquisas mais profundas na Web para perguntas mais complexas.
- Criar uma API que integra dados de pesquisa na Web.
- Assistentes para funcionários que permitem que os usuários finais façam perguntas e criem 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 (agentes de vendas, de programação, de finanças) recebendo o contexto mais recente da Web.
Exemplo
Quem ganhou o Grande Prêmio de Las Vegas de F1 de 2025?
| Sem embasamento | Com embasamento |
|---|---|
| O Grande Prêmio de Las Vegas de 2025 ainda não aconteceu. A corrida está programada para o fim de semana de 20 a 22 de novembro de 2025. Portanto, o vencedor é desconhecido. | O vencedor do Grande Prêmio de Las Vegas de F1 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
Esta seção lista os modelos que oferecem suporte ao embasamento com a Pesquisa na Web Paralela.
Clique para abrir os modelos compatíveis
Antes de começar
Para usar o embasamento com a Pesquisa Google Paralela na Web, é necessário configurar seu acesso. Você tem duas opções:
Assine o Grounding com a Pesquisa Google na Web Paralela 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 o ZDR, você precisa assinar a oferta e definir a flag
enable_zero_data_retentioncorrespondente nas solicitações de API.Use uma chave de API da 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 e o acesso à API do Parallel separadamente, forneça sua própria chave de API. Para usar esse método, você precisa de uma chave de API da plataforma para desenvolvedores do Parallel. Essa chave de API é usada diretamente nas solicitações de API REST para o Gemini.
Embasar as respostas do Gemini com o Parallel
Solicite respostas embasadas do Gemini usando o Agent Studio no console do 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 Google Cloud projeto.
Antes de executar os exemplos, conclua os pré-requisitos, incluindo fazer uma assinatura no Google Cloud Marketplace ou fornecer uma chave de API Parallel.
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 do 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 fazer uma assinatura 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 na Web Paralela.
Python
Instalar
pip install --upgrade google-genai
Para mais informações, 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
Antes de executar o exemplo, faça as seguintes substituições:
- MODEL_ID: o ID de um modelo compatível a ser usado, como
gemini-2.5-flash. - TEXT: o comando de texto a ser enviado para o modelo.
- API_KEY: sua chave de API para a Pesquisa na Web paralela. Omita esse parâmetro se você tiver uma assinatura no Google Cloud Marketplace. Se os dois forem fornecidos, a chave de API terá precedência.
- 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 do resultado da pesquisa. Se não for especificado, o padrão será
30000. O intervalo permitido é[1000, 100000]. - MAX_CHARS_TOTAL (opcional): o total máximo 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 para a solicitação,
basicouadvanced. O padrão ébasic. Considere o modoadvancedse quiser resultados da pesquisa mais completos, mas com maior latência. - SEARCH_LOCATION: opcional: código de país ISO 3166-1 alfa-2 para resultados de pesquisa segmentados por área geográfica. Exemplo:
"us".
from google import genai
from google.genai import types
client = genai.Client()
response = client.models.generate_content(
model="MODEL_ID",
contents="TEXT",
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.
api_key="API_KEY",
# Optional. Set to True to use Zero Data Retention (ZDR) for
# sensitive workloads. Requires a separate ZDR Marketplace
# subscription; defaults to the standard subscription.
enable_zero_data_retention=True,
# Optional. Customize the search. Click a placeholder to
# enter a value, or remove the line to accept the default.
custom_configs={
"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,
},
},
)
)
],
),
)
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)
Java
Saiba como instalar ou atualizar o Java.
Para mais informações, 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
Antes de executar o exemplo, faça as seguintes substituições:
- MODEL_ID: o ID de um modelo compatível a ser usado, como
gemini-2.5-flash. - TEXT: o comando de texto a ser enviado ao modelo.
- API_KEY: sua chave de API para a Pesquisa na Web paralela. Omita esse parâmetro se você tiver uma assinatura no Google Cloud Marketplace. Se os dois forem fornecidos, a chave de API terá precedência.
- 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 do resultado da pesquisa. Se não for especificado, o padrão será
30000. O intervalo permitido é[1000, 100000]. - MAX_CHARS_TOTAL (opcional): o total máximo 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 para a solicitação,
basicouadvanced. O padrão ébasic. Considere o modoadvancedse quiser resultados da pesquisa mais completos, mas com maior latência. - SEARCH_LOCATION: opcional: código de país ISO 3166-1 alfa-2 para resultados de pesquisa segmentados por área geográfica. Exemplo:
"us".
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(
Tool.builder()
.parallelAiSearch(
ToolParallelAiSearch.builder()
// Optional. Omit apiKey if you subscribed to
// Grounding with Parallel Web Search on Google
// Cloud Marketplace.
.apiKey("API_KEY")
// Optional. Set to true to use Zero Data
// Retention (ZDR) for sensitive workloads.
// Requires a separate ZDR Marketplace
// subscription; defaults to the standard
// subscription.
.enableZeroDataRetention(true)
// Optional. Customize the search. Click a
// placeholder to enter a value, or remove the
// entry to accept the default.
.customConfigs(
Map.of(
"mode", "MODE",
"location", "SEARCH_LOCATION",
"max_results", MAX_RESULTS,
"source_policy",
Map.of(
"exclude_domains",
List.of("EXCLUDE_DOMAINS"),
"include_domains",
List.of("INCLUDE_DOMAINS")),
"excerpts",
Map.of(
"max_chars_per_result",
MAX_CHARS_PER_RESULT,
"max_chars_total",
MAX_CHARS_TOTAL)))
.build())
.build())
.build();
GenerateContentResponse response =
client.models.generateContent(
"MODEL_ID", "TEXT", config);
System.out.println(response.text());
}
}
}
Node.js
Instalar
npm install @google/genai
Para mais informações, 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
Antes de executar o exemplo, faça as seguintes substituições:
- MODEL_ID: o ID de um modelo compatível a ser usado, como
gemini-2.5-flash. - TEXT: o comando de texto a ser enviado para o modelo.
- API_KEY: sua chave de API para a Pesquisa na Web paralela. Omita esse parâmetro se você tiver uma assinatura no Google Cloud Marketplace. Se os dois forem fornecidos, a chave de API terá precedência.
- 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 do resultado da pesquisa. Se não for especificado, o padrão será
30000. O intervalo permitido é[1000, 100000]. - MAX_CHARS_TOTAL (opcional): o total máximo 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 para a solicitação,
basicouadvanced. O padrão ébasic. Considere o modoadvancedse quiser resultados da pesquisa mais completos, mas com maior latência. - SEARCH_LOCATION: opcional: código do país ISO 3166-1 alfa-2 para resultados da pesquisa segmentados por região geográfica. Exemplo:
"us".
import {GoogleGenAI} from '@google/genai';
const ai = new GoogleGenAI({});
const response = await ai.models.generateContent({
model: 'MODEL_ID',
contents: 'TEXT',
config: {
tools: [
{
parallelAiSearch: {
// Optional. Omit apiKey if you subscribed to Grounding with Parallel
// Web Search on Google Cloud Marketplace.
apiKey: 'API_KEY',
// Optional. Set to true to use Zero Data Retention (ZDR) for
// sensitive workloads. Requires a separate ZDR Marketplace
// subscription; defaults to the standard subscription.
enableZeroDataRetention: true,
// Optional. Customize the search. Click a placeholder to enter a
// value, or remove the line to accept the default.
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,
},
},
},
},
],
},
});
console.log(response.text);
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 de um modelo compatível a ser usado, como
gemini-2.5-flash. - TEXT: o comando de texto a ser enviado ao modelo.
- API_KEY: sua chave de API para a Pesquisa na Web paralela. Omita esse parâmetro se você tiver uma assinatura no Google Cloud Marketplace. Se os dois forem fornecidos, a chave de API terá precedência.
- 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 do resultado da pesquisa. Se não for especificado, o padrão será
30000. O intervalo permitido é[1000, 100000]. - MAX_CHARS_TOTAL (opcional): o total máximo 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 para a solicitação,
basicouadvanced. O padrão ébasic. Considere o modoadvancedse quiser resultados da pesquisa mais completos, mas com maior latência. - SEARCH_LOCATION: opcional: código de país ISO 3166-1 alfa-2 para resultados de pesquisa segmentados por área geográfica. Exemplo:
"us". - ENABLE_ZERO_DATA_RETENTION: opcional: mude para a versão ZDR da Pesquisa Google na web paralela 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 se inscrever na oferta específica de ZDR para que essas solicitações sejam bem-sucedidas. Se não for especificada, o padrão será a versão padrão. A versão ZDR só está disponível no Google Cloud Marketplace.
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 solicitar um aumento nos limites de taxa, informe seu caso de uso e requisitos ao contato apropriado:
Se você assinou o embasamento com a Pesquisa Google 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 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 do uso da API Parallel Web Search:
Se você assinou o embasamento com a Pesquisa Google na Web paralela 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.