Κατανόηση τύπων δεδομένων για μεταβλητές
Πριν βουτήξουμε στις πρακτικές πτυχές της χρήσης των μεταβλητών, ας εξοικειωθούμε με τους διαφορετικούς διαθέσιμους τύπους δεδομένων στο Botpress.
- Σειρά: Οι συμβολοσειρές χρησιμοποιούνται για την αποθήκευση του κειμένου που μπορεί να αποτελείται από γράμματα, αριθμούς ή ειδικούς χαρακτήρες. Χρησιμοποιούνται συνήθως για την αποθήκευση των ονομάτων χρηστών ή των μηνυμάτων που δημιουργούνται από AI.
- Boolean: Τα Booleans μπορούν να έχουν μόνο δύο τιμές - true ή false. Είναι ιδανικά για την αποθήκευση των δυαδικών πληροφοριών, όπως εάν ένας χρήστης είναι πελάτης που επιστρέφει ή εάν ο χρήστης θέλει να ρωτήσει κάτι άλλο.
- Αριθμός: Όπως υποδηλώνει το όνομα, οι μεταβλητές αριθμού χρησιμοποιούνται για την αποθήκευση των αριθμητικών τιμών που μπορεί να είναι είτε ακέραιοι είτε αριθμοί με δεκαδικά ψηφία. Είναι χρήσιμα για την αποθήκευση αριθμών τηλεφώνου, κωδικών περιοχής και άλλων αριθμητικών δεδομένων.
- Ημερομηνία: Οι μεταβλητές Date χρησιμοποιούν τη μορφή ημερομηνίας/ώρας ISO 8601. Αντιπροσωπεύει είτε μια μεμονωμένη ημερομηνία είτε μια ημερομηνία και ώρα.
- Αντικείμενο: Μια μεταβλητή αντικειμένου είναι μια συλλογή ζευγών κλειδιών-τιμών που είναι παρόμοια με τα λεξικά ή τους χάρτες. Είναι πολύτιμα για την αποθήκευση πολύπλοκων δομών δεδομένων, όπως τα προφίλ χρηστών ή τα αποτελέσματα μιας κλήσης API.
- Πίνακας: Οι πίνακες χρησιμοποιούνται για την αποθήκευση των συλλογών παρόμοιων μεταβλητών. Μπορούν να συγκρατούν τις συμβολοσειρές ή τα αντικείμενα, καθιστώντας τα ευέλικτα για διάφορες περιπτώσεις χρήσης, όπως η αποθήκευση των προηγούμενων μηνυμάτων ενός χρήστη ή η παροχή των επιλογών για να επιλέξει ο χρήστης.
- Αριθμός: Αυτή είναι μια μεταβλητή με περιορισμένο σύνολο προκαθορισμένων επιλογών. Είναι κατάλληλα για σενάρια όπως η αποθήκευση των ημερών της εβδομάδας ή των διαθέσιμων στοιχείων σε ένα μενού φαγητού.
- Πρότυπο: Οι μεταβλητές μοτίβου χρησιμοποιούν τις κανονικές εκφράσεις (Regex) για να αποθηκεύσουν τα ειδικά μοτίβα που μπορούν να χρησιμοποιηθούν για την αντιστοίχιση συγκεκριμένων λέξεων ή αριθμών. Είναι βολικά για την αποθήκευση των αριθμών λογαριασμού ή των αριθμών πτήσης.
Κατανόηση των μεταβλητών πεδίων
Στο Botpress περιλαμβάνονται διάφοροι τύποι μεταβλητών και ποικίλλουν ανάλογα με το πού μπορούν να είναι προσβάσιμες στη ροή του chatbot σας. Ας εξερευνήσουμε τα διαφορετικά πεδία μεταβλητών, ξεκινώντας από το πιο περιορισμένο έως το ευρύτερο:
Μεταβλητές ροής εργασίας
Αυτές οι μεταβλητές ορίζονται και χρησιμοποιούνται σε μια ενιαία ή την ίδια ροή εργασίας. Είναι εξαιρετικά για ροές μίας χρήσης, όπως η αποθήκευση των εξόδων εργασιών AI, οι απαντήσεις των χρηστών σε ερωτήσεις ή η οργάνωση των δεδομένων από τις κλήσεις API.
Αυτά τα βήματα μπορούν να ακολουθηθούν για τη δημιουργία μιας μεταβλητής ροής εργασίας:
Βήμα 1. Επιλέξτε την κατάλληλη ροή εργασίας στο μενού 'Explorer'.
Βήμα 2. Κάνοντας διπλό κλικ σε μια κενή περιοχή στο πρόγραμμα επεξεργασίας ροής εργασίας ανοίγει ο πίνακας Επιθεωρητής.
Βήμα 3. Καθορίστε το όνομα της μεταβλητής, επιλέξτε τον τύπο δεδομένων της μεταβλητής και κάντε κλικ στο κουμπί 'Προσθήκη' για να δημιουργήσετε τη μεταβλητή.
Μπορείτε να προσθέσετε μια προεπιλεγμένη (αρχική) τιμή στη μεταβλητή σας από την ενότητα 'Πρόσθετες ρυθμίσεις'.
Μεταβλητές ροής εργασίας εισόδου και εξόδου
Για την ανταλλαγή πληροφοριών, οι ροές εργασίας μπορεί να έχουν μεταβλητές εισόδου και εξόδου. Οι είσοδοι χρησιμοποιούνται για τη λήψη πληροφοριών από εξωτερικές πηγές ή άλλες ροές εργασίας, ενώ οι έξοδοι παρέχουν πληροφορίες στις εξωτερικές πηγές ή άλλες ροές εργασίας. Αυτό επιτρέπει πιο ευέλικτη επικοινωνία και ανταλλαγή δεδομένων εντός του bot.
Αυτά τα βήματα μπορούν να ακολουθηθούν για τη σήμανση μιας μεταβλητής εισόδου:
Βήμα 1. Δημιουργήστε τη μεταβλητή μέσα στη ροή εργασίας.
Βήμα 2. Επιλέξτε τη μεταβλητή κάνοντας κλικ στον κόμβο εισαγωγής της ροής εργασίας στον πίνακα επιθεωρητή.
Αυτά τα βήματα μπορούν να ακολουθηθούν για τη σήμανση μιας μεταβλητής εξόδου:
Βήμα 1. Δημιουργήστε τη μεταβλητή μέσα στη ροή εργασίας.
Βήμα 2. Επιλέξτε τη μεταβλητή κάνοντας κλικ στον κόμβο εξόδου της ροής εργασίας στον πίνακα επιθεώρησης.
Μεταβλητές συνεδρίας
Όλες οι ροές μπορούν να έχουν πρόσβαση σε αυτές τις μεταβλητές, αλλά μόνο για μια μία συνομιλία. Είναι ιδανικά για την αποθήκευση των δεδομένων που χρησιμοποιούνται σε μια συνομιλία, όπως το ιστορικό συνομιλιών, τα στοιχεία που συλλέγονται σε ένα εικονικό καλάθι αγορών ή τα προσωρινά δεδομένα από κλήσεις API.
Για να δημιουργήσετε μια μεταβλητή συνεδρίας, μπορείτε να γράψετε τον ακόλουθο κώδικα:
session.variablename = 'Γεια σας παιδιά!' ;Για να χρησιμοποιήσετε τη μεταβλητή σας σε μια κάρτα κειμένου, πρέπει να την κλείσουμε στις σγουρές αγκύλες, π.χ. {{session.variablename}} .
Μεταβλητές Χρήστη
Οι μεταβλητές χρήστη ακολουθούν έναν χρήστη μεταξύ συνομιλιών, γεγονός που επιτρέπει στα δεδομένα να διατηρούνται σε πολλαπλές αλληλεπιδράσεις με το chatbot. Είναι ιδανικά για την αποθήκευση πληροφοριών που παραμένουν σχετικές με έναν χρήστη με την πάροδο του χρόνου, όπως προσωπικά στοιχεία, ετικέτες από προηγούμενες συνομιλίες ή προτιμήσεις γλώσσας.
Για να δημιουργήσετε μια μεταβλητή χρήστη:
Βήμα 1. Ανοίξτε τις 'Ρυθμίσεις Chatbot' από το εικονίδιο Botpress που βρίσκεται στην επάνω αριστερή γωνία.
Βήμα 2. Επιλέξτε 'Μεταβλητές' από τις καρτέλες.
Βήμα 3. Ορίστε τη μεταβλητή χρήστη ονομάζοντάς την και προσδιορίζοντας τον τύπο δεδομένων.
Είτε το @user.variablename είτε το {{user.variablename}} μπορούν να χρησιμοποιηθούν για αναφορά στη μεταβλητή 'Χρήστης' σε μια κάρτα κειμένου.
Μεταβλητές Bot
Όλοι οι χρήστες στο chatbot έχουν πρόσβαση σε αυτές τις μεταβλητές σε όλες τις συνομιλίες. Χρησιμοποιούνται συχνά για την αποθήκευση των πληροφοριών προγραμματιστή και της διαμόρφωσης, όπως η αποθήκευση τελικών σημείων για τις κλήσεις API, ο αριθμός έκδοσης του bot ή το όνομά του.
Ακολουθήστε αυτά τα βήματα για να δημιουργήσετε μια μεταβλητή Bot:
Βήμα 1. Επιλέξτε τις «Ρυθμίσεις Chatbot» κάνοντας κλικ στο εικονίδιο Botpress στην επάνω αριστερή γωνία.
Βήμα 2. Επιλέξτε 'Μεταβλητές' από τις καρτέλες.
Βήμα 3. Καθορίστε το όνομα και τον τύπο δεδομένων της μεταβλητής bot.
Όπως και οι μεταβλητές χρήστη, το @bot.variablename ή το bot.variablename μπορεί να χρησιμοποιηθεί για αναφορά σε μεταβλητές bot στις κάρτες.
Μεταβλητές Διαμόρφωσης
Είναι ένας ειδικός τύπος ασφαλούς μεταβλητής bot. Μπορείτε να τα διαχειριστείτε από το Cloud Dashboard και δεν χρειάζεται να ανοίξετε το bot. Οι μεταβλητές διαμόρφωσης είναι ιδανικές για την αποθήκευση ευαίσθητων πληροφοριών όπως διακριτικά API, ιδιωτικές διευθύνσεις IP ή διαπιστευτήρια βάσης δεδομένων.
Για να δημιουργήσετε μια μεταβλητή διαμόρφωσης:
Βήμα 1. Ανοίξτε τις 'Ρυθμίσεις Chatbot' από το εικονίδιο Botpress που βρίσκεται στην επάνω αριστερή γωνία.
Βήμα 2. Κάντε κλικ στην καρτέλα 'Μεταβλητές'.
Βήμα 3. Προσθέστε μια μεταβλητή διαμόρφωσης και δώστε το όνομα και την τιμή της.
Για να αποκτήσετε πρόσβαση στις μεταβλητές διαμόρφωσης στον κώδικα, μπορείτε να χρησιμοποιήσετε το 'env.key' όπου το 'key' αντιπροσωπεύει το όνομα της μεταβλητής διαμόρφωσης που πρόκειται να ανακτηθεί.
Χρήση μεταβλητών στον κώδικα
Οι αγκύλες '{{ }}' ή το σύμβολο @ δεν είναι απαραίτητες όταν χρησιμοποιούνται μεταβλητές στον κώδικα. Η σύνταξη για την πρόσβαση στις μεταβλητές στον κώδικα ακολουθεί το μοτίβο 'variabletype.variablename'. Για παράδειγμα:
Κώδικας:
- ροή εργασίας.αριθμός τηλεφώνου
- session.userAcctId
- user.firstName
- bot.endpoint
- env.apiKey
Οι μεταβλητές μπορούν να αντιστοιχιστούν με τιμές ή να ενημερωθούν στον κώδικα. Ωστόσο, είναι σημαντικό να διασφαλιστεί ότι η εκχωρημένη τιμή ταιριάζει με τον τύπο δεδομένων της μεταβλητής για να αποφευχθούν σφάλματα.
συμπέρασμα
Οι μεταβλητές είναι τα δομικά στοιχεία των δυναμικών και εξατομικευμένων αλληλεπιδράσεων στο Botpress. Χρησιμοποιώντας τους διάφορους τύπους δεδομένων και κατανοώντας τα μεταβλητά πεδία, οι προγραμματιστές μπορούν να δημιουργήσουν chatbots με ισχυρές δυνατότητες. Είτε θέλετε να αποθηκεύσετε τις πληροφορίες χρήστη, είτε η σύνδεση με API είτε η μετάδοση των δεδομένων μεταξύ ροών εργασίας και μεταβλητών στο Botpress παρέχουν την απαραίτητη ευελιξία και έλεγχο.