Τεκμηρίωση

Οδηγός ρύθμισης για την παραμετροποίηση του chatbot σας, τη σύνδεση πηγών γνώσης, τη δημοσίευση του widget και την κατανόηση της εμπειρίας των επισκεπτών σας.

1) Σύνδεση και Πρόσβαση

Συνδεθείτε στον λογαριασμό σας για να ανοίξετε τον πίνακα διαχείρισης. Εκεί ρυθμίζετε το chatbot σας, διαχειρίζεστε τη γνώση του και δημιουργείτε τον κώδικα που χρησιμοποιείται στον ιστότοπό σας.

Δεν βλέπουν όλοι οι λογαριασμοί τις ίδιες επιλογές. Οι τυπικοί λογαριασμοί πελατών συνήθως χρησιμοποιούν τις καρτέλες General, Knowledge Files, Knowledge Bases, Routing, Widget, Logs και Profile. Ορισμένες ρυθμίσεις υποδομής, όπως σύνδεση API, μοντέλα πλατφόρμας, διαχείριση πακέτων και διαχείριση χρηστών, εξαρτώνται από τα δικαιώματα του λογαριασμού σας.

2) Τι Κάνει Κάθε Καρτέλα

Ο πίνακας διαχείρισης είναι οργανωμένος σε καρτέλες. Κάθε καρτέλα ελέγχει διαφορετικό μέρος της ρύθμισης ή της καθημερινής λειτουργίας:

• General: Ελέγχει τη δημιουργικότητα απαντήσεων του βοηθού, τη διάρκεια cache, τα επιτρεπόμενα URLs ιστοτόπων, τις λέξεις-κλειδιά προς αγνόηση και το βασικό system prompt.
• Knowledge Files: Αποθηκεύει ανεβασμένα έγγραφα που μετατρέπονται σε γνώση κειμένου, με προαιρετικές συλλογές αναζήτησης ανά αρχείο.
• Knowledge Bases: Συνδέει δυναμικές πηγές όπως XML feeds, RSS feeds ή αποθετήρια GitHub για ευρετηρίαση.
• Routing: Αποφασίζει ποια συλλογή αναζητείται πρώτη με βάση λέξεις-κλειδιά, κανόνες domain, πρόθεση συλλογής και όρια βαθμολογίας.
• Widget: Ελέγχει την εμφάνιση του chatbot, τα κείμενα γλώσσας, τι βλέπουν οι χρήστες όταν δεν βρίσκεται απάντηση και πώς ενσωματώνεται η συνομιλία στον ιστότοπό σας.
• Logs: Σας επιτρέπει να φιλτράρετε και να ελέγχετε αποθηκευμένες συνομιλίες και να τις εξάγετε σε CSV για ανάλυση.
• Profile: Αποθηκεύει στοιχεία επικοινωνίας, επιλογές αλλαγής κωδικού και πληροφορίες μηνιαίας χρήσης.

3) Ρύθμιση Βασικής Συμπεριφοράς

• Δημιουργικότητα απάντησης: Χρησιμοποιήστε το slider στην καρτέλα General για να ελέγξετε πόσο εστιασμένες ή ποικίλες θα είναι οι απαντήσεις. Οι χαμηλές τιμές είναι πιο συνεπείς. Οι υψηλές τιμές είναι πιο ευέλικτες.
• Cache TTL: Ορίστε πόσο χρόνο οι απαντήσεις παραμένουν στην cache. Χρησιμοποιήστε 0 για απενεργοποίηση της cache. Χρησιμοποιήστε το κουμπί καθαρισμού αν θέλετε να αφαιρέσετε χειροκίνητα ληγμένες εγγραφές cache.
• Επιτρεπόμενα URLs: Προσθέστε ένα URL ιστοτόπου ή domain ανά γραμμή για ιστότοπους που επιτρέπεται να φορτώνουν το widget σας. Αυτή η ρύθμιση είναι σημαντική στη δημοσίευση, επειδή άδεια λίστα μπλοκάρει την ενσωματωμένη χρήση.
• Λέξεις προς αγνόηση στην αναζήτηση: Προσθέστε λέξεις που πρέπει να αγνοούνται όταν το σύστημα δημιουργεί keyword searches. Αυτό επηρεάζει το live chat, το test routing και το test search.
• Βασικό system prompt: Γράψτε τις βασικές οδηγίες που ορίζουν ύφος, κανόνες, επιχειρηματικούς περιορισμούς και τον τρόπο που ο βοηθός θα χρησιμοποιεί τη γνώση σας.

4) Προσθήκη Πηγών Γνώσης

• Knowledge Files: Ανεβάστε αρχεία PDF, TXT, CSV, XLS, XLSX, DOC ή DOCX. Τα ανεβασμένα αρχεία μετατρέπονται σε γνώση κειμένου για ευρετηρίαση.
• Ονομασία αρχείου εξόδου: Προαιρετικά μπορείτε να μετονομάσετε το μετατρεπόμενο αρχείο κατά το ανέβασμα. Το αποθηκευμένο αρχείο γνώσης πρέπει να τελειώνει σε .txt.
• Επεξεργασία και δομή περιεχομένου: Μέσα στον editor αρχείου μπορείτε να χωρίσετε το περιεχόμενο με δείκτες παραγράφων, επικεφαλίδες Markdown ή κενές γραμμές ώστε το search index να το διασπά πιο σωστά.
• Συλλογές ανά αρχείο: Κάθε αρχείο γνώσης μπορεί να χρησιμοποιεί την προεπιλεγμένη συλλογή ή συγκεκριμένη συλλογή αναζήτησης.
• Knowledge Bases: Προσθέστε ζωντανές πηγές από XML, RSS ή GitHub. Δείτε το API Reference για λεπτομέρειες μορφής XML.
• Πηγές GitHub: Μπορείτε να κάνετε index δημόσια αποθετήρια χωρίς token ή ιδιωτικά αποθετήρια με GitHub personal access token.
• Μάσκες αρχείων: Για πηγές GitHub, μπορείτε να περιορίσετε την ευρετηρίαση σε επιλεγμένες επεκτάσεις όπως md, php, json ή txt.
• Σταδιακές ενημερώσεις: Ενεργοποιήστε το όταν η πηγή σας υποστηρίζει timestamps τροποποίησης και θέλετε ταχύτερη επανευρετηρίαση μόνο των αλλαγμένων στοιχείων.
• Διάσπαση στοιχείων: Αφήστε το ενεργό για τεκμηρίωση και μακροσκελές περιεχόμενο. Απενεργοποιήστε το για καταλόγους ή εγγραφές που πρέπει να παραμένουν ως ένα ευρετηριασμένο στοιχείο.
• Παραδείγματα exporters: Η καρτέλα Knowledge Bases περιλαμβάνει έτοιμα παραδείγματα scripts για WordPress, WooCommerce, OpenCart, WHMCS και γενικές ροές εξαγωγής XML.

5) Ρύθμιση Δρομολόγησης και Αναζήτησης

• Συλλογές: Οργανώστε τη γνώση σας σε συλλογές όπως support, products, billing ή orders.
• Λέξεις-κλειδιά δρομολόγησης: Προσθέστε λέξεις-κλειδιά σε συλλογές ώστε τα σχετικά ερωτήματα να προτεραιοποιούν τη σωστή συλλογή.
• Δρομολόγηση domain: Μπορείτε να ορίσετε μια συλλογή να μην κάνει κάτι ειδικό, να αγνοείται για ένα domain, να γίνεται προτεραιότητα για ένα domain ή να χρησιμοποιείται μόνο όταν το domain της σελίδας ταιριάζει ακριβώς με λέξη-κλειδί.
• Πρόθεση συλλογής: Χρησιμοποιήστε προσεκτικά τους τύπους πρόθεσης. Για παράδειγμα, μια συλλογή order μπορεί να ενεργοποιεί συμπεριφορά prompting σχετική με παραγγελίες πριν από την αναζήτηση παραγγελίας.
• Όριο συνάφειας: Αυξήστε το όριο για αυστηρότερη αντιστοίχιση. Μειώστε το αν θέλετε ευρύτερη ανάκτηση.
• Σειρά προτεραιότητας: Αναδιατάξτε τις συλλογές ώστε οι πιο σημαντικές πηγές να ελέγχονται πρώτες.
• Test Routing: Προσομοιώστε μια πραγματική ερώτηση χρήστη πριν τη δημοσίευση ώστε να επιβεβαιώσετε ότι κερδίζει η σωστή συλλογή.
• Test Search: Εκτελέστε χειροκίνητες αναζητήσεις σε μία συλλογή ή σε όλες για να δείτε ποιο περιεχόμενο είναι πιθανό να ανακτηθεί.

Λογική Πρόθεσης (Πώς Αποφασίζει το Routing)

Πριν από την ανάκτηση γνώσης, το σύστημα εκτελεί μια ελαφριά ταξινόμηση πρόθεσης για κάθε μήνυμα χρήστη. Το αποτέλεσμα είναι μία από τέσσερις ετικέτες:

• human: Ο χρήστης ζητά να μιλήσει με άνθρωπο/εκπρόσωπο/υποστήριξη.
• order: Ο χρήστης ρωτά για τιμολόγια, παραγγελίες, υπόλοιπο ή άλλα προσωπικά οικονομικά στοιχεία λογαριασμού/παραγγελίας.
• eshop: Ο χρήστης ρωτά για προϊόν.
• none: Οποιοδήποτε άλλο γενικό ερώτημα.

Ο ταξινομητής χρησιμοποιεί αυστηρή προτεραιότητα human > order > eshop > none αν μπορούν να ισχύουν πολλαπλές ετικέτες.

• Αν intention = human: η αναζήτηση γνώσης παρακάμπτεται και ενεργοποιείται η ροή κλιμάκωσης υποστήριξης (σύμφωνα με τις ρυθμίσεις κλιμάκωσης στο Widget).
• Αν intention = order ή eshop: το routing δίνει πρώτη προτεραιότητα στις συλλογές με αντίστοιχη πρόθεση. Αν υπάρχουν τέτοιες συλλογές, αναζητούνται πρώτες.
• Αν intention = none: εφαρμόζεται η κανονική δρομολόγηση (λέξεις-κλειδιά, δρομολόγηση domain, προτεραιότητα συλλογών και όρια συνάφειας).
• Για επόμενες στροφές συνομιλίας: η προηγούμενη απάντηση του βοηθού αποθηκεύει εσωτερικές ετικέτες routing, ώστε το πλαίσιο order/eshop να συνεχίζεται φυσικά στο επόμενο μήνυμα.

6) Προσαρμογή Εμπειρίας Επισκέπτη

• Εμφάνιση: Ορίστε θέση widget, προεπιλογή θέματος, ταχύτητα animation πληκτρολόγησης, στρογγυλεμένες γωνίες, χρώματα, λογότυπο κεφαλίδας και εικονίδιο κουμπιού.
• Πολυγλωσσικά κείμενα: Ρυθμίστε τίτλο, placeholder πεδίου εισαγωγής, κείμενο κουμπιού αποστολής, αρχικούς χαιρετισμούς, λεπτομέρειες "σκέψης", επιβεβαίωση επανεκκίνησης, κείμενο κουμπιού νέας συνομιλίας και μήνυμα εκκαθάρισης συνομιλίας για κάθε υποστηριζόμενη γλώσσα.
• Συμπεριφορά αρχικού χαιρετισμού: Μπορείτε να προσθέσετε πολλαπλούς χαιρετισμούς για μία γλώσσα. Το widget επιλέγει έναν τυχαία, ώστε η αρχική εμπειρία να μην φαίνεται επαναλαμβανόμενη.
• Συμπεριφορά χωρίς απάντηση: Προσαρμόστε τι βλέπουν οι χρήστες όταν το bot δεν μπορεί να βρει σχετική γνώση.
• Κλιμάκωση υποστήριξης: Επιλέξτε αν το bot θα ζητά στοιχεία επικοινωνίας και θα στέλνει email στη διεύθυνση υποστήριξής σας ή αν απλώς θα εμφανίζει εναλλακτικό μήνυμα επικοινωνίας.
• Κείμενα συμμόρφωσης: Προσθέστε αποποίηση ευθύνης και προαιρετικό σύνδεσμο πολιτικής απορρήτου για το widget που βλέπει ο επισκέπτης.
• Στοιχεία επιχειρηματικού προφίλ: Μπορείτε να επιτρέψετε στον βοηθό να κοινοποιεί εταιρικά στοιχεία επικοινωνίας ή αναγνωριστικά εταιρείας όταν ο επισκέπτης ρωτά, διατηρώντας παράλληλα μπλοκαρισμένα τα δεδομένα που αφορούν συγκεκριμένους πελάτες.
• Συμπεριφορά γλώσσας: Το widget μπορεί να ανιχνεύει αυτόματα τη γλώσσα του browser του επισκέπτη ή να οριστεί υποχρεωτικά σε συγκεκριμένη γλώσσα στις ρυθμίσεις embed.

7) Δημοσίευση του Widget

• Δημιουργία widget API key: Στην καρτέλα Widget δημιουργήστε το API key και αποθηκεύστε το πριν αντιγράψετε τον κώδικα ενσωμάτωσης.
• Κώδικας ενσωμάτωσης: Αντιγράψτε το παραγόμενο script tag και τοποθετήστε το πριν από το κλείσιμο του </body> στον ιστότοπό σας.
• Σύνδεσμος full-page chat: Αν προτιμάτε, μπορείτε επίσης να χρησιμοποιήσετε το παραγόμενο URL πλήρους σελίδας συνομιλίας αντί για το αιωρούμενο widget.
• Εμφάνιση στο embed: Χρησιμοποιήστε την επιλογή Include Appearance Settings in Widget αν θέλετε το script ενσωμάτωσης να μεταφέρει τα αποθηκευμένα χρώματα και τις οπτικές ρυθμίσεις σας.
• Γλώσσα στο embed: Μπορείτε να επιβάλετε συγκεκριμένη γλώσσα στις ρυθμίσεις embed ή να το αφήσετε σε αυτόματη ανίχνευση.
• Αυτόματο πλαίσιο σελίδας: Ο loader στέλνει το URL της τρέχουσας σελίδας στο σύστημα συνομιλίας. Αυτό βοηθά στη δρομολόγηση και στους ελέγχους επιτρεπόμενου domain.
• Προτεινόμενος έλεγχος δημοσίευσης: Μετά την ενσωμάτωση, ανοίξτε πραγματική σελίδα του ιστότοπού σας, επιβεβαιώστε ότι φορτώνει το widget, ότι εμφανίζεται η σωστή γλώσσα και κάντε 3 έως 5 ρεαλιστικές ερωτήσεις πελατών.

8) Παρακολούθηση, Συντήρηση και Βελτίωση

• Logs: Χρησιμοποιήστε φίλτρα ημερομηνιών και γρήγορα εύρη για να ελέγξετε το ιστορικό συνομιλιών και έπειτα εξάγετε αποτελέσματα σε CSV όταν χρειάζεστε offline ανάλυση.
• Profile: Διατηρείτε ενημερωμένα email, εταιρεία, τηλέφωνο, ΑΦΜ και διεύθυνση και αλλάζετε κωδικό από την καρτέλα Profile όταν χρειάζεται.
• Χρήση: Ελέγχετε τη μηνιαία πρόοδο χρήσης στο Profile ώστε να βλέπετε πόσο κοντά είστε στο όριο απαντήσεων.
• Ροή ευρετηρίασης: Κάντε επανευρετηρίαση μετά από μεγάλες αλλαγές περιεχομένου. Αν είναι ενεργή η αυτόματη ευρετηρίαση, ο προγραμματισμένος συγχρονισμός μπορεί να κρατά τις δυναμικές πηγές ενημερωμένες.
• Βέλτιστη πρακτική για συλλογές: Διαχωρίζετε τις συλλογές ανά επιχειρηματικό σκοπό, όπως products, support, billing ή orders, αντί να τα αναμειγνύετε όλα.
• Βέλτιστη πρακτική για κείμενο πηγής: Κρατήστε το περιεχόμενο καθαρό, απλό και άμεσο. Αφαιρέστε περιττό markup και αποφύγετε να κρύβετε βασικά στοιχεία μέσα σε πολύ μεγάλες παραγράφους.
• Βέλτιστη πρακτική για routing: Ξεκινήστε με μικρό αριθμό καθαρά ονομασμένων συλλογών, δοκιμάστε με πραγματικές ερωτήσεις πελατών και επεκτείνετε κανόνες δρομολόγησης μόνο όταν χρειάζεται.
• Βέλτιστη πρακτική για εμπιστοσύνη επισκεπτών: Γράψτε φιλικά fallback μηνύματα, προσθέστε καθαρή διαδρομή κλιμάκωσης υποστήριξης και διατηρείτε ενημερωμένα την αποποίηση ευθύνης και τον σύνδεσμο πολιτικής απορρήτου.