Grounding web per aziende

In questa pagina viene descritto il grounding web per i controlli di conformità Enterprise e come utilizzare l'API Web Grounding for Enterprise per generare risposte basate sul web. I contenuti indicizzati sono un sottoinsieme di quelli disponibili nella Ricerca Google e sono adatti ai clienti in settori altamente regolamentati, come quello finanziario, sanitario e pubblico.

Se non hai bisogno dei controlli di conformità aggiuntivi, utilizza Grounding con la Ricerca Google, perché offre l'accesso a un indice web più ampio e aggiornato.

Panoramica

Web Grounding for Enterprise utilizza un indice web per generare risposte fondate. Il servizio non registra i dati dei clienti e supporta i controlli di servizio VPC. Per saperne di più, consulta Controlli di sicurezza per l'AI generativa. Poiché non vengono mantenuti i dati dei clienti, le chiavi di crittografia gestite dal cliente (CMEK) e Access Transparency (AxT) non sono applicabili.

Aggiornamento e curatela dell'indice

L'indice web di Web Grounding for Enterprise viene selezionato automaticamente per soddisfare le esigenze previste dei clienti nei settori sanitario, finanziario e pubblico. Sebbene le pianificazioni di aggiornamento specifiche possano variare, i contenuti in rapida evoluzione vengono aggiornati ogni 6 ore e l'intero indice viene aggiornato ogni 24 ore.

Scegli un prodotto.

La scelta dello strumento di grounding giusto dipende dalle esigenze specifiche della tua organizzazione in merito ai controlli di conformità e all'aggiornamento delle informazioni richieste.

  • Grounding con la Ricerca Google: questa è l'opzione consigliata per i clienti che cercano la massima qualità e aggiornamento nelle risposte fondate. L'aggiornamento si riferisce alla data delle informazioni web utilizzate per generare la risposta. È fondamentale per i casi d'uso in cui è fondamentale accedere alle informazioni più aggiornate e complete dal web. Grounding con la Ricerca Google archivia i log di affidabilità per un massimo di 3 giorni, come indicato nei Termini specifici del servizio. Google Non esegue il training sui dati dei clienti elaborati da Grounding con la Ricerca Google.

  • Web Grounding for Enterprise: questa soluzione è progettata specificamente per i clienti Enterprise che hanno requisiti di conformità rigorosi che includono "nessuna registrazione dei dati dei clienti". Web Grounding for Enterprise è la scelta preferita per le organizzazioni in settori altamente regolamentati che richiedono i controlli di conformità aggiuntivi. Web Grounding for Enterprise non archivia i dati dei clienti.

Modelli supportati

In questa sezione sono elencati i modelli che supportano Web Grounding for Enterprise.

Fai clic per espandere i modelli supportati

Gemini 3 Pro e Gemini 3 Pro Image sono limitati a 5000 query di ricerca al giorno.

Utilizzare l'API

Questa sezione fornisce richieste di esempio per l'utilizzo dell'API Generative AI Gemini 2 su Gemini Enterprise Agent Platform per creare risposte fondate con Gemini. Per utilizzare l'API, devi impostare i seguenti campi:

  • Contents.parts.text: la query di testo che gli utenti vogliono inviare all'API.
  • tools.enterpriseWebSearch: quando questo strumento viene fornito, Gemini può utilizzare Web Grounding for Enterprise.

Python

Installa

pip install --upgrade google-genai

Per saperne di più, consulta la documentazione di riferimento dell'SDK.

Imposta le variabili di ambiente per utilizzare l'SDK Google Gen AI con 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

Sostituisci le seguenti variabili con i valori:

  • PROJECT_NUMBER: il numero del progetto.
  • LOCATION: la regione in cui elaborare la richiesta. Per utilizzare l'endpoint global, escludi la località dal nome dell'endpoint e configura la località della risorsa su global.
  • PROMPT: il 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": {
      }
    }]
  }
  '

Utilizzare i suggerimenti di ricerca Google

Quando utilizzi Web Grounding for Enterprise e ricevi suggerimenti di ricerca nella risposta, devi visualizzarli in produzione e nelle tue applicazioni.

In particolare, devi visualizzare le query di ricerca incluse nei metadati della risposta fondata. La risposta include:

  • "content": la risposta generata da LLM.
  • "webSearchQueries": le query da utilizzare per i suggerimenti di ricerca.

Ad esempio, nel seguente snippet di codice, Gemini risponde a un prompt basato sulla ricerca, che chiede informazioni su un tipo di pianta tropicale.

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

Puoi prendere questo output e visualizzarlo utilizzando i suggerimenti di ricerca.

Requisiti per i suggerimenti di ricerca

Di seguito sono riportati i requisiti per i suggerimenti:

Requisito Descrizione
Cosa fare
  • Pur rispettando i requisiti di visualizzazione, il suggerimento di ricerca viene visualizzato esattamente come fornito, senza modifiche.
  • Quando interagisci con il suggerimento di ricerca, vieni reindirizzato direttamente alla pagina dei risultati di ricerca (SRP).
Cosa non fare
  • Non includere schermate o passaggi aggiuntivi tra il tocco dell'utente e la visualizzazione della pagina dei risultati di ricerca.
  • Non visualizzare altri risultati di ricerca o suggerimenti accanto al suggerimento di ricerca o alla risposta LLM fondata associata.

Requisiti di visualizzazione

Di seguito sono riportati i requisiti di visualizzazione:

  • Visualizza il suggerimento di ricerca esattamente come fornito e non apportare modifiche a colori, caratteri o aspetto. Assicurati che il suggerimento di ricerca venga visualizzato come specificato nei seguenti mock, ad esempio in modalità chiara e scura:

  • Ogni volta che viene mostrata una risposta fondata, il suggerimento di ricerca corrispondente deve rimanere visibile.
  • Per il branding, devi seguire rigorosamente le linee guida di Google per l'utilizzo da parte di terzi degli elementi distintivi del brand Google nel Centro risorse del brand.
  • Quando utilizzi Web Grounding for Enterprise, vengono visualizzati i chip dei suggerimenti di ricerca. Il campo che contiene i chip dei suggerimenti deve avere la stessa larghezza della risposta fondata di LLM.

Comportamento al tocco

Quando un utente tocca il chip, viene reindirizzato direttamente a una pagina dei risultati di ricerca (SRP) per il termine di ricerca visualizzato nel chip. La pagina dei risultati di ricerca può essere aperta nel browser in-app o in un'applicazione browser separata. È importante non ridurre a icona, rimuovere o oscurare in alcun modo la visualizzazione della pagina dei risultati di ricerca. Il seguente mockup animato illustra l'interazione tocco-pagina dei risultati di ricerca.

app/desktop example

Codice per implementare un suggerimento di ricerca

Quando utilizzi l'API per basare una risposta sulla ricerca, la risposta del modello fornisce uno stile HTML e CSS conforme nel campo renderedContent, che implementi per visualizzare i suggerimenti di ricerca nella tua applicazione.

Passaggi successivi

  • Per saperne di più su come basare i modelli Gemini sui tuoi dati, consulta Grounding con Agent Search.
  • Per saperne di più sulle best practice per l'AI responsabile e sui filtri di sicurezza di Gemini Enterprise Agent Platform's, consulta AI responsabile.