Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Ancrage avec la recherche Web parallèle

Parallel Web Systems propose une API de recherche qui permet d'accéder à des données Web accessibles au public et optimisées pour être utilisées par les grands modèles de langage pour l'ancrage. Cette page explique comment ancrer les réponses de Gemini à l'aide de Parallel.

L'ancrage avec Parallel sur la plate-forme Gemini Enterprise Agent est une Offre distincte (telle que définie dans votre Contrat Google Cloud ) 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 pour fournir des réponses plus à jour et factuelles.

Cas d'utilisation

L'ancrage avec Parallel convient 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 commerciaux, 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 pour le week-end du 20 au 22 novembre 2025. Le gagnant est donc inconnu.	Le vainqueur du Grand Prix de F1 de Las Vegas 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

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 à Grounding with Parallel Web Search sur Google Cloud Marketplace (aperçu) pour une intégration simplifiée dans votre environnement cloud existant.
Utilisez une clé API Parallel existante.

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 "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 et votre accès à l'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 Gemini avec Parallel

Pour demander des réponses ancrées à Gemini à l'aide de l'API REST, procédez comme suit. Pour obtenir les meilleures performances, 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é à Grounding with Parallel Web Search sur Google Cloud Marketplace (Preview), vérifiez que le compte de facturation utilisé pour votre abonnement est actif dans votre projetGoogle Cloud .

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 Google Cloud .
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 (Preview), la clé API est prioritaire.
EXCLUDE_DOMAINS : liste facultative 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 des domaines (www.example.com) ou des extensions de domaine commençant par un point (.gov, .edu, .co.uk). Vous pouvez spécifier jusqu'à 10 domaines.
INCLUDE_DOMAINS : liste facultative des domaines à inclure dans les sources d'ancrage. Si elles sont spécifiées, les sources de ces domaines sont incluses. Les valeurs acceptables sont des domaines (www.example.com) ou des extensions de domaine commençant par un point (.gov, .edu, .co.uk). Vous pouvez spécifier jusqu'à 10 domaines.
MAX_CHARS_PER_RESULT : facultatif. Nombre maximal de caractères à inclure dans l'extrait de chaque 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 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, 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".

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",
        "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 :

curl (Linux, macOS ou Cloud Shell)

Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:generateContent"

PowerShell (Windows)

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:generateContent" | Select-Object -Expand Content

Vous devriez recevoir une réponse JSON semblable à la suivante.

Réponse

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "The most recent Super Bowl was Super Bowl LIX (59), which was played in 2025. The winner of Super Bowl LIX was the **Philadelphia Eagles**, who defeated the Kansas City Chiefs with a score of 40-22."
          }
        ]
      },
      "finishReason": "STOP",
      "groundingMetadata": {
        "webSearchQueries": [
          "who won the last super bowl"
        ],
        "groundingChunks": [
          {
            "web": {
              "uri": "https://...",
              "title": "Super Bowl LIX",
              "domain": "domain.com"
            }
          },
          {
            "web": {
              "uri": "https://...",
              "title": "Super Bowl LIX Results",
              "domain": "domain.com"
            }
          }
        ],
        "groundingSupports": [
          {
            "segment": {
              "endIndex": 77,
              "text": "The most recent Super Bowl was Super Bowl LIX (59), which was played in 2025."
            },
            "groundingChunkIndices": [
              0,
              1
            ]
          },
          {
            "segment": {
              "startIndex": 78,
              "endIndex": 198,
              "text": "The winner of Super Bowl LIX was the **Philadelphia Eagles**, who defeated the Kansas City Chiefs with a score of 40-22."
            },
            "groundingChunkIndices": [
              0
            ]
          },
        ]
      }
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 33,
    "candidatesTokenCount": 106,
    "totalTokenCount": 284,
    "billablePromptUsage": {
      "textCount": 142
    },
    "trafficType": "ON_DEMAND",
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 33
      }
    ],
    "candidatesTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 106
      }
    ],
    "toolUsePromptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 39
      }
    ],
    "toolUsePromptTokenCount": 39,
    "thoughtsTokenCount": 106
  },
  "modelVersion": "MODEL_VERSION",
  "createTime": "CREATE_TIME",
  "responseId": "RESPONSE_ID"
}

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 à la personne à contacter appropriée :

Si vous vous êtes abonné à l'ancrage avec la recherche Web parallèle sur Google Cloud Marketplace (version Preview) : 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 Web parallèle entraîne les frais suivants :

Consommation de jetons Gemini : vous pouvez être facturé pour :
- Jetons de prompt
- Jetons de réflexion
- 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 Web parallèle sur Google Cloud Marketplace (version Preview), 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.