Grounding web per aziende

In questa pagina viene descritto il grounding web per i controlli di conformità aziendale 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 di pubblicazione delle informazioni web utilizzate per generare la risposta. È fondamentale per i casi d'uso in cui è fondamentale accedere alle informazioni più aggiornate e complete del web. Grounding con la Ricerca Google archivia i log di affidabilità per un massimo di 30 giorni, come indicato nei Termini di servizio specifici del servizio. Google non esegue l'addestramento sui dati dei clienti elaborati da Grounding con la Ricerca Google.

  • Web Grounding for Enterprise: questa soluzione è progettata specificamente per i clienti aziendali 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

In questa sezione vengono forniti esempi di richieste di 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 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-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

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 utilizzare 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
Azioni consigliate
  • 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).
Azioni non consigliate
  • 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 la ricerca dell'agente.
  • 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.