Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Le due categorie di strumenti Grok

Lezione 1 di 16 Aggiornata il 30 luglio 2026 Sviluppatore
In questa pagina
  1. Comprendere l’ecosistema degli strumenti API di Grok
  2. Strumenti integrati — Lato server
  3. Chiamata di funzione — Lato client
  4. Quando utilizzare ciascuna categoria
  5. Punti chiave

Comprendere l’ecosistema degli strumenti API di Grok

Panoramica degli strumenti nella documentazione L’API di Grok fa molto più che generare testo. Fornisce un insieme di strumenti che permettono al modello di interagire con il mondo esterno: cercare informazioni in tempo reale, analizzare dati sui social media o eseguire codice Python. Per sfruttare queste capacità, devi capire come sono organizzate.

L’API di Grok distingue due categorie fondamentali di strumenti. Questa distinzione determina chi esegue lo strumento, dove avviene l’elaborazione e cosa devi gestire come sviluppatore.

Strumenti integrati — Lato server

Gli strumenti integrati vengono eseguiti direttamente sui server di xAI. Quando il modello decide di utilizzare uno di questi strumenti, l’esecuzione è automatica e trasparente. Non devi gestire alcuna infrastruttura né elaborare risultati intermedi.

🔍
Web Search
Real-time web search
𝕏
X Search
Search on X/Twitter
🐍
Code Execution
Isolated Python sandbox
📁
Collections Search
Search within your documents
🔌
Remote MCP
External MCP servers

Ecco i cinque strumenti integrati disponibili:

  • Web Search (web_search): Ricerca web in tempo reale, con filtraggio per dominio e citazioni automatiche
  • X Search (x_search): Ricerca su X/Twitter, con filtraggio per account e data
  • Code Execution (code_interpreter / code_execution): Esecuzione di codice Python in un ambiente sandbox sicuro
  • Collections Search (collections_search / file_search): Ricerca all’interno dei documenti che hai caricato in precedenza
  • Remote MCP (mcp): Connessione a server MCP (Model Context Protocol) esterni

Per abilitare uno strumento integrato, ti basta aggiungerlo all’array tools nella tua richiesta:

{
  "tools": [{"type": "web_search"}]
}

Chiamata di funzione — Lato client

La chiamata di funzione (Function Calling) funziona in modo diverso. Definisci funzioni personalizzate che il modello può invocare. Tuttavia, a differenza degli strumenti integrati, è il tuo codice lato client a eseguire la funzione e a restituire il risultato al modello.

Il flusso è il seguente:

  1. Descrivi le tue funzioni (nome, parametri, descrizione) nella richiesta
  2. Il modello analizza la richiesta dell’utente
  3. Se determina che è necessaria una funzione, restituisce una chiamata di funzione con gli argomenti
  4. Il tuo codice esegue la funzione (chiamata API, query al database, calcolo…)
  5. Invii il risultato al modello
  6. Il modello formula la sua risposta finale

Questo approccio ti offre il pieno controllo: decidi cosa fanno le tue funzioni, quali dati gestiscono e come si connettono alla tua infrastruttura.

Quando utilizzare ciascuna categoria

Gli strumenti integrati sono ideali quando hai bisogno di accedere a informazioni in tempo reale (web, social media) o devi eseguire calcoli senza gestire infrastrutture. La chiamata di funzione è preferibile quando devi interagire con i tuoi sistemi: database interni, API aziendali o qualsiasi servizio specifico della tua applicazione.

Puoi combinare entrambe le categorie in un’unica richiesta. Ad esempio, puoi abilitare la ricerca Web definendo contemporaneamente una funzione personalizzata che salva i risultati nel tuo database.

Punti chiave

  • L’API di Grok offre due categorie di strumenti: strumenti integrati (eseguiti da xAI) e chiamata di funzione (eseguita dal tuo codice)
  • Gli strumenti integrati non richiedono infrastrutture lato client
  • La chiamata di funzione offre il pieno controllo ma richiede più sviluppo
  • Entrambe le categorie possono essere combinate in un’unica richiesta
  • Questo corso si concentra sui tre principali strumenti integrati: Web Search, X Search ed Esecuzione del codice