Ancrage Web pour les entreprises

Cette page décrit l'ancrage Web pour les contrôles de conformité d'entreprise et explique comment utiliser l'API d'ancrage Web pour les entreprises 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 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 les entreprises 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 les 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 sont pas applicables.

Actualisation et curation de l'index

L'index Web de l'ancrage Web pour les entreprises 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 la fraîcheur 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 fraîcheur dans leurs réponses ancrées. La fraîcheur 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 à jour et les plus complètes du Web. L'ancrage avec la recherche Google stocke les journaux de fiabilité pendant 30 jours maximum, conformément aux conditions spécifiques au service. Google n'est pas entraîné 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 clients d'entreprise qui ont des exigences de conformité strictes, y compris l'absence d'enregistrement des données client. L'ancrage Web pour les entreprises 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 les entreprises ne stocke pas les données client.

Modèles compatibles

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

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 les entreprises 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 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-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 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 les entreprises 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 telle qu'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
  • Inclure 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 conditions requises pour l'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, par exemple en mode 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 suivre scrupuleusement les consignes de Google concernant l'utilisation par des tiers des caractéristiques de la marque Google sur la page Bienvenue dans notre centre de ressources de la marque.
  • Lorsque vous utilisez l'ancrage Web pour les entreprises, 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 la recherche d'agent.
  • 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.