Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Attivare la ricerca web nell'API di Grok

Lezione 1 di 14 Aggiornata il 3 novembre 2026 Principiante
In questa pagina
  1. Perché collegare Grok al web in tempo reale
  2. L’API Responses: l’unico endpoint supportato
  3. Il flusso di esecuzione in cinque passaggi
  4. Utilizzo con diversi SDK
  5. Esercitazione pratica
  6. Punti chiave

Aggiornato il 2 novembre 2026. Basato sulla documentazione xAI: con xai-sdk, la ricerca web si attiva tramite la funzione web_search() importata da xai_sdk.tools, all’interno di una conversazione creata con client.chat.create; il vecchio esempio chiamava client.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 client xai-sdk, che non possiede l’attributo responses: con questo SDK, la ricerca passa attraverso client.chat.create(..., tools=[web_search()]), mentre client.responses.create() appartiene all’SDK openai puntato su https://api.x.ai/v1. L’esempio con Vercel AI SDK passava gli strumenti come array e non importava generateText: vengono dichiarati in un oggetto, come nella documentazione xAI. Codice verificato con xai-sdk 1.21.0 e openai 3.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.

Ricerca web con Grok

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.

$5
per 1.000 chiamate
5
domini filtrabili
0
infrastruttura da gestire
Auto
citazioni incluse

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:

  1. Analisi: il modello valuta se la domanda richiede dati recenti
  2. Decisione: sceglie se cercare o rispondere con le sue conoscenze interne
  3. Esecuzione: la ricerca web viene eseguita lato server (non gestisci nulla)
  4. Elaborazione: i risultati vengono analizzati e sintetizzati
  5. 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"} in tools (SDK openai, API Responses) o web_search() in client.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