Rispondi con dati live dai tuoi sistemi
La chiamata agli strumenti permette al chatbot di chiamare la tua API durante una conversazione, leggere la risposta e usarla nella sua replica. Il cliente chiede informazioni sul suo ordine e il bot fornisce la risposta reale, non una generica.
L'addestramento insegna al chatbot cose che rimangono invariate. La chiamata agli strumenti copre ciò che cambia di minuto in minuto: stato di un ordine, numero di tracciamento, prenotazione. È una funzionalità avanzata che richiede codice personalizzato sul tuo server, quindi pianificala con chi si occupa dei tuoi sistemi.
Passo dopo passo
Decidi dove inserire la consultazione
La chiamata agli strumenti è utilizzata da Q&A e da Flows. Inseriscila in una Q&A quando una singola domanda necessita di una risposta live, e in un flow quando la consultazione è un passaggio di un percorso conversazionale più lungo.
Puntala al tuo endpoint
In URL, inserisci l'indirizzo dell'endpoint API che risponderà alla richiesta. In Headers, aggiungi le coppie chiave:valore necessarie al tuo endpoint. In Q&A le intestazioni sono separate da virgole; nei flow le aggiungi una per una.
Definisci cosa deve fornire il cliente
Le proprietà sono i valori che il chatbot deve raccogliere prima di poterti chiamare, ad esempio una città o un numero di tracciamento. Se i valori possibili sono noti in anticipo, elencali in Valori consentiti in modo che il bot rimanga all'interno di quell'insieme.
Leggi la richiesta sul tuo server
Inviiamo al tuo server questa struttura: {"sb":{"user_id":"123","conversation_id":"123","user_language":"es"},"arguments":{}} — come corpo JSON per POST e come intestazione per GET. Ogni chiave degli argomenti è il nome della proprietà in kebab case, quindi "Order Number" arriva come order-number. Puoi anche inserire un valore direttamente nell'URL con un campo di merge, ad esempio {order-number}.
Restituisci JSON utilizzabile dal chatbot
Il tuo server deve rispondere con un JSON contenente i valori che vuoi che il bot pronunci, ad esempio {"order_status":"Consegnato 2 ore e 25 minuti fa","success":true}. Includi "success": true solo quando la richiesta è effettivamente riuscita.
Riferimento impostazioni
| Impostazione | Cosa fa |
|---|---|
| URL | L'indirizzo del tuo endpoint API che il chatbot chiama. |
| Headers | Coppie chiave:valore inviate con la richiesta, separate da virgole in Q&A e aggiunte una per una nei flussi. |
| Properties | I valori che l'utente deve fornire prima che la chiamata possa essere effettuata, come una città o un numero di tracciamento. |
| Allowed values | Limita una proprietà a un insieme noto di opzioni anziché a testo libero. |
Da sapere
"success": true è una promessa, non una formalità
Restituiscilo solo quando la richiesta ha funzionato davvero. Se il numero d'ordine non è valido o non è stato trovato nulla, omettilo in modo che il chatbot non presenti un fallimento come risposta.
I nomi degli argomenti cambiano forma
I nomi delle proprietà arrivano in kebab case, quindi "Order Number" diventa order-number. Abbina quella grafia nel tuo codice e in qualsiasi campo di merge che inserisci nell'URL.
GET e POST ricevono i dati in modo diverso
Per POST, il payload arriva come corpo JSON. Per GET, arriva come header. Controlla quale metodo utilizza il tuo endpoint prima di iniziare a leggere la richiesta.
Ricevi contesto con ogni chiamata
La richiesta include user_id, conversation_id e user_language, così il tuo endpoint sa chi sta chiedendo e in quale lingua.
Questo richiede l'intervento di uno sviluppatore.
Il tools calling è una funzionalità avanzata. La parte del pannello è semplice, ma qualcosa sul tuo server deve ricevere la richiesta e restituire il JSON.
Domande frequenti
Dove posso usare il tools calling?
Cosa invii esattamente al mio server?
Come faccio a inserire il valore del cliente nel mio URL?
Cosa deve restituire il mio server?
Cosa succede se il cliente fornisce un numero che non esiste?
Posso limitare ciò che il cliente può inserire?
Pronto a mettere fine al caos?
Unifica i messaggi, automatizza le domande ripetitive e trasforma le conversazioni in fatturato, a partire da oggi.
Inizia