Parallel Web Systems propose une API de recherche qui donne accès à des données Web accessibles au public et optimisées pour être utilisées par des modèles de langage volumineux à des fins d'ancrage. Cette page explique comment ancrer des réponses Gemini à l'aide de Parallel.
L'ancrage avec Parallel sur Gemini Enterprise Agent Platform est une offre distincte (telle que définie dans votre Google Cloud contrat) qui connecte les modèles Gemini aux données Web publiques fournies par l'API de recherche de Parallel Web Systems'. Ce service permet à Gemini d'accéder à des informations en direct provenant de milliards de pages Web afin de fournir des réponses plus à jour et factuelles.
Cas d'utilisation
L'ancrage avec Parallel est adapté aux cas d'utilisation suivants, par exemple :
- Utilisation de données Web à des fins de complétion ou d'enrichissement d'informations.
- Agents multihops qui nécessitent des recherches Web plus approfondies pour des questions plus complexes.
- Création d'une API qui intègre des données de recherche Web.
- Assistants destinés aux employés qui permettent aux utilisateurs finaux de poser des questions et de créer des rapports complexes à l'aide des dernières informations Web.
- Applications en contact avec les clients, comme le commerce de détail et les voyages, qui permettent à l'utilisateur de prendre des décisions d'achat éclairées.
- Agents automatisés qui s'exécutent de manière autonome pour effectuer des tâches automatisées, telles que l'analyse de l'actualité et les vérifications KYC.
- Agents verticaux (agents commerciaux, agents de codage, agents financiers) qui obtiennent le contexte le plus récent sur le Web.
Exemple
Qui a remporté le Grand Prix de F1 de Las Vegas 2025 ?
| Sans ancrage | Avec ancrage |
|---|---|
| Le Grand Prix de Las Vegas 2025 n'a pas encore eu lieu. La course est prévue le week-end du 20 au 22 novembre 2025. Le vainqueur est donc inconnu. | Le vainqueur du Grand Prix de F1 de Las Vegas 2025 est Max Verstappen de Red Bull Racing. La course a eu lieu le 22 novembre 2025. Sources : domain1.com, domain2.com, ... |
Modèles compatibles
L'ancrage avec la recherche Web parallèle est compatible avec les modèles suivants :
- 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)
Avant de commencer
Pour utiliser l'ancrage avec la recherche Web parallèle, vous devez configurer votre accès. Vous avez deux possibilités :
Abonnez-vous directement à l'ancrage avec la recherche Web parallèle sur Google Cloud Marketplace pour une intégration simplifiée dans votre environnement cloud existant. Une offre de conservation zéro des données est également disponible pour les charges de travail sensibles. Pour utiliser la conservation zéro des données, vous devez être abonné à l'offre correspondante et définir l'indicateur
enable_zero_data_retentioncorrespondant dans vos requêtes API.Utilisez une clé API Parallel existante.
S'abonner sur Google Cloud Marketplace (recommandé)
L'intégration via Google Cloud Marketplace vous permet de gérer votre service d'ancrage avec la recherche Web parallèle directement dans Google Cloud. Pour commencer, abonnez-vous au service d'ancrage avec la recherche Web parallèle sur Google Cloud Marketplace, acceptez les conditions d'utilisation et consultez les tarifs.
Utiliser votre propre clé API
Si vous préférez gérer séparément votre facturation Parallel et votre accès à l'API, vous pouvez fournir votre propre clé API. Pour utiliser cette méthode, vous devez obtenir une clé API auprès de la plate-forme pour les développeurs Parallel. Cette clé API est utilisée directement dans vos requêtes API REST adressées à Gemini.
Ancrer des réponses Gemini avec Parallel
Demandez des réponses ancrées à Gemini à l'aide d' Agent Studio dans la Google Cloud console, du SDK Google Gen AI ou de l'API REST. Pour obtenir des performances optimales, nous vous recommandons d'utiliser les paramètres par défaut pour les paramètres facultatifs, sauf si vous avez absolument besoin de valeurs non par défaut.
Si vous vous êtes abonné à l'ancrage avec la recherche Web parallèle sur Google Cloud Marketplace , vérifiez que le compte de facturation utilisé pour votre abonnement est actif dans votre Google Cloud projet.
Avant d'exécuter les exemples, remplissez les prérequis, y compris l'abonnement sur Google Cloud Marketplace ou la fourniture d'une clé API Parallel.
Chaque exemple de SDK lit votre projet et votre emplacement à partir des variables d'environnement affichées dans son onglet. Dans l'exemple de code, remplacez MODEL_ID par un
ID de modèle compatible, tel que gemini-2.5-flash.
Console
Pour ancrer des réponses Gemini avec la recherche Web parallèle à l'aide d'Agent Studio sur Gemini Enterprise Agent Platform, procédez comme suit :
Dans la Google Cloud console, accédez à la page Agent Studio.
Dans le panneau latéral, sous Paramètres du modèle, dans la section Ancrage, activez le bouton Partenaires (Résultats de recherche des partenaires d'ancrage).
Sélectionnez Recherche Web parallèle comme partenaire d'ancrage, puis cliquez sur Appliquer. Pour utiliser la recherche Web parallèle, vous devez d'abord vous y abonner sur Google Cloud Marketplace.
Saisissez votre prompt dans la zone de texte et envoyez-le.
Vos réponses de requête utilisent désormais l'ancrage avec la recherche Web parallèle.
Python
Installer
pip install --upgrade google-genai
Pour en savoir plus, consultez la documentation de référence du SDK.
Définissez des variables d'environnement pour utiliser le SDK Google Gen AI avec 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)
Pour personnaliser la recherche, définissez le champ custom_configs de ToolParallelAiSearch. Ce champ accepte les mêmes paramètres facultatifs que ceux décrits dans l'onglet REST , tels que source_policy, excerpts, max_results et mode.
Java
Découvrez comment installer ou mettre à jour Java.
Pour en savoir plus, consultez la documentation de référence du SDK.
Définissez des variables d'environnement pour utiliser le SDK Google Gen AI avec 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());
}
}
}
Pour personnaliser la recherche, définissez le champ customConfigs de ToolParallelAiSearch. Ce champ accepte les mêmes paramètres facultatifs que ceux décrits dans l'onglet REST , tels que source_policy, excerpts, max_results et mode.
Node.js
Installer
npm install @google/genai
Pour en savoir plus, consultez la documentation de référence du SDK.
Définissez des variables d'environnement pour utiliser le SDK Google Gen AI avec 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);
Pour personnaliser la recherche, définissez le champ customConfigs de l'outil parallelAiSearch. Ce champ accepte les mêmes paramètres facultatifs que ceux décrits dans l'onglet REST , tels que source_policy, excerpts, max_results et mode.
REST
Avant d'utiliser les données de requête, effectuez les remplacements suivants :
- LOCATION : région dans laquelle traiter la requête. Pour utiliser le point de terminaison global, excluez l'emplacement du nom du point de terminaison et configurez l'emplacement de la ressource sur `global`.
- PROJECT_ID : ID de votre Google Cloud projet.
- MODEL_ID : ID du modèle à utiliser.
- TEXT : prompt textuel à envoyer au modèle.
- API_KEY : votre clé API pour la recherche Web parallèle. Si vous spécifiez une clé API et que vous êtes également abonné à l'ancrage avec la recherche Web parallèle sur Google Cloud Marketplace, la clé API est prioritaire.
- ENABLE_ZERO_DATA_RETENTION : facultatif : passez à la version de conservation zéro des données de la recherche Web parallèle pour activer la conservation zéro des données sur les charges de travail sensibles. Définissez la valeur sur
truepour utiliser l'offre de conservation zéro des données pour votre requête. Vous devez être abonné à l'offre spécifique de conservation zéro des données pour que ces requêtes aboutissent. Si aucune valeur n'est spécifiée, la version standard est utilisée par défaut. La version de conservation zéro des données n'est disponible que via Google Cloud Marketplace. - EXCLUDE_DOMAINS : facultatif : liste des domaines à exclure des sources d'ancrage. Si cette option est spécifiée, les sources de ces domaines sont exclues. Les valeurs acceptables sont les domaines (www.example.com) ou les extensions de domaine commençant par un point ( .gov, .edu, .co.uk). Vous pouvez spécifier jusqu'à 200 domaines.
- INCLUDE_DOMAINS : facultatif : liste des domaines à inclure dans les sources d'ancrage. Si cette option est spécifiée, les sources de ces domaines sont incluses. Les valeurs acceptables sont les domaines (www.example.com) ou les extensions de domaine commençant par un point ( .gov, .edu, .co.uk). Vous pouvez spécifier jusqu'à 200 domaines.
- MAX_CHARS_PER_RESULT : facultatif : nombre maximal de caractères à inclure dans chaque extrait de résultat de recherche. Si aucune valeur n'est spécifiée, la valeur par défaut est
à
30000. La plage autorisée est[1000, 100000]. - MAX_CHARS_TOTAL : facultatif : nombre total maximal
de caractères de tous les extraits de résultats de recherche. Si aucune valeur n'est spécifiée, la valeur par défaut est
100000. La plage autorisée est[1000, 1000000]. - MAX_RESULTS : facultatif : nombre maximal de résultats de recherche
à utiliser pour l'ancrage. Si aucune valeur n'est spécifiée, la valeur par défaut est
10. La plage autorisée est[1, 20]. - MODE : facultatif : mode à utiliser pour la requête
basicouadvanced. La valeur par défaut estbasic. Envisagez le modeadvancedsi vous souhaitez obtenir des résultats de recherche plus complets, mais avec une latence plus élevée. - SEARCH_LOCATION : facultatif : code pays ISO 3166-1 alpha-2 pour les résultats de recherche géociblés. Exemple :
"us".
Méthode HTTP et URL :
POST https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:generateContent
Corps JSON de la requête :
{
"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"
}
Pour envoyer votre requête, développez l'une des options suivantes :
Vous devriez recevoir une réponse JSON semblable à la suivante.
Quota
Le quota par défaut est de 200 prompts par minute. Pour demander une augmentation de vos limites de débit, indiquez votre cas d'utilisation et vos exigences au contact approprié :
Si vous vous êtes abonné à l'ancrage avec la recherche Web parallèle sur Google Cloud Marketplace : contactez l'équipe responsable de votre compte Google.
Si vous fournissez votre propre clé API : contactez support@parallel.ai et l'équipe responsable de votre compte Google.
Facturation
L'utilisation de l'ancrage avec la recherche Web parallèle entraîne les frais suivants :
Consommation de jetons Gemini : vous pouvez être facturé pour :
- les jetons de prompt
- les jetons de raisonnement
- les jetons de sortie
Pour en savoir plus, reportez-vous à la section Tarification.
Ancrage de Gemini avec vos données : pour en savoir plus, consultez la section Tarification.
Tarifs d'utilisation de l'API de recherche Web parallèle :
Si vous vous êtes abonné à l'ancrage avec la recherche Web parallèle sur Google Cloud Marketplace, consultez la section Tarifs de Parallel sur Google Cloud Marketplace pour en savoir plus.
Si vous fournissez votre propre clé API, consultez le site Web de Parallel pour en savoir plus.