Attivare la ricerca web nell'API di Grok
In questa pagina
Aggiornato il 2 novembre 2026. Basato sulla documentazione xAI: con
xai-sdk, la ricerca web si attiva tramite la funzioneweb_search()importata daxai_sdk.tools, all’interno di una conversazione creata conclient.chat.create; il vecchio esempio chiamavaclient.tools.web_search(), che non esiste in questo SDK. Fonte: Web Search.
Aggiornato il 3 novembre 2026. Il primo esempio chiamava
client.responses.create()sul clientxai-sdk, che non possiede l’attributoresponses: con questo SDK, la ricerca passa attraversoclient.chat.create(..., tools=[web_search()]), mentreclient.responses.create()appartiene all’SDKopenaipuntato suhttps://api.x.ai/v1. L’esempio con Vercel AI SDK passava gli strumenti come array e non importavagenerateText: vengono dichiarati in un oggetto, come nella documentazione xAI. Codice verificato conxai-sdk1.21.0 eopenai3.42.1. Fonte: Web Search.
Perché collegare Grok al web in tempo reale
I modelli linguistici classici lavorano con conoscenze congelate alla data del loro addestramento. Per uno sviluppatore che costruisce applicazioni che richiedono dati attuali (prezzi delle azioni, notizie, risultati sportivi, meteo), questo limite è insormontabile. Lo strumento web_search nell’API di Grok risolve il problema permettendo al modello di interrogare il web in tempo reale, direttamente dalla tua chiamata API.

A differenza di altri provider che richiedono integrazioni di terze parti o plugin separati, xAI offre la ricerca web come strumento integrato lato server. Non devi gestire alcuna infrastruttura: il modello decide quando cercare, esegue la query e integra i risultati nella sua risposta.
L’API Responses: l’unico endpoint supportato
La ricerca web funziona esclusivamente sull’API Responses. Il vecchio endpoint Chat Completions offriva un parametro search_parameters, ma ora è deprecato. Se stai migrando dalla vecchia API, dovrai adattare le tue chiamate.
L’attivazione avviene aggiungendo lo strumento web_search all’array tools nella tua richiesta:
import os
from openai import OpenAI
client = OpenAI(api_key=os.environ["XAI_API_KEY"], base_url="https://api.x.ai/v1")
response = client.responses.create(
model="grok-4.5",
input="What is the weather like in Paris today?",
tools=[{"type": "web_search"}],
)
print(response.output_text)
Questo esempio usa l’SDK openai, compatibile con l’API Responses di xAI; l’SDK nativo xAI, presentato di seguito, passa attraverso una conversazione.
Tutto qui. Il modello analizza il tuo prompt, determina se ha bisogno di informazioni fresche e attiva la ricerca automaticamente. Non devi gestire alcun ciclo di chiamate o logica condizionale.
Il flusso di esecuzione in cinque passaggi
Quando invii una richiesta con web_search abilitato, il processo segue una sequenza specifica:
- Analisi: il modello valuta se la domanda richiede dati recenti
- Decisione: sceglie se cercare o rispondere con le sue conoscenze interne
- Esecuzione: la ricerca web viene eseguita lato server (non gestisci nulla)
- Elaborazione: i risultati vengono analizzati e sintetizzati
- Risposta: il testo finale viene generato con le citazioni associate
Questo meccanismo significa che il modello può decidere di non cercare se la domanda non lo giustifica. Ad esempio, chiedere la definizione di fotosintesi probabilmente non attiverà una ricerca web.
Utilizzo con diversi SDK
L’SDK xAI fornisce una funzione dedicata, web_search(), da passare nell’elenco degli strumenti della conversazione:
# Native xAI SDK
from xai_sdk import Client
from xai_sdk.chat import user
from xai_sdk.tools import web_search
client = Client()
chat = client.chat.create(model="grok-4.5", tools=[web_search()])
chat.append(user("Latest AI news in Europe"))
response = chat.sample()
print(response.content)
print(response.citations)
Con l’SDK openai, si tratta della chiamata dall’inizio della lezione: client.responses.create() con base_url="https://api.x.ai/v1" e tools=[{"type": "web_search"}].
Per l’SDK Vercel AI in JavaScript:
import { xai } from '@ai-sdk/xai';
import { generateText } from 'ai';
const { text, sources } = await generateText({
model: xai.responses('grok-4.5'),
prompt: "Latest AI news in Europe",
tools: {
web_search: xai.tools.webSearch(),
},
});
console.log(text);
console.log('Citations:', sources);
Esercitazione pratica
Crea uno script che interroghi Grok su un evento attuale a tua scelta. Verifica che la risposta contenga informazioni recenti (date, eventi avvenuti dopo la data di cutoff del modello). Poi prova la stessa domanda senza lo strumento web_search per vedere la differenza.
Punti chiave
- La ricerca web si attiva con
{"type": "web_search"}intools(SDKopenai, API Responses) oweb_search()inclient.chat.create(xai-sdk) - Funziona solo sull’API Responses (non su Chat Completions)
- Il modello decide autonomamente quando ha bisogno di cercare
- Le citazioni sono incluse automaticamente nella risposta
- Il costo è di 5 $ per 1.000 chiamate allo strumento, più i token consumati