Ancrage avec la recherche Web parallèle

Parallel Web Systems propose une API de recherche qui permet d'accéder aux données Web accessibles au public, optimisées pour être utilisées par les grands modèles de langage pour l'ancrage. Cette page explique comment ancrer les 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 Contrat Cloud de Confiance by S3NS ) 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 temps réel provenant de milliards de pages Web afin de fournir des réponses plus récentes et factuelles.

Cas d'utilisation

L'ancrage avec la recherche parallèle est adapté aux cas d'utilisation suivants :

  • Utilisation de données Web pour compléter ou enrichir des informations
  • Agents multihops qui nécessitent des recherches Web plus approfondies pour les questions plus complexes.
  • Créer une API qui intègre des données de recherche sur le 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 celles de vente au détail et de voyage, 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, comme l'analyse de l'actualité et les vérifications KYC.
  • Agents verticaux (agents de vente, agents de codage, agents financiers) obtenant le contexte le plus récent sur le Web.

Exemple

Qui a remporté le Grand Prix de F1 de Las Vegas en 2025 ?

Sans ancrage Avec mise à la terre
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. Par conséquent, le gagnant est inconnu. Le vainqueur du Grand Prix de F1 de Las Vegas en 2025 était Max Verstappen de Red Bull Racing. La course a eu lieu le 22 novembre 2025. Sources : domain1.com, domain2.com, ...

Modèles compatibles

Cette section liste les modèles compatibles avec l'ancrage avec la recherche sur le Web parallèle.

Cliquer pour développer les modèles compatibles

Avant de commencer

Pour utiliser l'ancrage avec la recherche sur le Web parallèle, vous devez configurer votre accès. Deux options s'offrent à vous :

  • Abonnez-vous directement à l'ancrage avec la recherche sur le Web parallèle sur Google Cloud Marketplace pour une intégration simplifiée dans votre environnement cloud existant. Une offre de conservation des données nulle est également disponible pour les charges de travail sensibles. Pour utiliser ZDR, vous devez être abonné à l'offre ZDR et définir l'indicateur enable_zero_data_retention correspondant 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 Cloud de Confiance by S3NS. Pour commencer, abonnez-vous au service Grounding with Parallel Web Search 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 et votre accès aux API Parallel, vous pouvez fournir votre propre clé API. Pour utiliser cette méthode, vous devez obtenir une clé API sur la plate-forme pour les développeurs Parallel. Cette clé API est utilisée directement dans vos requêtes d'API REST à Gemini.

Ancrer les réponses de Gemini avec Parallel

Demandez des réponses ancrées à Gemini à l'aide d'Agent Studio dans la console Cloud de Confiance , du SDK Google Gen AI ou de l'API REST. Pour 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 définies par défaut.

Si vous vous êtes abonné à l'ancrage avec la recherche sur le Web parallèle sur Google Cloud Marketplace, vérifiez que le compte de facturation utilisé pour votre abonnement est actif dans votre projetCloud de Confiance by S3NS .

Avant d'exécuter les exemples, remplissez les conditions préalables, y compris vous abonner sur Google Cloud Marketplace ou fournir une clé API Parallel.

Console

Pour ancrer les réponses de Gemini avec la recherche Web parallèle à l'aide d'Agent Studio sur Gemini Enterprise Agent Platform, procédez comme suit :

  1. Dans la console Cloud de Confiance , accédez à la page Agent Studio.

    Accéder à Agent Studio

  2. Dans le panneau latéral, sous Paramètres du modèle, dans la section Ancrage, activez le bouton Partenaires (Résultats de recherche issus des partenaires d'ancrage).

  3. Sélectionnez Parallel Web Search 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.

  4. Saisissez votre prompt dans la zone de texte et envoyez-le.

Vos réponses aux requêtes utilisent désormais l'ancrage avec la recherche sur le 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

Avant d'exécuter l'exemple, effectuez les remplacements suivants :

  • MODEL_ID : ID d'un modèle compatible à utiliser, tel que gemini-2.5-flash.
  • TEXT : prompt textuel à envoyer au modèle.
  • API_KEY : votre clé API pour la recherche sur le Web parallèle. Omettez ce paramètre si vous êtes abonné sur Google Cloud Marketplace. Si les deux sont fournis, la clé API est prioritaire.
  • EXCLUDE_DOMAINS : (facultatif) liste des domaines à exclure des sources d'ancrage. Si des domaines sont spécifiés, les sources provenant de ces domaines sont exclues. Les valeurs acceptées 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 ce champ est spécifié, les sources de ces domaines sont incluses. Les valeurs acceptées 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 maximal de caractères total 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, basic ou advanced. La valeur par défaut est basic. Envisagez le mode advanced si vous souhaitez obtenir des résultats de recherche plus complets au détriment d'une latence plus élevée.
  • SEARCH_LOCATION : facultatif : code pays ISO 3166-1 alpha-2 pour les résultats de recherche ciblés géographiquement. Exemple : "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

Découvrez comment installer ou mettre à jour le 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

Avant d'exécuter l'exemple, effectuez les remplacements suivants :

  • MODEL_ID : ID d'un modèle compatible à utiliser, tel que gemini-2.5-flash.
  • TEXT : prompt textuel à envoyer au modèle.
  • API_KEY : votre clé API pour la recherche sur le Web parallèle. Omettez ce paramètre si vous êtes abonné sur Google Cloud Marketplace. Si les deux sont fournis, la clé API est prioritaire.
  • EXCLUDE_DOMAINS : (facultatif) liste des domaines à exclure des sources d'ancrage. Si des domaines sont spécifiés, les sources provenant de ces domaines sont exclues. Les valeurs acceptées 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 ce champ est spécifié, les sources de ces domaines sont incluses. Les valeurs acceptées 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 maximal de caractères total 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, basic ou advanced. La valeur par défaut est basic. Envisagez le mode advanced si vous souhaitez obtenir des résultats de recherche plus complets au détriment d'une latence plus élevée.
  • SEARCH_LOCATION : facultatif : code pays ISO 3166-1 alpha-2 pour les résultats de recherche ciblés géographiquement. Exemple : "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

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

Avant d'exécuter l'exemple, effectuez les remplacements suivants :

  • MODEL_ID : ID d'un modèle compatible à utiliser, tel que gemini-2.5-flash.
  • TEXT : prompt textuel à envoyer au modèle.
  • API_KEY : votre clé API pour la recherche sur le Web parallèle. Omettez ce paramètre si vous êtes abonné sur Google Cloud Marketplace. Si les deux sont fournis, la clé API est prioritaire.
  • EXCLUDE_DOMAINS : (facultatif) liste des domaines à exclure des sources d'ancrage. Si des domaines sont spécifiés, les sources provenant de ces domaines sont exclues. Les valeurs acceptées 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 ce champ est spécifié, les sources de ces domaines sont incluses. Les valeurs acceptées 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 maximal de caractères total 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, soit basic, soit advanced. La valeur par défaut est basic. Envisagez le mode advanced si vous souhaitez obtenir des résultats de recherche plus complets au détriment d'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".

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

Avant d'utiliser des 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 projet Cloud de Confiance by S3NS .
  • MODEL_ID : ID d'un modèle compatible à utiliser, tel que gemini-2.5-flash.
  • TEXT : prompt textuel à envoyer au modèle.
  • API_KEY : votre clé API pour la recherche sur le Web parallèle. Omettez ce paramètre si vous êtes abonné sur Google Cloud Marketplace. Si les deux sont fournis, la clé API est prioritaire.
  • EXCLUDE_DOMAINS : (facultatif) liste des domaines à exclure des sources d'ancrage. Si des domaines sont spécifiés, les sources provenant de ces domaines sont exclues. Les valeurs acceptées 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 ce champ est spécifié, les sources de ces domaines sont incluses. Les valeurs acceptées 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 maximal de caractères total 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, soit basic, soit advanced. La valeur par défaut est basic. Envisagez le mode advanced si 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 ciblés géographiquement. Exemple : "us".
  • ENABLE_ZERO_DATA_RETENTION : (Facultatif) Passez à la version ZDR de la recherche Web parallèle pour activer la conservation zéro des données sur les charges de travail sensibles. Définissez cette option sur true pour utiliser l'offre ZDR pour votre requête. Vous devez être abonné à l'offre spécifique à la ZDR 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 ZDR n'est disponible que sur Google Cloud Marketplace.

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 requêtes 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 sur le Web parallèle sur Google Cloud Marketplace : contactez l'équipe chargée de votre compte Google.

  • Si vous fournissez votre propre clé API : contactez support@parallel.ai et l'équipe de votre compte Google.

Facturation

L'utilisation de l'ancrage avec la recherche sur le Web parallèle entraîne les frais suivants :

  • Consommation de jetons Gemini : vous pouvez être facturé pour :

    • Jetons de prompt
    • Jetons de raisonnement
    • Jetons de sortie

    Pour en savoir plus, reportez-vous à la section Tarification.

  • Ancrage de Gemini sur vos données : pour en savoir plus, consultez la page Tarifs.

  • Tarifs de l'utilisation de l'API Parallel Web Search :

    • Si vous vous êtes abonné à l'ancrage avec la recherche sur le Web parallèle sur Google Cloud Marketplace, consultez la section Tarifs de la recherche parallèle sur Google Cloud Marketplace pour en savoir plus.

    • Si vous fournissez votre propre clé API, consultez le site Web parallèle pour en savoir plus.