Abilitare la ricerca web nelle API
In questa pagina
Aggiornato il 2 novembre 2026. Basato sulla documentazione xAI: con
xai-sdk, la ricerca web si abilita tramite la funzioneweb_search()importata daxai_sdk.tools, in una conversazione creata daclient.chat.create; il vecchio esempio chiamavaclient.tools.web_search()eclient.responses.create, che non esistono in questo SDK. Fonte: Web Search.
Dai a Grok accesso al web in tempo reale
La ricerca web è lo strumento integrato più utilizzato nelle API di Grok. Permette al modello di cercare informazioni aggiornate sul web, superando il limite naturale dei suoi dati di addestramento. L’attivazione è semplice, ma ci sono punti chiave da padroneggiare per usarla efficacemente.
Prerequisiti: le API Responses
La ricerca web è disponibile esclusivamente sulle API Responses. La vecchia API Chat Completions offriva un sistema di “Live Search” ora deprecato. Se usi ancora Chat Completions per la ricerca web, devi migrare alle API Responses.
Le API Responses usano client.responses.create() invece di client.chat.completions.create(). La struttura della richiesta e della risposta differisce, ma sia l’SDK xAI che l’SDK OpenAI le supportano.
Attivazione di base
Abiliti la ricerca web aggiungendo un oggetto {"type": "web_search"} all’array tools nella tua richiesta:
{
"model": "grok-4.20-0309-reasoning",
"input": "What are the latest advancements in artificial intelligence?",
"tools": [
{"type": "web_search"}
]
}
Questo è tutto ciò che serve per una ricerca web di base. Il modello determina automaticamente se eseguire una ricerca e formula la query di ricerca ottimale partendo dal messaggio dell’utente.
Attivazione con l’SDK xAI (Python)
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.20-0309-reasoning",
tools=[web_search()],
)
chat.append(user("What are the latest advancements in AI?"))
response = chat.sample()
print(response.content)
print(response.citations)
L’SDK fornisce la funzione web_search(), che genera l’oggetto di configurazione dello strumento. Accetta anche allowed_domains o excluded_domains: fino a cinque domini, ma mai entrambi nella stessa richiesta.
Attivazione con l’SDK OpenAI
from openai import OpenAI
client = OpenAI(
api_key="xai-your-key",
base_url="https://api.x.ai/v1"
)
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What are the latest advancements in AI?",
tools=[{"type": "web_search"}]
)
L’SDK OpenAI funziona con le API Grok semplicemente cambiando il base_url. La sintassi dello strumento rimane identica.
Attivazione con l’SDK Vercel AI
import { xai } from "@ai-sdk/xai";
const response = await generateText({
model: xai("grok-4.20-0309-reasoning"),
prompt: "What are the latest advancements in AI?",
tools: [xai.tools.webSearch()]
});
L’SDK Vercel AI usa xai.tools.webSearch() seguendo la convenzione camelCase di JavaScript.
Combina la ricerca web con altri strumenti
Puoi abilitare più strumenti simultaneamente. Il modello sceglierà quello più appropriato o li userà in sequenza:
{
"tools": [
{"type": "web_search"},
{"type": "code_interpreter"}
]
}
In questo esempio, il modello può cercare dati sul web e poi analizzarli con l’esecuzione di codice.
Punti chiave
- La ricerca web è disponibile esclusivamente sulle API Responses: Chat Completions è deprecata per questa funzionalità
- Abilitala con
{"type": "web_search"}nell’arraytools - Il modello decide automaticamente quando e come cercare
- Tutti gli SDK (xAI, OpenAI, Vercel AI) supportano la ricerca web
- Puoi abilitare più strumenti simultaneamente nella stessa richiesta