Ancrage Web pour les entreprises

Cette page décrit les contrôles de conformité de l'ancrage Web pour Enterprise et explique comment utiliser l'API d'ancrage Web pour Enterprise afin de 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 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 de contrôles de conformité supplémentaires, utilisez l'ancrage avec la recherche Google, car il offre l'accès à un index Web plus vaste et encore plus à jour.

Présentation

L'ancrage Web pour entreprise utilise un index Web qui sert à générer des réponses ancrées. Le service n'enregistre pas les données client et est compatible avec VPC Service Controls. 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.

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 calendriers de mise à jour spécifiques puissent varier, les contenus qui changent rapidement sont mis à jour toutes les six heures, et l'index complet 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 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 actualité dans leurs réponses ancrées. La fraîcheur correspond à la récence des informations Web utilisées pour générer la réponse. Il est crucial pour les cas d'utilisation où l'accès aux informations les plus récentes et les plus complètes du Web est essentiel. L'ancrage avec la recherche Google stocke les journaux de fiabilité pendant trois jours maximum, conformément aux Conditions 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écialement conçue pour les entreprises 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 sur le Web pour Enterprise.

Cliquez pour développer la liste des 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 utilisant l'API d'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 entreprise 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 à un prompt ancré 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 conditions requises pour 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 les suggestions de recherche s'affichent comme spécifié dans les exemples ci-dessous, 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 l'image de marque, vous devez strictement respecter les consignes de Google concernant l'utilisation par les tiers des caractéristiques de la marque Google, disponibles sur la page Bienvenue dans notre centre de ressources sur la marque.
  • Lorsque vous utilisez l'ancrage Web pour les entreprises, des chips de suggestion de recherche s'affichent. Le champ contenant les chips de suggestion 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.

Étapes suivantes

  • Pour savoir comment ancrer 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, consultez IA responsable.