Strumenti integrati per le API di Risposta
In questa pagina
Aggiunta di funzionalità al modello
I modelli Grok non si limitano alla generazione di testo. Grazie al parametro tools, puoi fornire loro accesso a strumenti che ne estendono significativamente le capacità: ricerca web in tempo reale, ricerca su X (ex Twitter), esecuzione di codice Python e le tue funzioni personalizzate.
I 4 tipi di strumenti
web_search
Consente al modello di cercare informazioni sul web in tempo reale:
{
"model": "grok-4.20-0309-reasoning",
"input": "What's the latest news on AI in Europe?",
"tools": [{"type": "web_search"}]
}
Il modello decide automaticamente quando effettuare una ricerca. I risultati vengono integrati nella sua risposta con le relative citazioni.
x_search
Cerca post su X (ex Twitter):
{
"model": "grok-4.20-0309-reasoning",
"input": "What is the tech community saying about the latest iPhone?",
"tools": [{"type": "x_search"}]
}
Particolarmente utile per cogliere l’opinione pubblica, le tendenze e le reazioni in tempo reale.
code_interpreter
Esegue codice Python lato server per calcoli, analisi dati o creazione di grafici:
{
"model": "grok-4.20-0309-reasoning",
"input": "Calculate the mean and standard deviation of these values: 12, 15, 18, 22, 9, 31",
"tools": [{"type": "code_interpreter"}]
}
Il modello scrive codice Python, lo esegue sui server di xAI e integra i risultati nella sua risposta.
function
Le tue funzioni personalizzate che il modello può invocare. Il modello genera gli argomenti, ma è il tuo codice a eseguire la funzione:
{
"model": "grok-4.20-0309-reasoning",
"input": "What's the weather in Paris?",
"tools": [{
"type": "function",
"name": "get_weather",
"description": "Retrieves the weather for a given city",
"parameters": {
"type": "object",
"properties": {
"city": {"type": "string", "description": "City name"},
"unit": {"type": "string", "enum": ["celsius", "fahrenheit"]}
},
"required": ["city"]
}
}]
}
Combinazione di più strumenti
Puoi inviare fino a 128 strumenti in una singola richiesta. Il modello sceglie quello (o quelli) più appropriati:
{
"model": "grok-4.20-0309-reasoning",
"input": "Search for the latest Ligue 1 results and create a scoreboard.",
"tools": [
{"type": "web_search"},
{"type": "code_interpreter"}
]
}
In questo esempio, il modello potrebbe prima usare web_search per trovare i risultati, quindi code_interpreter per formattarli in una tabella.
Strumenti lato server vs lato client
La distinzione è fondamentale:
-
Strumenti lato server (
web_search,x_search,code_interpreter): Eseguiti automaticamente dai server di xAI. Non devi fare nulla: il modello avvia la ricerca o il codice, recupera il risultato e lo integra nella sua risposta. -
Strumenti lato client (
function): Il modello genera una chiamata di funzione con gli argomenti, quindi mette in pausa la generazione. Il tuo codice esegue la funzione e tu invii il risultato in una nuova richiesta.
Questa differenza ha un impatto diretto sull’architettura della tua applicazione, come vedrai nelle prossime lezioni.
Punti chiave
- Quattro tipi di strumenti:
web_search,x_search,code_interpreter,function - I primi tre vengono eseguiti lato server: nessuna infrastruttura richiesta da parte tua
- Gli strumenti
functionvengono eseguiti lato client: il tuo codice gestisce l’esecuzione - Puoi combinare fino a 128 strumenti per richiesta
- Il modello decide automaticamente quando e quali strumenti utilizzare