Grounding con Parallel Web Search

Anteprima

Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Parallel Web Systems offre un'API di ricerca che fornisce l'accesso ai dati web disponibili pubblicamente ottimizzati per l'utilizzo da parte di modelli linguistici di grandi dimensioni per il grounding. Questa pagina spiega come basare le risposte di Gemini utilizzando Parallel.

Il grounding con Parallel su Vertex AI è un'offerta separata (come definita nel tuo Google Cloud contratto) che collega i modelli Gemini ai dati web pubblici forniti da Parallel Web Systems' search API. Questo servizio consente a Gemini di accedere a informazioni in tempo reale da miliardi di pagine web per garantire risposte più aggiornate e fattuali.

Tieni presente quanto segue: per utilizzare Parallel Google Cloud deve inviare determinati dati del cliente all' offerta separata di Parallel per l'elaborazione. L'utilizzo del servizio Parallel è regolato dai termini di utilizzo separati di Parallel e dalla norma sull'utilizzo accettabile di Parallel.

Nota: per i publisher web, il grounding con Parallel su Vertex AI non utilizza pagine web per il grounding che hanno vietato ShapBot. I publisher web possono gestire i loro opt-out con un file robots.txt.

Casi d'uso

Il grounding con Parallel è adatto a casi d'uso come i seguenti:

• Utilizzo dei dati web per scopi di completamento o arricchimento delle informazioni.
• Agenti multi-hop che richiedono ricerche web più approfondite per domande più complesse.
• Creazione di un'API che integra i dati di ricerca web.
• Assistenti rivolti ai dipendenti che consentono agli utenti finali di porre domande e creare report complessi utilizzando le informazioni web più recenti.
• Applicazioni rivolte ai consumatori, come vendita al dettaglio e viaggi, che consentono all'utente di prendere decisioni di acquisto informate.
• Agenti automatici che vengono eseguiti autonomamente per eseguire attività automatizzate, come l'analisi delle notizie e i controlli KYC.
• Agenti verticali (agenti di vendita, agenti di codifica, agenti finanziari) che ottengono il contesto più recente e aggiornato dal web.

Esempio

Chi ha vinto il Gran Premio di Formula 1 di Las Vegas 2025?

Senza grounding	Con grounding
Il Gran Premio di Las Vegas 2025 non si è ancora svolto. La gara è in programma per il fine settimana del 20-22 novembre 2025. Pertanto, il vincitore è attualmente sconosciuto.	Il vincitore del Gran Premio di Formula 1 di Las Vegas 2025 è stato Max Verstappen della Red Bull Racing. La gara si è svolta il 22 novembre 2025. Origini: domain1.com, domain2.com, ...

Modelli supportati

Il grounding con Parallel Web Search è supportato dai seguenti modelli:

• Gemini 2.5 Flash (gemini-2.5-flash)
• Gemini 2.5 Flash-Lite (gemini-2.5-flash-lite)
• Gemini 2.5 Pro (gemini-2.5-pro)
• Gemini 3.1 Pro (gemini-3.1-pro-preview)
• Gemini 3 Flash Lite (gemini-3-flash-lite-preview)

Prima di iniziare

Per utilizzare il grounding con Parallel, devi ottenere una chiave API da Parallel's web site. Questa chiave API viene utilizzata nella richiesta a Gemini.

Basare le risposte di Gemini con Parallel

Richiedi risposte basate da Gemini utilizzando l'API REST come segue. Per prestazioni ottimali, ti consigliamo di utilizzare le impostazioni predefinite per i parametri facoltativi, a meno che non siano strettamente necessari valori non predefiniti.

REST

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

• LOCATION: la regione in cui elaborare la richiesta. Per utilizzare l'endpoint globale, escludi la località dal nome dell'endpoint e configura la località della risorsa su `global`.
• PROJECT_ID: l' Google Cloud ID progetto.
• MODEL_ID: l'ID del modello da utilizzare.
• TEXT: il prompt di testo da inviare al modello.
• API_KEY: la tua chiave API per Parallel Web Search.
• EXCLUDE_DOMAINS: (facoltativo) elenco di domini da escludere dalle origini di grounding. Se specificato, le origini di questi domini vengono escluse. I valori accettabili sono domini (www.example.com) o estensioni di dominio che iniziano con un punto ( .gov, .edu, .co.uk). Puoi specificare fino a 10 domini.
• INCLUDE_DOMAINS: (facoltativo) elenco di domini da includere nelle origini di grounding. Se specificato, le origini di questi domini vengono incluse. I valori accettabili sono domini (www.example.com) o estensioni di dominio che iniziano con un punto ( .gov, .edu, .co.uk). Puoi specificare fino a 10 domini.
• MAX_CHARS_PER_RESULT: (facoltativo) il numero massimo di caratteri da includere in ogni estratto dei risultati di ricerca. Se non specificato, il valore predefinito è 30000. L'intervallo consentito è [1000, 100000].
• MAX_CHARS_TOTAL: (facoltativo) il numero massimo totale di caratteri di tutti gli estratti dei risultati di ricerca. Se non specificato, il valore predefinito è 100000. L'intervallo consentito è [1000, 1000000].
• MAX_RESULTS: (facoltativo) il numero massimo di risultati di ricerca da utilizzare per il grounding. Se non specificato, il valore predefinito è 10. L'intervallo consentito è [1, 20].

Metodo HTTP e URL:

POST https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:generateContent

Corpo JSON della richiesta:

{
  "contents": [{
    "role": "user",
    "parts": [{
      "text": "TEXT"
    }]
  }],
  "tools": [{
    "parallelAiSearch": {
        "api_key": "API_KEY",
        "customConfigs": {
            "source_policy": {
                "exclude_domains": ["EXCLUDE_DOMAINS"],
                "include_domains": ["INCLUDE_DOMAINS"],
            },
            "excerpts": {
                "max_chars_per_result": MAX_CHARS_PER_RESULT,
                "max_chars_total": MAX_CHARS_TOTAL
            },
            "max_results": MAX_RESULTS
        }
    }
}],
  "model": "projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID"
}

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:generateContent"

PowerShell (Windows)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, e quindi esegui il comando seguente:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:generateContent" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente.

Risposta

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "The most recent Super Bowl was Super Bowl LIX (59), which was played in 2025. The winner of Super Bowl LIX was the **Philadelphia Eagles**, who defeated the Kansas City Chiefs with a score of 40-22."
          }
        ]
      },
      "finishReason": "STOP",
      "groundingMetadata": {
        "webSearchQueries": [
          "who won the last super bowl"
        ],
        "groundingChunks": [
          {
            "web": {
              "uri": "https://...",
              "title": "Super Bowl LIX",
              "domain": "domain.com"
            }
          },
          {
            "web": {
              "uri": "https://...",
              "title": "Super Bowl LIX Results",
              "domain": "domain.com"
            }
          }
        ],
        "groundingSupports": [
          {
            "segment": {
              "endIndex": 77,
              "text": "The most recent Super Bowl was Super Bowl LIX (59), which was played in 2025."
            },
            "groundingChunkIndices": [
              0,
              1
            ]
          },
          {
            "segment": {
              "startIndex": 78,
              "endIndex": 198,
              "text": "The winner of Super Bowl LIX was the **Philadelphia Eagles**, who defeated the Kansas City Chiefs with a score of 40-22."
            },
            "groundingChunkIndices": [
              0
            ]
          },
        ]
      }
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 33,
    "candidatesTokenCount": 106,
    "totalTokenCount": 284,
    "billablePromptUsage": {
      "textCount": 142
    },
    "trafficType": "ON_DEMAND",
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 33
      }
    ],
    "candidatesTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 106
      }
    ],
    "toolUsePromptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 39
      }
    ],
    "toolUsePromptTokenCount": 39,
    "thoughtsTokenCount": 106
  },
  "modelVersion": "MODEL_VERSION",
  "createTime": "CREATE_TIME",
  "responseId": "RESPONSE_ID"
}

Quota

La quota predefinita è di 200 prompt al minuto. Se devi aumentare i limiti di frequenza, contatta [e-mail] e il team dell'account Google con il tuo caso d'uso e i tuoi requisiti.

Fatturazione

L'utilizzo del grounding con Parallel comporta i seguenti addebiti:

• Consumo di token Gemini: token di prompt, token di ragionamento, token di output. Per ulteriori informazioni, vedi Prezzi.
• Grounding di Gemini con i tuoi dati: per ulteriori informazioni, vedi Prezzi.
  • I token di input forniti da Parallel non vengono addebitati.
• Prezzi per l'utilizzo dell'API di ricerca di Parallel: per ulteriori informazioni, consulta la pagina dei prezzi di Parallel.