Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Strumenti integrati per le API di Risposta

Lezione 9 di 16 Aggiornata il 30 luglio 2026 Sviluppatore
In questa pagina
  1. Aggiunta di funzionalità al modello
  2. I 4 tipi di strumenti
  3. Combinazione di più strumenti
  4. Strumenti lato server vs lato client
  5. Punti chiave

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.

web_search
Ricerca web in tempo reale
x_search
Ricerca su X
code
Interprete Python
function
Funzioni personalizzate

I 4 tipi di strumenti

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.

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 function vengono 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