Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Abilitare la ricerca web nelle API

Lezione 4 di 16 Aggiornata il 2 novembre 2026 Sviluppatore
In questa pagina
  1. Dai a Grok accesso al web in tempo reale
  2. Prerequisiti: le API Responses
  3. Attivazione di base
  4. Attivazione con l’SDK xAI (Python)
  5. Attivazione con l’SDK OpenAI
  6. Attivazione con l’SDK Vercel AI
  7. Combina la ricerca web con altri strumenti
  8. Punti chiave

Aggiornato il 2 novembre 2026. Basato sulla documentazione xAI: con xai-sdk, la ricerca web si abilita tramite la funzione web_search() importata da xai_sdk.tools, in una conversazione creata da client.chat.create; il vecchio esempio chiamava client.tools.web_search() e client.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.

Risposte
API richiesta
5
Domini filtrabili
Automatico
Citazioni incluse
$5
/ 1.000 chiamate

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’array tools
  • 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