Le due categorie di strumenti Grok
In questa pagina
Comprendere l’ecosistema degli strumenti API di Grok
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.
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:
- Descrivi le tue funzioni (nome, parametri, descrizione) nella richiesta
- Il modello analizza la richiesta dell’utente
- Se determina che è necessaria una funzione, restituisce una chiamata di funzione con gli argomenti
- Il tuo codice esegue la funzione (chiamata API, query al database, calcolo…)
- Invii il risultato al modello
- 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