Grounding con Parallel Web Search

Parallel Web Systems offre un'API di ricerca che fornisce 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.

Grounding with Parallel su Gemini Enterprise Agent Platform è un'offerta separata (come definita nel tuo Cloud de Confiance by S3NS Contratto) che collega i modelli Gemini ai dati web pubblici forniti dall'API di ricerca di Parallel Web Systems. Questo servizio consente a Gemini di accedere a informazioni in tempo reale da miliardi di pagine web per garantire risposte più aggiornate e oggettive.

Casi d'uso

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

  • Utilizzo dei dati web per completare o arricchire le informazioni.
  • Agenti multi-hop che richiedono ricerche web più approfondite per domande più complesse.
  • Creare un'API che integra i dati della 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 quelle per la vendita al dettaglio e i viaggi, che consentono all'utente di prendere decisioni di acquisto consapevoli.
  • Agenti automatizzati che operano in modo autonomo per eseguire attività automatizzate, come l'analisi delle notizie e i controlli KYC.
  • Agenti verticali (agenti di vendita, agenti di programmazione, agenti finanziari) che ricevono il contesto più recente e aggiornato dal web.

Esempio

Chi ha vinto il Gran Premio di F1 di Las Vegas del 2025?

Senza grounding Con grounding
Il Gran Premio di Las Vegas 2025 non si è ancora svolto. La gara è prevista per il fine settimana del 20-22 novembre 2025. Pertanto, il vincitore è sconosciuto. Il vincitore del Gran Premio di F1 di Las Vegas del 2025 è stato Max Verstappen di Red Bull Racing. La gara si è svolta il 22 novembre 2025. Fonti: domain1.com, domain2.com, …

Modelli supportati

In questa sezione sono elencati i modelli che supportano il grounding con Parallel Web Search.

Fai clic per espandere i modelli supportati

Prima di iniziare

Per utilizzare il grounding con Parallel Web Search, devi configurare l'accesso. Hai due opzioni:

  • Abbonati direttamente a Grounding con Ricerca Google parallela su Google Cloud Marketplace per un'integrazione semplificata nel tuo ambiente cloud esistente. Per i workload sensibili è disponibile anche un'offerta di conservazione zero dei dati. Per utilizzare ZDR, devi abbonarti all'offerta ZDR e impostare il flag enable_zero_data_retention corrispondente nelle richieste API.

  • Utilizza una chiave API Parallel esistente.

Abbonati su Google Cloud Marketplace (consigliato)

L'integrazione tramite Google Cloud Marketplace ti consente di gestire Grounding con il servizio di ricerca web parallela direttamente all'interno di Cloud de Confiance by S3NS. Per iniziare, abbonati al servizio Grounding con la ricerca web parallela su Google Cloud Marketplace, accetta i termini di servizio e consulta i prezzi.

Utilizza la tua chiave API

Se preferisci gestire separatamente la fatturazione e l'accesso alle API di Parallel, puoi fornire la tua chiave API. Per utilizzare questo metodo, devi ottenere una chiave API dalla piattaforma per sviluppatori Parallel. Questa chiave API viene utilizzata direttamente nelle richieste API REST a Gemini.

Fonda le risposte di Gemini con Parallel

Richiedi risposte con grounding da Gemini utilizzando Agent Studio nella console Cloud de Confiance , l'SDK Google Gen AI o l'API REST. Per ottenere prestazioni ottimali, ti consigliamo di utilizzare le impostazioni predefinite per i parametri facoltativi, a meno che tu non abbia strettamente bisogno di valori non predefiniti.

Se hai sottoscritto un abbonamento a Grounding with Parallel Web Search su Google Cloud Marketplace, verifica che l'account di fatturazione utilizzato per l'abbonamento sia attivo nel tuo progettoCloud de Confiance by S3NS .

Prima di eseguire gli esempi, completa i prerequisiti, incluso l'abbonamento su Google Cloud Marketplace o la fornitura di una chiave API parallela.

Console

Per fare il grounding delle risposte di Gemini con la ricerca web parallela utilizzando Agent Studio sulla Gemini Enterprise Agent Platform, segui questi passaggi:

  1. Nella console Cloud de Confiance , vai alla pagina Agent Studio.

    Vai ad Agent Studio

  2. Nel riquadro laterale, in Impostazioni del modello, nella sezione Grounding, attiva il pulsante di attivazione/disattivazione Partner (Risultati di ricerca dei partner di grounding).

  3. Seleziona Ricerca web parallela come partner di base, quindi fai clic su Applica. Per utilizzare Parallel Web Search, devi prima abbonarti su Google Cloud Marketplace.

  4. Inserisci il prompt nella casella di testo e invialo.

Le risposte ai prompt ora utilizzano il grounding con Ricerca Google parallela.

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 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

Prima di eseguire l'esempio, apporta le seguenti sostituzioni:

  • MODEL_ID: l'ID di un modello supportato da utilizzare, ad esempio gemini-2.5-flash.
  • TEXT: il prompt testuale da inviare al modello.
  • API_KEY: la tua chiave API per la ricerca web parallela. Ometti questo parametro se hai un abbonamento su Google Cloud Marketplace; se vengono forniti entrambi, la chiave API ha la precedenza.
  • EXCLUDE_DOMAINS: (facoltativo) elenco di domini da escludere dalle fonti di grounding. Se specificate, le fonti di questi domini vengono escluse. I valori accettabili sono i domini (www.example.com) o le estensioni di dominio che iniziano con un punto ( .gov, .edu, .co.uk). Puoi specificare fino a 200 domini.
  • INCLUDE_DOMAINS: (Facoltativo) Elenco di domini da includere nelle fonti di grounding. Se specificate, vengono incluse le fonti di questi domini. I valori accettabili sono i domini (www.example.com) o le estensioni di dominio che iniziano con un punto ( .gov, .edu, .co.uk). Puoi specificare fino a 200 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 snippet 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].
  • MODE: (facoltativo) modalità da utilizzare per la richiesta, basic o advanced. Il valore predefinito è basic. Prendi in considerazione la modalità advanced se vuoi risultati di ricerca più approfonditi a scapito di una latenza più elevata.
  • SEARCH_LOCATION: (facoltativo) codice paese ISO 3166-1 alpha-2 per i risultati di ricerca con targeting geografico. Esempio: "us".

from google import genai
from google.genai import types

client = genai.Client()

response = client.models.generate_content(
    model="MODEL_ID",
    contents="TEXT",
    config=types.GenerateContentConfig(
        tools=[
            types.Tool(
                parallel_ai_search=types.ToolParallelAiSearch(
                    # Optional. Omit api_key if you subscribed to Grounding with
                    # Parallel Web Search on Google Cloud Marketplace.
                    api_key="API_KEY",
                    # Optional. Set to True to use Zero Data Retention (ZDR) for
                    # sensitive workloads. Requires a separate ZDR Marketplace
                    # subscription; defaults to the standard subscription.
                    enable_zero_data_retention=True,
                    # Optional. Customize the search. Click a placeholder to
                    # enter a value, or remove the line to accept the default.
                    custom_configs={
                        "mode": "MODE",
                        "location": "SEARCH_LOCATION",
                        "max_results": MAX_RESULTS,
                        "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,
                        },
                    },
                )
            )
        ],
    ),
)

print(response.text)
# Example response:
# Max Verstappen won the 2025 Las Vegas F1 Grand Prix ...

# The grounding metadata contains the web sources used to ground the response.
print(response.candidates[0].grounding_metadata.grounding_chunks)

Java

Scopri come installare o aggiornare Java.

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

Prima di eseguire l'esempio, apporta le seguenti sostituzioni:

  • MODEL_ID: l'ID di un modello supportato da utilizzare, ad esempio gemini-2.5-flash.
  • TEXT: il prompt testuale da inviare al modello.
  • API_KEY: la tua chiave API per la ricerca web parallela. Ometti questo parametro se hai un abbonamento su Google Cloud Marketplace; se vengono forniti entrambi, la chiave API ha la precedenza.
  • EXCLUDE_DOMAINS: (facoltativo) elenco di domini da escludere dalle fonti di grounding. Se specificate, le fonti di questi domini vengono escluse. I valori accettabili sono i domini (www.example.com) o le estensioni di dominio che iniziano con un punto ( .gov, .edu, .co.uk). Puoi specificare fino a 200 domini.
  • INCLUDE_DOMAINS: (Facoltativo) Elenco di domini da includere nelle fonti di grounding. Se specificate, vengono incluse le fonti di questi domini. I valori accettabili sono i domini (www.example.com) o le estensioni di dominio che iniziano con un punto ( .gov, .edu, .co.uk). Puoi specificare fino a 200 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 snippet 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].
  • MODE: (Facoltativo) modalità da utilizzare per la richiesta, basic o advanced. Il valore predefinito è basic. Prendi in considerazione la modalità advanced se vuoi risultati di ricerca più approfonditi a scapito di una latenza più elevata.
  • SEARCH_LOCATION: (facoltativo) codice paese ISO 3166-1 alpha-2 per i risultati di ricerca con targeting geografico. Esempio: "us".

import com.google.genai.Client;
import com.google.genai.types.GenerateContentConfig;
import com.google.genai.types.GenerateContentResponse;
import com.google.genai.types.Tool;
import com.google.genai.types.ToolParallelAiSearch;
import java.util.List;
import java.util.Map;

public class ParallelGroundingSample {
  public static void main(String[] args) {
    try (Client client = Client.builder().build()) {

      GenerateContentConfig config =
          GenerateContentConfig.builder()
              .tools(
                  Tool.builder()
                      .parallelAiSearch(
                          ToolParallelAiSearch.builder()
                              // Optional. Omit apiKey if you subscribed to
                              // Grounding with Parallel Web Search on Google
                              // Cloud Marketplace.
                              .apiKey("API_KEY")
                              // Optional. Set to true to use Zero Data
                              // Retention (ZDR) for sensitive workloads.
                              // Requires a separate ZDR Marketplace
                              // subscription; defaults to the standard
                              // subscription.
                              .enableZeroDataRetention(true)
                              // Optional. Customize the search. Click a
                              // placeholder to enter a value, or remove the
                              // entry to accept the default.
                              .customConfigs(
                                  Map.of(
                                      "mode", "MODE",
                                      "location", "SEARCH_LOCATION",
                                      "max_results", MAX_RESULTS,
                                      "source_policy",
                                      Map.of(
                                          "exclude_domains",
                                          List.of("EXCLUDE_DOMAINS"),
                                          "include_domains",
                                          List.of("INCLUDE_DOMAINS")),
                                      "excerpts",
                                      Map.of(
                                          "max_chars_per_result",
                                          MAX_CHARS_PER_RESULT,
                                          "max_chars_total",
                                          MAX_CHARS_TOTAL)))
                              .build())
                      .build())
              .build();

      GenerateContentResponse response =
          client.models.generateContent(
              "MODEL_ID", "TEXT", config);

      System.out.println(response.text());
    }
  }
}

Node.js

Installa

npm install @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

Prima di eseguire l'esempio, apporta le seguenti sostituzioni:

  • MODEL_ID: l'ID di un modello supportato da utilizzare, ad esempio gemini-2.5-flash.
  • TEXT: il prompt testuale da inviare al modello.
  • API_KEY: la tua chiave API per la ricerca web parallela. Ometti questo parametro se hai un abbonamento su Google Cloud Marketplace; se vengono forniti entrambi, la chiave API ha la precedenza.
  • EXCLUDE_DOMAINS: (facoltativo) elenco di domini da escludere dalle fonti di grounding. Se specificate, le fonti di questi domini vengono escluse. I valori accettabili sono i domini (www.example.com) o le estensioni di dominio che iniziano con un punto ( .gov, .edu, .co.uk). Puoi specificare fino a 200 domini.
  • INCLUDE_DOMAINS: (Facoltativo) Elenco di domini da includere nelle fonti di grounding. Se specificate, vengono incluse le fonti di questi domini. I valori accettabili sono i domini (www.example.com) o le estensioni di dominio che iniziano con un punto ( .gov, .edu, .co.uk). Puoi specificare fino a 200 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 snippet 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].
  • MODE: (Facoltativo) modalità da utilizzare per la richiesta, basic o advanced. Il valore predefinito è basic. Prendi in considerazione la modalità advanced se vuoi risultati di ricerca più approfonditi a scapito di una latenza più elevata.
  • SEARCH_LOCATION: (facoltativo) codice paese ISO 3166-1 alpha-2 per i risultati di ricerca con targeting geografico. Esempio: "us".

import {GoogleGenAI} from '@google/genai';

const ai = new GoogleGenAI({});

const response = await ai.models.generateContent({
  model: 'MODEL_ID',
  contents: 'TEXT',
  config: {
    tools: [
      {
        parallelAiSearch: {
          // Optional. Omit apiKey if you subscribed to Grounding with Parallel
          // Web Search on Google Cloud Marketplace.
          apiKey: 'API_KEY',
          // Optional. Set to true to use Zero Data Retention (ZDR) for
          // sensitive workloads. Requires a separate ZDR Marketplace
          // subscription; defaults to the standard subscription.
          enableZeroDataRetention: true,
          // Optional. Customize the search. Click a placeholder to enter a
          // value, or remove the line to accept the default.
          customConfigs: {
            mode: 'MODE',
            location: 'SEARCH_LOCATION',
            max_results: MAX_RESULTS,
            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,
            },
          },
        },
      },
    ],
  },
});

console.log(response.text);

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'ID progetto Cloud de Confiance by S3NS .
  • MODEL_ID: l'ID di un modello supportato da utilizzare, ad esempio gemini-2.5-flash.
  • TEXT: il prompt testuale da inviare al modello.
  • API_KEY: la tua chiave API per la ricerca web parallela. Ometti questo parametro se hai un abbonamento su Google Cloud Marketplace; se vengono forniti entrambi, la chiave API ha la precedenza.
  • EXCLUDE_DOMAINS: (facoltativo) elenco di domini da escludere dalle fonti di grounding. Se specificate, le fonti di questi domini vengono escluse. I valori accettabili sono i domini (www.example.com) o le estensioni di dominio che iniziano con un punto ( .gov, .edu, .co.uk). Puoi specificare fino a 200 domini.
  • INCLUDE_DOMAINS: (Facoltativo) Elenco di domini da includere nelle fonti di grounding. Se specificate, vengono incluse le fonti di questi domini. I valori accettabili sono i domini (www.example.com) o le estensioni di dominio che iniziano con un punto ( .gov, .edu, .co.uk). Puoi specificare fino a 200 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 snippet 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].
  • MODE: (facoltativo) modalità da utilizzare per la richiesta, basic o advanced. Il valore predefinito è basic. Prendi in considerazione la modalità advanced se vuoi risultati di ricerca più approfonditi a scapito di una latenza più elevata.
  • SEARCH_LOCATION: (facoltativo) codice paese ISO 3166-1 alpha-2 per i risultati di ricerca con targeting geografico. Esempio: "us".
  • ENABLE_ZERO_DATA_RETENTION: (Facoltativo) Passa alla versione ZDR della ricerca web Parallel per attivare la conservazione zero dei dati sui workload sensibili. Imposta il valore su true per utilizzare l'offerta ZDR per la tua richiesta. Perché queste richieste vadano a buon fine, devi aver sottoscritto l'offerta specifica per ZDR. Se non specificato, il valore predefinito è la versione standard. La versione ZDR è disponibile solo tramite Google Cloud Marketplace.

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",
        "enable_zero_data_retention": ENABLE_ZERO_DATA_RETENTION,
        "customConfigs": {
            "mode": "MODE",
            "location": "SEARCH_LOCATION",
            "max_results": MAX_RESULTS,
            "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
            }
        }
    }
}],
  "model": "projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID"
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente.

Quota

La quota predefinita è di 200 prompt al minuto. Per richiedere un aumento dei limiti di frequenza, fornisci il tuo caso d'uso e i requisiti al contatto appropriato:

  • Se hai sottoscritto un abbonamento a Grounding con ricerca web parallela su Google Cloud Marketplace: contatta il team dedicato al tuo Account Google.

  • Se fornisci la tua chiave API:contatta support@parallel.ai e il team del tuo Account Google.

Fatturazione

L'utilizzo del grounding con Ricerca Google parallela comporta i seguenti addebiti:

  • Consumo di token di Gemini:ti possono essere addebitati i costi per:

    • Token di prompt
    • Token di ragionamento
    • Token di output

    Per saperne di più, consulta i prezzi.

  • Grounding di Gemini con i tuoi dati:per saperne di più, consulta la sezione Prezzi.

  • Prezzi per l'utilizzo dell'API Parallel Web Search:

    • Se hai eseguito l'abbonamento a Grounding con Parallel Web Search su Google Cloud Marketplace, consulta la sezione Prezzi di Parallel su Google Cloud Marketplace per saperne di più.

    • Se fornisci la tua chiave API, consulta la sezione Sito web parallelo per saperne di più.