Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Comprendere la chiamata di funzioni

Lezione 1 di 14 Aggiornata il 29 luglio 2026 Sviluppatore
In questa pagina
  1. Cos’è la chiamata di funzioni?
  2. Il flusso in 6 passaggi
  3. Perché la chiamata di funzioni è così importante?
  4. La differenza rispetto a un prompt standard
  5. Limiti da conoscere
  6. Punti chiave

Cos’è la chiamata di funzioni?

La chiamata di funzioni è una delle funzionalità più potenti dell’API Grok. Consente al modello di richiedere l’esecuzione di funzioni che hai definito, per recuperare dati o eseguire azioni nel mondo reale.

Punto fondamentale da capire: Grok non esegue mai le funzioni direttamente. Il modello analizza la tua richiesta, determina che necessita di informazioni esterne e ti restituisce una chiamata strutturata (nome della funzione + argomenti). È il tuo codice lato client a eseguire effettivamente la funzione, per poi inviare il risultato al modello.

Il flusso in 6 passaggi

Ogni interazione di chiamata di funzioni segue un ciclo preciso di sei passaggi. Questo flusso è fondamentale: struttura l’intera tua architettura.

1

Definisci gli strumenti

Descrivi le tue funzioni con schemi JSON: nome, descrizione, parametri attesi.

2

Invia la richiesta

Invii il messaggio dell'utente insieme alle definizioni degli strumenti all'API.

3

Ricevi il tool_call

Il modello restituisce un oggetto tool_call contenente il nome della funzione e gli argomenti JSON.

4

Esegui la funzione

Il tuo codice lato client esegue la funzione effettiva (chiamata API, query al database, calcolo...).

5

Restituisci il risultato

Invii il risultato dell'esecuzione al modello in un messaggio con il ruolo tool.

6

Risposta finale

Il modello integra il risultato e genera una risposta in linguaggio naturale per l'utente.

Perché la chiamata di funzioni è così importante?

Senza la chiamata di funzioni, un modello linguistico è limitato alle conoscenze apprese durante l’addestramento. Non può consultare un database, interrogare un’API di terze parti o eseguire un calcolo in tempo reale. La chiamata di funzioni risolve questo problema fondamentale, dando al modello la capacità di interagire con il mondo esterno in modo strutturato e controllato.

Ecco alcuni casi d’uso concreti:

  • Dati in tempo reale: meteo, prezzi delle azioni, stati degli ordini
  • Azioni aziendali: creare un ticket, inviare un’email, prenotare uno slot
  • Calcoli precisi: operazioni matematiche, conversioni, aggregazioni
  • Database: ricerca prodotti, storico clienti, inventario

La differenza rispetto a un prompt standard

In uno scambio standard, poni una domanda e il modello risponde direttamente. Con la chiamata di funzioni, il modello può mettere in pausa la sua risposta per richiedere informazioni aggiuntive tramite una chiamata di funzione. È questa capacità di interrompere il flusso di generazione a rendere il meccanismo così potente.

Il modello ragiona così: «Per rispondere a questa domanda, ho bisogno del meteo attuale a Parigi. Chiamerò la funzione get_weather con il parametro city: Paris».

Limiti da conoscere

L’API Grok accetta fino a 200 strumenti per richiesta. Questo è più che sufficiente per la maggior parte dei casi d’uso, ma tieni presente che ogni definizione di strumento consuma token di input. Più strumenti dichiari, più costosa diventa la richiesta e più tempo impiega il modello per scegliere lo strumento giusto.

Punti chiave

  • La chiamata di funzioni permette al modello di richiedere l’esecuzione di funzioni, non di eseguirle direttamente
  • Il flusso segue sempre 6 passaggi: definisci, invia, ricevi, esegui, restituisci, rispondi
  • Le funzioni vengono eseguite lato client, nel tuo codice
  • Massimo 200 strumenti per richiesta
  • Ogni definizione di strumento consuma token: sii selettivo