Open in
Οδηγός στυλ προτροπών
Πώς να γράφετε και να επεξεργάζεστε την προτροπή ενός φωνητικού πράκτορα ThunderPhone: οι έλεγχοι αναθεώρησης προτροπών των κατευθυντήριων γραμμών, με τα αναγνωριστικά που παραπέμπουν στα ευρήματά τους.
Αυτός ο οδηγός απευθύνεται σε οποιονδήποτε γράφει ή επεξεργάζεται την προτροπή ενός φωνητικού πράκτορα: ένα άτομο στο εργαλείο δημιουργίας, το Copilot ή έναν πράκτορα προγραμματισμού που εργάζεται μέσω του API. Το εργαλείο ελέγχου προτροπών τον χρησιμοποιεί ως πλαίσιο αξιολόγησης και παραπέμπει στα αναγνωριστικά των κατευθυντήριων γραμμών του (P1, W2 κ.ο.κ.).
Ένας καλών ακούει τον πράκτορα μία φορά, με ρυθμό ομιλίας, και δεν μπορεί να επιστρέψει προς τα πίσω. Ο πράκτορας διαβάζει την προτροπή σε κάθε εναλλαγή και ακολουθεί πιστά τη διατύπωσή της. Και τα δύο αυτά δεδομένα διαμορφώνουν όλα όσα ακολουθούν.
Δομή
P1. Γράψτε το όπως θα ενημέρωνε ένας άνθρωπος έναν νέο υπάλληλο υποδοχής. Μια σύντομη εισαγωγή αναφέρει ποιος είναι ο πράκτορας και για ποιον εργάζεται. Στη συνέχεια, η κλήση ακολουθεί τη σειρά με την οποία εξελίσσεται: πώς ξεκινά, τι πρέπει να διερευνηθεί, τι πρέπει να επιβεβαιωθεί, πώς ολοκληρώνεται. Κάθε κανόνας βρίσκεται στο σημείο της κλήσης όπου εφαρμόζεται. Ένας αναγνώστης θα πρέπει να μπορεί να αναρωτηθεί για κάθε παράγραφο: «θα μπορούσε ένας άνθρωπος που διαχειρίζεται αυτή την επιχείρηση να το έχει γράψει;» Το τι πρέπει να διερευνηθεί καλύπτει όσα χρειάζεται η επιχείρηση για να διεκπεραιώσει το αίτημα, όχι μόνο ποιος καλεί και πώς μπορεί να επικοινωνήσει μαζί του.
P2. Απλές επικεφαλίδες, κείμενο από κάτω. Επικεφαλίδες όπως «Ποιοι είστε», «Η κλήση», «Στοιχεία» και «Παραπομπή» βοηθούν. Η δομή τύπου μηχανής δεν βοηθά: αριθμημένα εγχειρίδια κανόνων, επικεφαλίδες camelCase ή παρόμοιες με κώδικα, μεγάλες λίστες κανόνων με παύλες, μια αναφορά εργαλείων στην αρχή και παραπομπές όπως «δείτε την παρακάτω ενότητα 4». Οι λίστες είναι κατάλληλες για δεδομένα στα οποία ανατρέχει ο πράκτορας, όπως ωράριο, τιμές ή διεύθυνση.
P3. Τρόπος ομιλίας, μία φορά και σύντομα. Ο τρόπος με τον οποίο μιλά ο πράκτορας σε όλη την κλήση (σύντομες παρεμβάσεις σε πρώτο πρόσωπο, ζεστές, απλές λέξεις· δείτε το S2) περιγράφεται σε μία σύντομη παράγραφο κοντά στην αρχή. Κάθε τι που αφορά συγκεκριμένα ένα βήμα ανήκει σε εκείνο το βήμα.
P4. Τα στοιχεία χωριστά από τη συμπεριφορά. Το ωράριο, οι τιμές, οι τοποθεσίες, οι πολιτικές και άλλα στοιχεία τοποθετούνται σε ένα μέρος με στοιχεία της προτροπής ή σε μια βάση γνώσεων, όχι διάσπαρτα στη ροή της κλήσης. Οι μεγάλοι κατάλογοι και οι συχνές ερωτήσεις ανήκουν σε μια βάση γνώσεων. Ο πράκτορας μπορεί να αναφέρει μόνο στοιχεία που του έχουν δοθεί.
Περιεχόμενο
C1. Αρχές και δεδομένα, όχι σενάρια. Περιγράψτε τι προσπαθεί να επιτύχει ο πράκτορας και τι χρειάζεται να γνωρίζει. Παραλείψτε κλάδους όπως «αν ο καλών πει X, πείτε Y», προγραμματισμένες απαντήσεις σε αναμενόμενες ερωτήσεις και τυποποιημένες φράσεις. Ο ρυθμισμένος αρχικός χαιρετισμός είναι το μοναδικό προγραμματισμένο στοιχείο.
C2. Μια διόρθωση δηλώνει τη γενική αρχή. Όταν μια αλλαγή στην προτροπή ανταποκρίνεται σε μια παρατηρημένη αποτυχία, η αλλαγή προσθέτει μια γενική αρχή ή ένα δεδομένο που λείπει, όχι μια επιδιόρθωση για εκείνη τη μοναδική περίπτωση. Οι λεπτομέρειες της κλήσης που απέτυχε (τα ονόματά της, οι αριθμοί της, οι ακριβείς λέξεις της) δεν περιλαμβάνονται στην προτροπή.
C3. Προτιμήστε την αφαίρεση αντί για την προσθήκη. Όταν μια αποτυχία οφείλεται σε έναν υπάρχοντα κανόνα που είναι υπερβολικά συγκεκριμένος, υπερβολικά γενικός ή τοποθετημένος λανθασμένα, αλλάξτε ή αφαιρέστε αυτόν τον κανόνα αντί να προσθέσετε δίπλα του έναν αντίθετο κανόνα.
C4. Ορισμένα πράγματα τα αποφασίζουν οι ρυθμίσεις, όχι η προτροπή. Αυτές είναι ρυθμίσεις του πράκτορα και το κείμενο της προτροπής σχετικά με αυτές αγνοείται ή έρχεται σε σύγκρουση μαζί τους: τι λέγεται ενώ εκτελείται ένα εργαλείο (γραμμή έναρξης εργαλείου, φράσεις συμπλήρωσης), έλεγχοι σιωπής και η τελική ενέργεια μετά από σιωπή, ο ρυθμός με τον οποίο επαναλαμβάνονται στοιχεία, το ύφος εναλλαγής γλώσσας, η ειδοποίηση εγγραφής και το αν μιλά πρώτος ο πράκτορας ή ο καλών. Κατευθύνετε την προτροπή προς το αποτέλεσμα αντί («επιβεβαιώστε τη διεύθυνση email πριν την αποθηκεύσετε») και ορίστε τη ρύθμιση. Ο ίδιος ο αρχικός χαιρετισμός γράφεται στην προτροπή.
C5. Τα παραδείγματα είναι φράσεις που θα πει ο πράκτορας. Ο πράκτορας αντιγράφει τη διατύπωση των παραδειγμάτων σχεδόν λέξη προς λέξη, επομένως κάθε παράδειγμα είναι μια πλήρης, φυσική προφορική πρόταση και λίγα διαφορετικά παραδείγματα είναι καλύτερα από ένα. Παρουσιάστε τα ως παραδείγματα («Για παράδειγμα, μπορείτε να πείτε ...»), όχι ως την απαιτούμενη φράση. Σύντομες ετικέτες όπως «Εξακολουθεί να είναι σωστό;» ακούγονται απότομες όταν εκφωνούνται.
C6. Όχι παραδείγματα από κλήσεις των δικών μας πελατών. Τα παραδείγματα περιγράφουν το είδος της κατάστασης με γενικούς όρους ή χρησιμοποιούν μια επινοημένη επιχείρηση.
C7. Η οδηγία απευθύνεται στους καλούντες, όχι στην υλοποίηση. Οι καλούντες ακούν ό,τι αναφέρει η οδηγία μόλις τεθεί σε λειτουργία, επομένως δεν περιλαμβάνει σημειώσεις σχετικά με την ανάπτυξη, τις δοκιμές ή την κατάσταση συμμόρφωσης («αυτή η έκδοση προορίζεται για δοκιμές», «TEST» στο όνομα μιας κράτησης, «μέχρι να υπογραφούν οι συμφωνίες»). Επίσης, δεν περιλαμβάνει αποποιήσεις ευθύνης, επιφυλάξεις νομικής ευθύνης και τελικές ανακεφαλαιώσεις που δεν ζήτησε η επιχείρηση, όπως τι δεν τεκμηριώνει η αποδοχή ενός προγράμματος ή μια σύνοψη όσων παραμένουν ανεπιβεβαίωτα. Ο πράκτορας απαντά σε ό,τι ζήτησε ο καλών και σταματά· η επιχείρηση προσθέτει μια επιφύλαξη όταν το επιθυμεί. Ένα στοιχείο που λείπει ή ένας περιορισμός του συστήματος διατυπώνεται ως ενέργεια του πράκτορα («για τις τιμές, προσφέρετε επανάκληση από το γραφείο»), όχι ως σημείωση ότι δεν παρασχέθηκε ή σχετικά με τον τρόπο καταγραφής των αιτημάτων, και δεν μένει τίποτα από τη σύνταξη, όπως ένα άσχετο όνομα ή μια επικεφαλίδα.
Διατύπωση
W1. Πείτε τι πρέπει να γίνει, απλά, μία φορά. Διατυπώστε την επιθυμητή συμπεριφορά ως οδηγία με συνηθισμένες λέξεις: «Επαναλάβετε τον αριθμό παραγγελίας ψηφίο προς ψηφίο, ώστε ο καλών να μπορεί να τον διορθώσει». Πείτε το μία φορά, εκεί όπου εφαρμόζεται.
W2. Χωρίς έμφαση. Χωρίς ετικέτες ΣΗΜΑΝΤΙΚΟ, ΣΗΜΕΙΩΣΗ ή ΚΡΙΣΙΜΟ, χωρίς λέξεις με κεφαλαία για έμφαση, χωρίς θαυμαστικά, χωρίς ζεύγη «Κακό:» και «Καλό:», χωρίς ενότητες με όσα δεν πρέπει να γίνουν. Λέξεις όπως «ποτέ», «πάντα» και «πρέπει», όταν χρησιμοποιούνται για έμφαση, ανήκουν επίσης εδώ. Η έμφαση τραβά την προσοχή του μοντέλου σε έναν κανόνα και το κάνει χειρότερο στο υπόλοιπο μέρος της κλήσης. Όταν ο πράκτορας αγνοεί μια οδηγία, κάντε την οδηγία σαφέστερη, πιο συγκεκριμένη ή καλύτερα τοποθετημένη, όχι πιο έντονη.
W3. Διορθώστε τη δομή που προκαλεί μια συμπεριφορά. Πριν προσθέσετε έναν κανόνα ενάντια σε κάτι που κάνει ο πράκτορας, βρείτε τη διατύπωση ή τη δομή που τον οδηγεί εκεί: ένα πρότυπο που το μοντέλο συμπληρώνει κυριολεκτικά, έναν όρο που σημαίνει δύο πράγματα, έναν κλάδο αν-αλλιώς που ένα γρήγορο μοντέλο διαβάζει χαλαρά. Αλλάξτε αυτό.
W4. Το συγκεκριμένο υπερισχύει του γενικού. Το «Προσφέρετε τις δύο νωρίτερες διαθέσιμες ώρες και έπειτα ρωτήστε ποια εξυπηρετεί» είναι καλύτερο από το «βοηθήστε με τον προγραμματισμό». Οι ασαφείς οδηγίες οδηγούν σε ασαφή συμπεριφορά.
W5. Αναζητήστε το πριν ρωτήσετε γι’ αυτό. Όταν ο καλών αναφέρει κάτι που μπορεί να ελέγξει ένα εργαλείο αναζήτησης μόνο για ανάγνωση (ένα προϊόν, μια παραγγελία, μια υπάρχουσα κράτηση), ο πράκτορας ελέγχει με τις λέξεις που έδωσε ο καλών και έπειτα κάνει συμπληρωματική ερώτηση μόνο αν το αποτέλεσμα το απαιτεί. Το «Ελέγξτε το απόθεμα για το προϊόν που αναφέρει ο καλών και πείτε του τι βρίσκετε» υπερέχει του «διευκρινίστε τη μάρκα, το μέγεθος και την παραλλαγή και έπειτα ελέγξτε το απόθεμα»: ένας πράκτορας στον οποίο λέγεται να διευκρινίσει πρώτα συνεχίζει να ρωτά και ο έλεγχος δεν εκτελείται ποτέ. Αυτό ισχύει μόνο για αναζητήσεις. Πριν από ένα εργαλείο που πραγματοποιεί κρατήσεις, τροποποιεί, ακυρώνει ή αποθηκεύει κάτι, ο πράκτορας εξακολουθεί να επιβεβαιώνει τις λεπτομέρειες με τον καλούντα.
Ομιλία
S1. Μία ερώτηση ανά σειρά, και η ερώτηση ολοκληρώνει τη σειρά. Οτιδήποτε λέγεται μετά από μια ερώτηση επικαλύπτει την απάντηση του καλούντος. Τοποθετήστε κάθε εξήγηση πριν από την ερώτηση.
S2. Σύντομες απαντήσεις, με πλήρεις προφορικές προτάσεις. Μία ή δύο σύντομες προτάσεις, εκτός αν ο καλών ζητήσει λεπτομέρειες. Οι προφορικές επιλογές περιορίζονται σε λίγες. Σύντομες σημαίνει με λίγες λέξεις, όχι κοφτές: ο πράκτορας μιλά όπως μια καλή ρεσεψιονίστ στο τηλέφωνο, με ολοκληρωμένες προτάσεις σε πρώτο πρόσωπο, όπως «Θα το κλείσω τώρα για εσάς» ή «Σας έχω καταχωρίσει για τη Δευτέρα στις δέκα». Αποσπάσματα ύφους σημειώσεων («Κράτηση για εσάς.», «Έγινε.», «Καταγράφηκε.») ακούγονται απότομα όταν εκφωνούνται, ενώ η διατύπωση ηλεκτρονικού μηνύματος («Παρακαλούμε σημειώστε ότι ...», «Παρακαλούμε ...», «Ελπίζω να βοηθά αυτό») ακούγεται σαν να διαβάζεται αντί να λέγεται. Η παράγραφος του prompt για τον τρόπο ομιλίας το ζητά ξεκάθαρα, για παράδειγμα: «Κρατήστε κάθε απάντηση σε μία ή δύο προτάσεις και μιλήστε σε πρώτο πρόσωπο, όπως θα μιλούσε μια ρεσεψιονίστ στο τηλέφωνο.»
S3. Γράψτε για το αυτί. Σε όσα λέει ο πράκτορας, αποφύγετε τη σήμανση, τα σύμβολα και τη σημειογραφία που η φωνή θα διαβάσει παράξενα (κάθετες, εμπορικά και, "@", ".com", διαχωριστικά χιλιάδων, αριθμούς τηλεφώνου χωρίς κενά). Τα δεδομένα και οι τιμές που ο πράκτορας μεταβιβάζει σε ένα εργαλείο, όπως μια διεύθυνση email ή ένας αριθμός λογαριασμού, παραμένουν στην ακριβή γραπτή μορφή τους· όταν κάποιο από αυτά πρέπει επίσης να εκφωνηθεί, προσθέστε δίπλα του τον τρόπο με τον οποίο λέγεται αντί να το ξαναγράψετε. Γράψτε συλλαβιστά τον τρόπο προφοράς ασυνήθιστων ονομάτων ή ακρωνυμίων, και ακούστε νέους όρους με τη φωνή του πράκτορα πριν τους διατηρήσετε.
S4. Επιβεβαιώστε όσα θα ήταν δαπανηρό να καταγραφούν λανθασμένα. Αριθμοί, διευθύνσεις ηλεκτρονικού ταχυδρομείου, διευθύνσεις και κωδικοί επαναλαμβάνονται στη μορφή με την οποία δόθηκαν, μία φορά, στην απάντηση αμέσως αφού ο καλών τα δώσει και πριν από την επόμενη ερώτηση, μία τιμή ανά επανάληψη. Από προεπιλογή, ένα όνομα γίνεται δεκτό όπως ειπώθηκε, χωρίς επανάληψη, και ο πράκτορας ζητά την ορθογραφία του μόνο όταν είναι ασυνήθιστο ή ασαφές, και τη ζητά μία φορά. Όταν η επιχείρηση χρειάζεται το όνομα ακριβές, όπως για αντιστοίχιση με τα αρχεία της ή για κράτηση με αυτό το όνομα, το prompt το αναφέρει και ο πράκτορας επαναλαμβάνει την ορθογραφία του ονόματος. Μια επανάληψη δίνει στον καλούντα τη δυνατότητα να διορθώσει μια τιμή, δεν αποτελεί εμπόδιο: ένας καλών που απαντά με την επόμενη λεπτομέρεια ή συνεχίζει χωρίς να τη διορθώσει την έχει αποδεχτεί, και μια αποδεκτή τιμή δεν ζητείται ξανά. Εξαίρεση αποτελεί ένας αριθμός τηλεφώνου στον οποίο η επιχείρηση θα καλέσει ή θα στείλει μήνυμα: η επανάληψή του ολοκληρώνει την απάντηση και περιμένει την απάντηση του καλούντος. Ένα prompt που ζητά ανάγνωση ψηφίο προς ψηφίο αναφέρει μόνο τις τιμές που διαβάζονται με αυτόν τον τρόπο (έναν αριθμό τηλεφώνου, έναν κωδικό)· ένας αριθμός σπιτιού, μια τιμή, μια ώρα ή μια ημερομηνία λέγεται όπως τα λένε οι άνθρωποι. Το prompt ορίζει τι πρέπει να επιβεβαιώνεται· η πλατφόρμα ρυθμίζει τον ρυθμό της επανάληψης.
Επαναλήψεις
I1. Δοκιμάζετε πριν διατηρήσετε μια αλλαγή. Επαναλάβετε το σύνολο ανάπτυξης του πράκτορα στο επεξεργασμένο προσχέδιο και συγκρίνετέ το με την τρέχουσα έκδοση: ποια παραδείγματα διόρθωσε μια αλλαγή και ποια χάλασε. Διαβάστε τις απαντήσεις όπως θα τις άκουγε ένας καλών. Οτιδήποτε θα πρόσεχε ένας καλών είναι πρόβλημα, όχι λεπτομέρεια.
I2. Το σύνολο hold-out ελέγχεται μία φορά. Προσαρμόζετε μόνο στο σύνολο ανάπτυξης. Εκτελέστε το σύνολο δοκιμών όταν μια αλλαγή είναι έτοιμη και αναφέρετε το αποτέλεσμά του όπως είναι. Μια αλλαγή που γίνεται αφού δείτε αποτελέσματα δοκιμών χρειάζεται νέα παραδείγματα δοκιμών.
I3. Αναδιαρθρώνετε όταν συσσωρεύονται επιδιορθώσεις. Ένα prompt που έχει συγκεντρώσει πολλές μικρές διορθώσεις αποκλίνει από το P1: οι κανόνες επαναλαμβάνονται, συγκρούονται ή βρίσκονται μακριά από το βήμα που διέπουν. Τότε ξαναγράψτε το σε αυτή τη μορφή, διατηρώντας κάθε συμπεριφορά που ζητά. Καταγράψτε κάθε συμπεριφορά ως διατηρημένη, συγχωνευμένη, αναδιατυπωμένη ή αφαιρεμένη και μην αφαιρείτε τίποτα σιωπηλά. Επαναλάβετε το σύνολο ανάπτυξης πριν και μετά· μια αναδιάρθρωση πρέπει να αλλάζει τη διατύπωση, όχι τη συμπεριφορά.
I4. Ελέγξτε τη διαμόρφωση πριν από την προτροπή. Ορισμένες αποτυχίες δεν οφείλονται στην προτροπή: η λανθασμένη ακρόαση συλλαβισμένων γραμμάτων είναι περιορισμός ακρόασης (δοκιμάστε ακρόαση Plus), μια αργή απάντηση μπορεί να οφείλεται στη βαθμίδα νοημοσύνης ή ακρόασης ή στη ρύθμιση τερματισμού ομιλίας. Αποκλείστε ζητήματα διαμόρφωσης πριν ξαναγράψετε το κείμενο.