Fonti di dati in tempo reale (menu, listino prezzi, scorte)

Una fonte di dati è un URL di sua proprietà (un menu, un listino prezzi, le scorte, gli orari disponibili) che la piattaforma recupera secondo un calendario, trasforma in testo semplice e mette davanti all'agent quando inizia la chiamata. Nessuna ricerca durante la chiamata: l'agent risponde a «qual è la crêpe più economica?» dall'intera lista, fin dalla prima parola.

Quando usarla#

• La base di conoscenza è per documenti che cambiano raramente e vengono cercati. Un catalogo che cambia ogni giorno e va letto per intero (prezzi, cosa include cosa) si adatta meglio a una fonte di dati.
• Uno strumento recupera una risposta mentre il chiamante attende. Usi uno strumento per le ricerche per cliente (un ordine, una prenotazione) e una fonte di dati per la lista che tutti chiedono.

Collegare una fonte#

1. Apra l'agent e vada alla scheda Data sources.
2. Clicchi Add data source e risponda a Where does the data come from? scegliendo il suo fornitore. iotSoft POS è il primo della lista; se il suo fornitore non c'è, usi Catalogue JSON API o Text or CSV page.
3. Inserisca l'URL e, se il fornitore lo richiede, l'Access token. Il token viene salvato come segreto nel progetto e non viene più mostrato.
4. Imposti Refresh every (minutes) (minimo 5, predefinito 60) e, se serve, Max characters (predefinito 15000).
5. Clicchi Connect and fetch. Il primo recupero avviene subito, così vede immediatamente se indirizzo e token funzionano.
6. Attach la fonte all'agent, poi Save e Deploy.

Preview what the agent sees mostra il testo esatto che riceve l'agent.

Come resta aggiornata#

Ogni fonte viene recuperata in background con il proprio calendario, da esattamente un server alla volta; una chiamata non attende mai un recupero. Un recupero che non trova nulla di nuovo lascia intatti i dati salvati e annota solo quando la fonte è stata controllata: la lista mostra sia l'ultimo controllo sia l'ultima modifica. Un recupero fallito mantiene in uso l'ultimo stato valido e segna la fonte come error con il motivo; nulla cambia a metà chiamata. Refresh now recupera fuori calendario.

Descrivere il proprio JSON#

Con Catalogue JSON API, il Mapping (JSON) dice alla piattaforma dove si trova ogni cosa nel suo feed, in notazione puntata: la lista delle categorie (list_path), il nome della categoria, gli articoli, nome e prezzo di ogni articolo, i suoi ingredienti e i gruppi di opzioni. I gruppi gratuiti diventano gli ingredienti dell'articolo o una scelta del cliente; i gruppi a pagamento diventano extra. Regoli il mapping finché l'anteprima si legge come la sentirebbe un cliente.

Buono a sapersi#

• Fino a 8 fonti per agent.
• Un feed più grande del limite viene tagliato al confine di una categoria e il testo dice che la lista continua, così l'agent non afferma mai che un articolo non esiste.
• Gli indirizzi su reti private vengono rifiutati.
• Eliminare una fonte elimina anche il token salvato.