Comprendere la chiamata di funzioni
In questa pagina
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.
Definisci gli strumenti
Descrivi le tue funzioni con schemi JSON: nome, descrizione, parametri attesi.
Invia la richiesta
Invii il messaggio dell'utente insieme alle definizioni degli strumenti all'API.
Ricevi il tool_call
Il modello restituisce un oggetto tool_call contenente il nome della funzione e gli argomenti JSON.
Esegui la funzione
Il tuo codice lato client esegue la funzione effettiva (chiamata API, query al database, calcolo...).
Restituisci il risultato
Invii il risultato dell'esecuzione al modello in un messaggio con il ruolo tool.
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