Ancrage Web pour les entreprises

Cette page décrit l'ancrage Web pour les contrôles de conformité Enterprise et explique comment utiliser l'API Web Grounding for Enterprise pour générer des réponses ancrées sur le Web. Le contenu indexé est un sous-ensemble de ce qui est disponible sur la recherche Google et convient aux clients des secteurs hautement réglementés, tels que la finance, la santé et le secteur public.

Si vous n'avez pas besoin des contrôles de conformité supplémentaires, utilisez l'ancrage avec la recherche Google, car il offre un accès à un index Web plus large et encore plus à jour.

Présentation

L'ancrage Web pour Enterprise utilise un index Web qui permet de générer des réponses ancrées. Le service n'enregistre pas les données client et est compatible avec les contrôles de service VPC. Pour en savoir plus, consultez Contrôles de sécurité pour l'IA générative. Comme aucune donnée client n'est conservée, les clés de chiffrement gérées par le client (CMEK) et Access Transparency (AxT) ne sont pas applicables.

Actualisation et curation de l'index

L'index Web d'ancrage Web pour Enterprise est automatiquement sélectionné pour répondre aux besoins attendus des clients des secteurs de la santé, de la finance et du secteur public. Bien que les programmes de mise à jour spécifiques puissent varier, le contenu qui évolue rapidement est mis à jour toutes les six heures, et l'ensemble de l'index est mis à jour toutes les 24 heures.

Choisir un produit

Le choix de l'outil d'ancrage approprié dépend des besoins spécifiques de votre organisation en matière de contrôles de conformité et de l'actualisation requise des informations.

  • Ancrage avec la recherche Google : il s'agit de l'option recommandée pour les clients qui recherchent la meilleure qualité et la meilleure actualisation dans leurs réponses ancrées. L'actualisation fait référence à la date des informations Web utilisées pour générer la réponse. Elle est essentielle pour les cas d'utilisation où il est essentiel d'accéder aux informations les plus récentes et les plus complètes du Web. L'ancrage avec la recherche Google stocke les journaux de fiabilité pendant trois jours maximum, conformément aux conditions spécifiques au service. Google n'entraîne pas les données client traitées par l'ancrage avec la recherche Google.

  • Ancrage Web pour Enterprise : cette solution est spécialement conçue pour les clients d'entreprise qui ont des exigences de conformité strictes, y compris "aucune journalisation des données client". L'ancrage Web pour Enterprise est le choix privilégié pour les organisations des secteurs hautement réglementés qui nécessitent des contrôles de conformité supplémentaires. L'ancrage Web pour Enterprise ne stocke pas les données client.

Modèles compatibles

Cette section liste les modèles compatibles avec l'ancrage Web pour Enterprise.

Cliquer pour développer les modèles compatibles

Gemini 3 Pro et Gemini 3 Pro Image sont limités à 5 000 requêtes de recherche par jour.

Utiliser l'API

Cette section fournit des exemples de requêtes d'utilisation de l'API IA générative Gemini 2 sur Gemini Enterprise Agent Platform pour créer des réponses ancrées avec Gemini. Pour utiliser l'API, vous devez définir les champs suivants :

  • Contents.parts.text: requête textuelle que les utilisateurs souhaitent envoyer à l'API.
  • tools.enterpriseWebSearch: lorsque cet outil est fourni, l'ancrage Web pour Enterprise peut être utilisé par Gemini.

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.types import (
    EnterpriseWebSearch,
    GenerateContentConfig,
    HttpOptions,
    Tool,
)

client = genai.Client(http_options=HttpOptions(api_version="v1"))

response = client.models.generate_content(
    model="gemini-3.5-flash",
    contents="When is the next total solar eclipse in the United States?",
    config=GenerateContentConfig(
        tools=[
            # Use Enterprise Web Search Tool
            Tool(enterprise_web_search=EnterpriseWebSearch())
        ],
    ),
)

print(response.text)
# Example response:
# 'The next total solar eclipse in the United States will occur on ...'

REST

Remplacez les variables suivantes par des valeurs :

  • PROJECT_NUMBER : numéro de votre projet.
  • 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.
  • PROMPT: votre prompt.
  curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" -H "x-server-timeout: 60" https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/publishers/google/models/gemini-2.5-flash:generateContent -d '
  {
    "contents": [{
      "role": "user",
      "parts": [{
        "text": PROMPT
      }]
    }],
    "tools": [{
      "enterpriseWebSearch": {
      }
    }]
  }
  '

Utiliser les suggestions de recherche Google

Lorsque vous utilisez l'ancrage Web pour Enterprise et que vous recevez des suggestions de recherche dans votre réponse, vous devez afficher les suggestions de recherche en production et dans vos applications.

Plus précisément, vous devez afficher les requêtes de recherche incluses dans les métadonnées de la réponse ancrée. La réponse inclut :

  • "content" : réponse générée par le LLM.
  • "webSearchQueries" : requêtes à utiliser pour les suggestions de recherche.

Par exemple, dans l'extrait de code suivant, Gemini répond à une requête ancrée avec la recherche, qui pose une question sur un type de plante tropicale.

"predictions": [
  {
    "content": "Monstera is a type of vine that thrives in bright indirect light…",
    "groundingMetadata": {
      "webSearchQueries": ["What's a monstera?"],
    }
  }
]

Vous pouvez récupérer ce résultat et l'afficher à l'aide des suggestions de recherche.

Conditions requises pour les suggestions de recherche

Voici les conditions requises pour les suggestions :

Exigence Description
À faire
  • Tout en respectant les exigences d'affichage, la suggestion de recherche s'affiche exactement comme elle est fournie, sans aucune modification.
  • Lorsque vous interagissez avec la suggestion de recherche, vous êtes directement redirigé vers la page de résultats de recherche (SRP).
Mauvaises pratiques
  • N'incluez aucun écran ni aucune étape supplémentaire entre l'appui de l'utilisateur et l'affichage de la SRP.
  • N'affichez aucun autre résultat de recherche ni aucune autre suggestion à côté de la suggestion de recherche ou de la réponse LLM avec ancrage associée.

Conditions requises pour l'affichage

Voici les conditions requises pour l'affichage :

  • Affichez la suggestion de recherche exactement comme elle est fournie, et n'apportez aucune modification aux couleurs, aux polices ni à l'apparence. Assurez-vous que la suggestion de recherche s'affiche comme spécifié dans les exemples suivants, tels que le mode clair et le mode sombre :

  • Chaque fois qu'une réponse ancrée s'affiche, la suggestion de recherche correspondante doit rester visible.
  • Pour la marque, vous devez respecter scrupuleusement les consignes de Google concernant l'utilisation par les tiers des caractéristiques de la marque Google sur la page Bienvenue dans notre centre de ressources sur la marque.
  • Lorsque vous utilisez l'ancrage Web pour Enterprise, des chips de suggestions de recherche s'affichent. Le champ contenant les chips de suggestions doit avoir la même largeur que la réponse ancrée du LLM.

Comportement au moment du clic

Lorsqu'un utilisateur appuie sur le chip, il est directement redirigé vers une page de résultats de recherche (SRP) pour le terme de recherche affiché dans le chip. Le SRP peut s'ouvrir dans votre navigateur intégré ou dans une application de navigateur distincte. Il est important de ne pas minimiser, supprimer ni masquer l'affichage du SRP. L'exemple animé suivant illustre l'interaction de type "tap-to-SRP" (clic vers SRP).

Exemple pour les applications/ordinateurs de bureau

Code permettant d'implémenter une suggestion de recherche

Lorsque vous utilisez l'API pour ancrer une réponse à la recherche, la réponse du modèle fournit un style HTML et CSS conforme dans le champ renderedContent, que vous implémentez pour afficher les suggestions de recherche dans votre application.

Étape suivante

  • Pour en savoir plus sur l'ancrage des modèles Gemini sur vos données, consultez Ancrage avec Agent Search.
  • Pour en savoir plus sur les bonnes pratiques d'IA responsable et les filtres de sécurité de Gemini Enterprise Agent Platform's, consultez IA responsable.