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 dans la recherche Google. Il est adapté aux clients des secteurs hautement réglementés, tels que la finance, la santé et le secteur public.

Si vous n'avez pas besoin de contrôles de conformité supplémentaires, utilisez Ancrer avec la recherche Google, car cette option vous donne accès à un index Web plus large et encore plus à jour.

Présentation

L'ancrage Web pour les entreprises utilise un index Web qui permet de générer des réponses ancrées. Le service ne consigne 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. Étant donné qu'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 s'appliquent pas.

Fraîcheur et curation de l'index

L'index Web de l'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 plannings de mise à jour spécifiques puissent varier, les contenus qui évoluent rapidement sont mis à jour toutes les six heures, et l'intégralité de l'index est mise à 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 termes de contrôles de conformité et de fraîcheur des informations requise.

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

  • Ancrage Web pour les entreprises : cette solution est spécifiquement conçue pour les clients Enterprise, qui ont des exigences de conformité strictes, y compris l'absence de journalisation des données client. L'ancrage Web pour Enterprise est le choix privilégié des organisations des secteurs hautement réglementés qui ont besoin de 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.

Utiliser l'API

Cette section fournit des exemples de requêtes utilisant l'API Generative AI Gemini 2 sur Vertex AI 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, Gemini peut utiliser l'ancrage Web pour Enterprise.

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 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_VERTEXAI=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-2.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 requête.
  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.0-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 Google 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 exigences concernant les suggestions :

Exigence Description
À faire
  • Tout en respectant les exigences d'affichage, la suggestion de recherche est affichée exactement telle qu'elle est fournie, sans aucune modification.
  • Lorsque vous interagissez avec la suggestion de recherche, vous êtes redirigé directement vers la page de résultats de recherche (SRP).
Mauvaises pratiques
  • Incluez tous les écrans ou étapes supplémentaires entre le clic de l'utilisateur et l'affichage de la SRP.
  • Afficher d'autres résultats de recherche ou suggestions à côté de la suggestion de recherche ou de la réponse LLM avec ancrage associée.

Conditions requises pour l'affichage

Voici les exigences d'affichage :

  • Affichez la suggestion de recherche exactement telle qu'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, y compris pour les modes clair et sombre :

  • Chaque fois qu'une réponse avec ancrage est affichée, sa suggestion de recherche correspondante doit rester visible.
  • Pour la marque, vous devez strictement respecter les consignes de Google concernant l'utilisation par les tiers des caractéristiques de la marque Google, disponibles dans le Centre de ressources pour 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. La page de résultats de recherche peut s'ouvrir dans le navigateur intégré à l'application 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.

Étapes suivantes

  • Pour savoir comment ancrer les modèles Gemini sur vos données, consultez Ancrage avec Vertex AI Search.
  • Pour en savoir plus sur les bonnes pratiques d'IA responsable et les filtres de sécurité de Vertex AI, consultez IA responsable.