Grounding con Exa Web Search

Anteprima privata

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.

Exa fornisce un'API di ricerca che consente di accedere a dati web disponibili pubblicamente e ottimizzati per basare le risposte dei modelli linguistici di grandi dimensioni. Questa pagina spiega come basare le risposte di Gemini utilizzando Exa.

La funzionalità di grounding con Exa Web Search su Vertex AI è un'offerta separata (come definita nel tuo Google Cloud Contratto) che collega i modelli Gemini ai dati web pubblici forniti dall'API di ricerca di Exa.

Il grounding con la Ricerca web Exa è disponibile come anteprima con limitazioni. Per accedere a questa funzionalità per il tuo progetto, contatta il tuo Google Cloud team dedicato all'account per richiedere l'aggiunta alla lista consentita.

Nota :per gli editori web, la base con Exa su Vertex AI rispetta i segnali di disattivazione, come i tag "noindex". I publisher web possono gestire le proprie preferenze di disattivazione seguendo le istruzioni riportate nella documentazione di Exa.

Casi d'uso

La base con Exa migliora l'accuratezza e riduce le allucinazioni dando ai modelli l'accesso a dati web aggiornati e pertinenti. I casi d'uso comuni includono:

• Agenti e chatbot generici: recupera informazioni aggiornate per produrre risposte più affidabili.
• Agenti di ricerca: conducono ricerche approfondite sul deep web su più fonti.
• Agenti di programmazione: recupera gli ultimi snippet di codice, documenti e riferimenti tecnici.
• Agenti vocali: recupero web per supportare interazioni vocali in tempo reale e a bassa latenza.
• Agenti specifici per verticale: recupera informazioni aggiornate e specifiche per un dominio, personalizzate per un settore o un verticale di conoscenza particolare.
• Arricchimento dei dati: aumenta i set di dati interni con il contesto web e i metadati attuali.
• Workflow automatizzati: raccogli periodicamente notizie, persone, aziende o altri dati aggiornati di frequente per i workflow interni o di produzione.

Esempio

Chi ha vinto il Super Bowl 2026?

Senza grounding	Con messa a terra
Non posso dirti chi ha vinto il Super Bowl 2026 perché l'evento non si è ancora svolto.	I Seattle Seahawks hanno vinto il Super Bowl LX l'8 febbraio 2026, battendo i New England Patriots con un punteggio finale di 29-13. Fonti: dominio1.com, dominio2.com, ...

Modelli supportati

Questa sezione elenca i modelli che supportano il grounding con Exa Web Search.

Prima di iniziare

Per utilizzare Grounding con Exa, devi ottenere una chiave API dal sito web di Exa. Questa chiave API viene utilizzata nella tua richiesta a Gemini.

Grounding delle risposte di Gemini con Exa

Richiedi risposte basate su dati reali da Gemini utilizzando l'API REST come segue. 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.

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 Google Cloud .
• MODEL_ID: l'ID del modello da utilizzare.
• TEXT: il prompt di testo da inviare al modello.
• API_KEY: la tua chiave API per Exa Web Search.
• EXCLUDE_DOMAINS: (facoltativo) elenco dei domini da escludere dai risultati di ricerca. Se specificati, non verranno restituiti risultati da questi domini. Puoi specificare fino a 1200 domini.
• INCLUDE_DOMAINS: (facoltativo) elenco dei domini da includere nella ricerca. Se specificato, i risultati provengono solo da questi domini. Puoi specificare fino a 1200 domini.
• MAX_CHARACTERS: (facoltativo) il numero massimo di caratteri da restituire per i contenuti in evidenza. Controlla la lunghezza totale del testo evidenziato restituito per URL.
• NUM_RESULTS: (facoltativo) Il numero massimo di risultati di ricerca da utilizzare per la base. Se non specificato, il valore predefinito è 10.

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": [{
    "exaAiSearch": {
        "api_key": "API_KEY",
        "customConfigs": {
            "excludeDomains": ["EXCLUDE_DOMAINS"],
            "includeDomains": ["INCLUDE_DOMAINS"],
            "contents": {
                "highlights": {
                    "maxCharacters": MAX_CHARACTERS
                }
            },
            "numResults": NUM_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, 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 Seattle Seahawks won Super Bowl LX on February 8, 2026, defeating the New England Patriots with a final score of 29-13."
          }
        ]
      },
      "finishReason": "STOP",
      "groundingMetadata": {
        "webSearchQueries": [
          "who won the last super bowl"
        ],
        "groundingChunks": [
          {
            "web": {
              "uri": "https://...",
              "title": "Super Bowl LX",
              "domain": "domain.com"
            }
          },
          {
            "web": {
              "uri": "https://...",
              "title": "Super Bowl LX Results",
              "domain": "domain.com"
            }
          }
        ],
        "groundingSupports": [
          {
            "segment": {
              "endIndex": 125,
              "text": "The Seattle Seahawks won Super Bowl LX on February 8, 2026, defeating the New England Patriots with a final score of 29-13."
            },
            "groundingChunkIndices": [
              0,
              1
            ]
          }
        ]
      }
    }
  ],
  "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 hai bisogno di aumentare i limiti di frequenza, contatta [e-mail] e il tuo team dell'account Google indicando il caso d'uso e i requisiti.

Fatturazione

L'utilizzo di Grounding con Exa comporta i seguenti addebiti:

• Consumo di token di Gemini: token del prompt, token di ragionamento, token di output. Per ulteriori informazioni, consulta la sezione Prezzi.
• Grounding di Gemini con i tuoi dati: per ulteriori informazioni, consulta la sezione Prezzi.
• Prezzi per l'utilizzo dell'API di ricerca di Exa: per ulteriori informazioni, consulta la pagina dei prezzi di Exa.