Ζωντανές πηγές δεδομένων (μενού, τιμοκατάλογος, απόθεμα)

Μια πηγή δεδομένων είναι ένα URL που σας ανήκει (μενού, τιμοκατάλογος, απόθεμα, διαθέσιμες ώρες) το οποίο η πλατφόρμα ανακτά σε πρόγραμμα, μετατρέπει σε απλό κείμενο και τοποθετεί μπροστά στον agent όταν ξεκινά η κλήση. Δεν γίνεται αναζήτηση κατά τη διάρκεια της κλήσης: ο agent απαντά στο «ποια είναι η φθηνότερη κρέπα;» από ολόκληρη τη λίστα, από την πρώτη λέξη.

Πότε να τη χρησιμοποιήσετε#

• Η βάση γνώσης είναι για έγγραφα που αλλάζουν σπάνια και αναζητούνται. Ένας κατάλογος που αλλάζει καθημερινά και πρέπει να διαβάζεται ολόκληρος (τιμές, τι περιλαμβάνει το καθετί) ταιριάζει καλύτερα σε πηγή δεδομένων.
• Ένα εργαλείο φέρνει μία απάντηση ενώ ο καλών περιμένει. Χρησιμοποιήστε εργαλείο για αναζητήσεις ανά πελάτη (παραγγελία, κράτηση) και πηγή δεδομένων για τη λίστα που ρωτούν όλοι.

Σύνδεση πηγής#

1. Ανοίξτε τον agent και πηγαίνετε στην καρτέλα Πηγές δεδομένων.
2. Πατήστε Προσθήκη πηγής και απαντήστε στο Από πού έρχονται τα δεδομένα; επιλέγοντας τον πάροχό σας. Η iotSoft POS είναι πρώτη στη λίστα. Αν ο πάροχός σας δεν υπάρχει, χρησιμοποιήστε Catalogue JSON API ή Text or CSV page. Για ένα έγγραφο της βάσης γνώσης, δείτε τις Εσωτερικές οδηγίες παρακάτω.
3. Συμπληρώστε το URL και, αν ο πάροχός σας το απαιτεί, το Access token. Το token αποθηκεύεται ως μυστικό στο project και δεν εμφανίζεται ποτέ ξανά.
4. Ορίστε Ανανέωση κάθε (λεπτά) (ελάχιστο 5, προεπιλογή 60) και, αν χρειάζεται, Μέγιστοι χαρακτήρες (προεπιλογή 15000).
5. Πατήστε Σύνδεση και λήψη. Η πρώτη λήψη γίνεται αμέσως, οπότε βλέπετε άμεσα αν η διεύθυνση και το token δουλεύουν.
6. Κάντε Σύνδεση της πηγής με τον agent και έπειτα Save και Deploy.

Η Προεπισκόπηση του τι βλέπει ο agent δείχνει το ακριβές κείμενο που παίρνει ο agent.

Πώς μένει ενημερωμένη#

Κάθε πηγή ανακτάται στο παρασκήνιο με το δικό της πρόγραμμα, από ακριβώς έναν διακομιστή κάθε φορά· καμία κλήση δεν περιμένει λήψη. Λήψη που δεν βρίσκει τίποτα νέο δεν αγγίζει τα αποθηκευμένα δεδομένα και σημειώνει μόνο πότε ελέγχθηκε η πηγή, οπότε η λίστα δείχνει και πότε ελέγχθηκε και πότε άλλαξε. Μια αποτυχημένη λήψη κρατά σε χρήση το τελευταίο καλό στιγμιότυπο και σημειώνει την πηγή ως error με την αιτία· τίποτα δεν αλλάζει στη μέση της κλήσης. Η Ανανέωση τώρα κάνει λήψη εκτός προγράμματος.

Εσωτερικές οδηγίες από τη βάση γνώσης#

Μια πηγή μπορεί να είναι και έγγραφο της βάσης γνώσης, για παράδειγμα το playbook πωλήσεων του agent. Έτσι το γράφετε και το βελτιώνετε στη βάση γνώσης, με πρόχειρο και δημοσίευση, και ο agent το ακολουθεί σε κάθε κλήση.

1. Στη Βάση γνώσης, γράψτε ή ανεβάστε το έγγραφο σε μια συλλογή που δεν ψάχνει ο agent, και δημοσιεύστε το.
2. Στην καρτέλα Πηγές δεδομένων του agent, πατήστε Προσθήκη πηγής και διαλέξτε Έγγραφο βάσης γνώσης.
3. Διαλέξτε Συλλογή και Έγγραφο. Στον Ρόλο αφήστε Εσωτερικές οδηγίες.
4. Πατήστε Σύνδεση και λήψη και μετά Save και Deploy.

Τι σημαίνει ο ρόλος Εσωτερικές οδηγίες:

• Ο agent ακολουθεί το κείμενο σαν μέρος των οδηγιών του. Δεν το διαβάζει, δεν το συνοψίζει και δεν επιβεβαιώνει ότι υπάρχει, όποιος κι αν ρωτήσει.
• Ένας agent δεν μπορεί να ψάχνει στη συλλογή από την οποία έρχονται οι οδηγίες του. Αν τη συνδέσετε και στη γνώση του, η αποθήκευση απορρίπτεται, γιατί ένας συνομιλητής θα μπορούσε να βρει το κείμενο με μια ερώτηση.
• Ο agent παίρνει πάντα τη δημοσιευμένη έκδοση. Όσο επεξεργάζεστε το έγγραφο, συνεχίζει με την τελευταία δημοσιευμένη. Μόλις δημοσιεύσετε, η επόμενη κλήση έχει τη νέα έκδοση.
• Αν αρχειοθετήσετε ή διαγράψετε το έγγραφο, ο agent σταματά αμέσως να το χρησιμοποιεί.
• Η λίστα δείχνει ποια έκδοση χρησιμοποιείται, και κάθε κλήση καταγράφει την έκδοση με την οποία έγινε.
• Ένα έγγραφο μεγαλύτερο από τους Μέγιστους χαρακτήρες δεν κόβεται: η πηγή δείχνει σφάλμα μέχρι να το συντομεύσετε ή να ανεβάσετε το όριο.

Κανένα κείμενο που βλέπει ένα μοντέλο δεν είναι απόλυτα κρυφό. Μη βάζετε στις οδηγίες ό,τι δεν πρέπει να βγει ποτέ προς τα έξω, όπως αμοιβές, κωδικούς ή στοιχεία πελατών.

Περιγραφή του δικού σας JSON#

Με το Catalogue JSON API, το Mapping (JSON) λέει στην πλατφόρμα πού βρίσκεται το καθετί στη ροή σας, σε dot notation: η λίστα κατηγοριών (list_path), το όνομα κατηγορίας, τα είδη, το όνομα και η τιμή κάθε είδους, τα συστατικά του και οι ομάδες επιλογών. Οι δωρεάν ομάδες γίνονται συστατικά του είδους ή επιλογή του πελάτη· οι ομάδες με χρέωση γίνονται έξτρα. Διορθώστε το mapping μέχρι η προεπισκόπηση να διαβάζεται όπως θα το άκουγε ένας πελάτης.

Καλό να ξέρετε#

• Έως 8 πηγές ανά agent.
• Ροή μεγαλύτερη από το όριο κόβεται σε όριο κατηγορίας και το κείμενο λέει ότι η λίστα συνεχίζεται, ώστε ο agent να μην ισχυριστεί ποτέ ότι ένα είδος δεν υπάρχει.
• Διευθύνσεις σε ιδιωτικά δίκτυα απορρίπτονται.
• Η διαγραφή μιας πηγής διαγράφει και το αποθηκευμένο token.