Far consultare dati a un agente vocale: strumenti e function calling
Come funziona il function calling negli agenti vocali: consultazioni e azioni, cosa rende valido uno strumento, i rischi dell'input vocale e un ritmo naturale.
Le informazioni che cambiano ogni ora non possono stare in un prompt. Lo stato di un ordine, una giacenza o uno slot per un appuntamento sono corretti solo per un momento. Per usare questi dati, un agente vocale ha bisogno di un modo per interrogare un altro sistema, e questo meccanismo di solito si chiama function calling o uso di strumenti (tool use).

Questa guida spiega in parole semplici come funziona, cosa rende valido uno strumento, dove si trovano i rischi e come l'idea si collega al modo in cui funzionano oggi gli agenti IA di Call. Per il contesto sulla catena vocale in sé, vedi Come funziona l'IA vocale in una telefonata.
Come funziona una chiamata a uno strumento
Un modello linguistico scrive testo. Non può aprire un database o premere un pulsante. Il function calling è una convenzione: descrivi al modello un insieme di funzioni, con un nome, uno scopo e gli input che ciascuna si aspetta, e il modello può rispondere con la richiesta di usarne una.
La vita di una chiamata a uno strumento
- Chi chiama chiedePer esempio: dov'è il mio ordine?
- Il modello propone una chiamataRestituisce il nome di una funzione e degli argomenti, come un numero d'ordine.
- Il tuo software validaControlla gli argomenti, i permessi di chi chiama ed eventuali limiti.
- Il sistema la esegueInterroga il sistema degli ordini e ottiene un risultato.
- Il risultato torna al modelloIl modello trasforma i dati in una breve risposta parlata.
Il punto chiave è che a eseguire l'azione è il tuo software, non il modello. Questo ti dà un punto in cui imporre regole, registrare cosa è successo e rifiutare qualsiasi cosa irragionevole.
Consultazioni e azioni
Non tutti gli strumenti comportano lo stesso rischio. Una consultazione legge informazioni. Un'azione cambia qualcosa nel mondo. Trattale in modo diverso.
Consultazioni in sola lettura e azioni che modificano qualcosa
| Consultazione | Azione | |
|---|---|---|
| Esempi | Orari di apertura, stato dell'ordine, lunghezza della coda | Annullare una prenotazione, emettere un rimborso, aggiornare un indirizzo |
| Rischio in caso di errore | Una risposta sbagliata, che si può correggere | Una modifica che può essere difficile da annullare |
| Tutele tipiche | Verifica dell'identità, campi limitati | Passaggio di conferma, approvazione umana, registro di controllo |
| Buon punto di partenza? | Sì | Solo dopo che le consultazioni funzionano bene |
Un percorso prudente è partire con le sole consultazioni, osservare le chiamate reali e aggiungere azioni lentamente, con una persona che conferma tutto ciò che ha conseguenze. È lo stesso atteggiamento alla base di Limiti di sicurezza per gli agenti vocali IA.
Cosa rende valido uno strumento
- Un solo scopo chiaro. Uno strumento chiamato get_order_status è più facile da scegliere correttamente per un modello rispetto a uno strumento che fa cinque cose.
- Pochi input semplici. Chiedi un numero d'ordine, non un lungo campo di testo libero.
- Un risultato breve e strutturato. Restituisci i pochi campi che l'agente dirà ad alta voce, non un intero record.
- Messaggi di errore semplici. Restituisci "non trovato" o "riprova più tardi" in una forma che il modello possa trasformare in una frase cortese.
- Una risposta rapida. Gli strumenti lenti fanno aspettare chi chiama nel silenzio.
Nomi e descrizioni contano
Il modello sceglie gli strumenti in base ai nomi e alle descrizioni che gli dai. Una formulazione vaga porta a scelte sbagliate. Scrivi le descrizioni come istruzioni per un nuovo collega: quando usare lo strumento, quando no e cosa significa ogni input.
L'input vocale è disordinato
Gli argomenti provengono dal parlato. Un numero d'ordine può arrivare con una cifra sbagliata, o un nome con una grafia insolita. Ripeti a chi chiama i valori chiave prima di usarli, e progetta lo strumento perché dia un risultato utile anche per le corrispondenze quasi esatte. Nomi, numeri e indirizzi corretti a voce tratta nel dettaglio le tecniche di conferma.
I rischi di cui tenere conto nella progettazione
Dove l'uso degli strumenti va storto
- Strumento o argomenti sbagliatiIl modello interpreta male la richiesta, quindi valida tutto prima di eseguire.
- Condivisione eccessivaUna consultazione restituisce più di quanto chi chiama dovrebbe sentire, quindi restituisci solo il necessario.
- Identità non verificataLeggere i dati di un conto alla persona sbagliata, quindi verifica prima di comunicare.
- Sistemi lenti o in erroreSilenzi morti o errori confusi, quindi fissa limiti di tempo e ripieghi da pronunciare.
- Istruzioni iniettateTesto in un risultato che cerca di dare ordini al modello, quindi tratta i risultati solo come dati.
Ogni rischio ha una risposta tecnica, ma il principio di progettazione più sicuro è dare all'agente il minimo accesso necessario per il compito. Non dargli una connessione generica al database quando basta una singola consultazione mirata.
Mantenere naturale la chiamata
Una chiamata a uno strumento aggiunge tempo: il modello decide, il tuo sistema risponde, il modello scrive la risposta e viene prodotta la voce. Chi chiama sente silenzio. Tra le tattiche utili ci sono una brevissima presa d'atto prima di una consultazione, la memorizzazione nella cache dei valori che cambiano di rado e il limite di una chiamata a uno strumento per turno. Latenza nell'IA vocale descrive da dove nasce il ritardo. Se una consultazione fallisce o va in timeout, l'agente deve dirlo brevemente e offrire un messaggio o una persona invece di aspettare.
Un esempio passo per passo
Immagina un ipotetico negozio di mobili il cui agente risponde a domande sulle consegne. Il negozio definisce un unico strumento in sola lettura che riceve un numero d'ordine e restituisce lo stato e la fascia oraria della consegna. All'agente viene detto di usarlo solo dopo che chi chiama ha fornito un numero d'ordine e lo ha confermato sentendolo ripetere.
- Chi chiama dice che sta aspettando un divano e fornisce un numero d'ordine.
- L'agente ripete il numero a gruppi e chi chiama conferma.
- Lo strumento restituisce lo stato "in consegna" e una fascia oraria pomeridiana.
- L'agente dice che l'ordine è in consegna e dovrebbe arrivare nel pomeriggio, poi chiede se serve altro.
- Se lo strumento restituisce "non trovato", l'agente dice che non riesce a trovare l'ordine e offre di prendere un messaggio per il team.
Nota cosa manca: l'agente non può riprogrammare la consegna. Se chi chiama vuole un altro giorno, l'agente raccoglie la richiesta e se ne occupa il team. Partire con uno strumento mirato e sicuro come questo ti insegna come parlano davvero le persone prima di ampliare l'ambito. Tieni traccia di ogni chiamata ricevuta dallo strumento, così puoi individuare degli schemi, come una cifra frequentemente fraintesa, e correggerli nel passaggio di conferma.
Il collegamento con Call
In Call, un agente IA risponde in base alle sue istruzioni, alla sua persona, al copione associato alla linea e ai passaggi della base di conoscenza pertinenti alla domanda. Non è progettato per compiere azioni come prenotare o confermare appuntamenti, richiamare, inviare qualcosa o offrire sconti durante la chiamata. Lo dice e indica la strada descritta nelle tue fonti, per esempio un link di prenotazione o una richiamata dal tuo team. Per i dati che cambiano spesso, tienili nelle fonti dell'agente e aggiornali, e usa l'Assistenza (help desk) per il lavoro di follow-up che richiede una persona. Se vuoi collegare Call ai tuoi sistemi, l'interfaccia per sviluppatori è descritta in API e webhook di Call per sviluppatori; verifica cosa offre prima di progettare in base a un comportamento specifico.
Quando valuti una piattaforma che pubblicizza l'uso di strumenti, fai le domande pratiche della checklist qui sotto.
Domande da fare sugli strumenti di un agente vocale
- Quali sistemi può raggiungere, e con quali permessi?
- Le consultazioni sono separate dalle azioni che modificano i dati?
- Esiste un registro di ogni chiamata effettuata, con argomenti e risultati?
- Cosa succede quando una consultazione fallisce o è lenta?
- Una persona può approvare le azioni con conseguenze?
- Come viene verificata l'identità di chi chiama prima di comunicare dei dati?
- Puoi testare gli strumenti con input vocali realistici prima del lancio?
Per la parte di valutazione, vedi Come valutare le conversazioni di un agente vocale.
Domande frequenti
Cos'è il function calling in parole semplici?
È un modo con cui un modello di IA chiede al tuo software di fare qualcosa, come cercare un ordine. Il modello scrive la richiesta, il tuo sistema la esegue e restituisce il risultato perché il modello lo spieghi.
È l'IA a eseguire la funzione?
No. Il modello si limita a proporre la chiamata. È il tuo codice a verificarla ed eseguirla, ed è lì che puoi applicare regole, limiti e registrazione.
È sicuro lasciare che un agente vocale modifichi i dati?
Si può fare con attenzione, ma inizia con consultazioni in sola lettura. Per tutto ciò che modifica i dati, aggiungi conferme, limiti e l'approvazione di una persona dove la posta in gioco è alta.
Perché una consultazione rende lenta la chiamata?
Ogni passaggio richiede tempo: decidere la chiamata, eseguirla, scrivere la risposta e pronunciarla. Strumenti veloci, una breve presa d'atto e una sola consultazione per turno mantengono il ritardo tollerabile.
Chi chiama può ingannare l'agente e fargli usare male uno strumento?
Può provarci. Valida gli argomenti, controlla i permessi nel tuo codice e dai all'agente strumenti mirati, così una richiesta sbagliata non può fare danni reali.
L'agente IA di Call consulta i miei sistemi?
L'agente di Call lavora a partire da istruzioni, copione e fonti di conoscenza, e non prenota, invia o conferma nulla durante la chiamata. Tieni i dati variabili nelle sue fonti e affida il follow-up al team.