Open in
Ενσωματωμένα εργαλεία
Δώστε οδηγίες στους πράκτορες ThunderPhone να τερματίζουν κλήσεις, να μεταφέρουν καλούντες, να πλοηγούνται σε πληκτρολόγια, να περιμένουν σε αναμονή, να αναζητούν γνώσεις, να αναπαράγουν ήχους, να στέλνουν email και να υπολογίζουν σύνολα.
Τα ενσωματωμένα εργαλεία επιτρέπουν σε έναν πράκτορα να εκτελεί συνήθεις ενέργειες κλήσης χωρίς να συνδέσετε το δικό σας API. Τα περισσότερα είναι διαθέσιμα αυτόματα· το email, οι ήχοι, η αριθμομηχανή και η αναζήτηση γνώσης εμφανίζονται μόνο αφού διαμορφώσετε τη σχετική ρύθμιση ή πηγή. Πείτε στον πράκτορα πότε να χρησιμοποιεί κάθε ενέργεια στην προτροπή του.
| Εργαλείο | Χρήση για | Τρόπος ενεργοποίησης | Υποστηριζόμενες κλήσεις |
|---|---|---|---|
end_call | Ολοκλήρωση μιας περατωμένης συνομιλίας | Ενεργοποιημένο από προεπιλογή· το system_tool_settings μπορεί να το απενεργοποιήσει | Τηλέφωνο, Μιλήστε στο πρόγραμμα περιήγησης, widget, προσομοίωση και Realtime |
transfer_call | Δρομολόγηση ενός τηλεφωνικού καλούντος | Ρυθμίστε τη δρομολόγηση στο prompt | Συνήθεις τηλεφωνικές κλήσεις· το ενσωματωμένο Realtime με call_events μπορεί να χρησιμοποιεί ψυχρή μεταφορά. Το Realtime αποθηκευμένου πράκτορα το παραλείπει. |
send_keypad_input | Πάτημα πλήκτρων σε τηλεφωνικό μενού | Ενεργοποιημένο από προεπιλογή για εξερχόμενες κλήσεις· το system_tool_settings μπορεί να το ενεργοποιήσει ή να το απενεργοποιήσει | Τηλεφωνικές κλήσεις· ενσωματωμένο εξερχόμενο Realtime με call_events. Το Realtime αποθηκευμένου πράκτορα το παραλείπει. |
no_response | Συνέχιση ακρόασης ενώ μιλά ένα αυτοματοποιημένο μενού ή ένας καλών σκέφτεται φωναχτά· ένας καλών που ζητά από τον πράκτορα να περιμένει λαμβάνει μόνο «Βεβαίως.» | Πάντα διαθέσιμο | Όλοι οι τύποι κλήσεων |
wait_on_hold | Σιωπηλή αναμονή μέχρι να επιστρέψει ένα άτομο | Ενεργοποιημένο από προεπιλογή για εξερχόμενες κλήσεις· το system_tool_settings μπορεί να το ενεργοποιήσει ή να το απενεργοποιήσει | Τηλεφωνικές κλήσεις και εξερχόμενες ενσωματωμένες συνεδρίες Realtime |
search_knowledge_base | Απάντηση από συνημμένες πηγές | Επισυνάψτε γνώση στον πράκτορα | Κλήσεις αποθηκευμένου πράκτορα με συνημμένη γνώση |
play_sound | Αναπαραγωγή ενός ρυθμισμένου ήχου ειδοποίησης | Για προχωρημένους → Ήχος εργαλείου | Κλήσεις αποθηκευμένου πράκτορα |
send_email | Αποστολή email σε έναν σταθερό παραλήπτη | Για προχωρημένους → Αποστολή email | Κλήσεις αποθηκευμένου πράκτορα |
calculate | Ακριβής υπολογισμός συνόλων, χρεώσεων και ρέστων | Για προχωρημένους → Αριθμομηχανή | Κλήσεις αποθηκευμένου πράκτορα |
end_call
Τερματίζει την τρέχουσα κλήση όταν η προτροπή υποδεικνύει στο μοντέλο να το κάνει. Είναι ενεργοποιημένο από προεπιλογή. Ένας πράκτορας που δεν πρέπει ποτέ να τερματίζει μια κλήση από μόνος του, όπως ένας διερμηνέας που μεταφέρει τη συνομιλία μεταξύ δύο ατόμων τα οποία τερματίζουν οι ίδιοι την κλήση, μπορεί να το απενεργοποιήσει με το πεδίο system_tool_settings του πράκτορα ({"end_call": false}). Η κλήση τότε τερματίζεται όταν κάποιο άτομο κλείσει το τηλέφωνο ή μέσω των ορίων σιωπής και χρόνου.
Γράψτε στην προτροπή τη συνθήκη και τυχόν απαιτούμενο αποχαιρετισμό:
When the caller confirms they need nothing else, say goodbye and end the call.Μια κλήση που τερματίζεται από το μοντέλο έχει end_reason: "ai_hangup", συμπεριλαμβανομένης μιας κλήσης που τερματίζεται
μετά την προειδοποίηση ορίου διάρκειας κλήσης. Η κλήση τερματίζεται με max_duration μόνο εάν
το όριο διάρκειας επιτευχθεί πρώτο, με balance_exhausted όταν εξαντληθεί το προπληρωμένο
υπόλοιπο και με price_cap_reached όταν η κλήση φτάσει το αυστηρό ανώτατο όριο τιμής του πράκτορα
(ο πράκτορας λέει πρώτα ένα σύντομο αντίο).
transfer_call
Μεταφέρει έναν τηλεφωνικό καλούντα σε έναν σταθερό αριθμό που παρέχει το μοντέλο. Η άμεση μεταφορά γίνεται αμέσως. Μια ελεγχόμενη θερμή μεταφορά καλεί ιδιωτικά τον προορισμό πριν συνδέσει τα μέρη. Η θερμή μεταφορά απαιτεί έναν επαληθευμένο εισαγόμενο αριθμό VoIP που μπορεί να πραγματοποιεί εξερχόμενες κλήσεις.
Τοποθετήστε τον αριθμό προορισμού και την ακριβή συνθήκη δρομολόγησης στην προτροπή:
If the caller asks for billing, transfer them to +15551234567.Μια επιτυχημένη άμεση μεταφορά έχει end_reason: "ai_transfer"· μια ολοκληρωμένη θερμή παράδοση έχει end_reason: "ai_warm_transfer". Μια αποτυχημένη θερμή προσπάθεια επιστρέφει τον έλεγχο στον πράκτορα, επομένως ο μεταγενέστερος τερματισμός της κλήσης καθορίζει τον λόγο τερματισμού της. Σε συνεδρίες που δεν είναι τηλεφωνικές, ένα αίτημα μεταφοράς τερματίζει τη συνεδρία.
Δείτε Μεταφορά κλήσεων για ρύθμιση πίνακα ελέγχου και API, δρομολόγηση, έλεγχο, χειρισμό αποτυχιών, όρια και δοκιμές.
send_keypad_input
Στέλνει ψηφία DTMF (τηλεφωνικού πληκτρολογίου) 0–9, * και # σε μια τηλεφωνική γραμμή. Το μοντέλο το χρησιμοποιεί για να πλοηγείται σε ένα IVR, το αυτοματοποιημένο μενού που ζητά από τους καλούντες να πατήσουν πλήκτρα. Είναι ενεργοποιημένο από προεπιλογή για εξερχόμενες κλήσεις και απενεργοποιημένο για εισερχόμενες κλήσεις· ορίστε "send_keypad_input": true ή false στις system_tool_settings του πράκτορα για να το αλλάξετε για κάθε κλήση.
Πείτε στο μοντέλο σε ποια μενού μπορεί να πλοηγείται και από πού προέρχονται οι ζητούμενες τιμές. Μην του ζητάτε να μαντεύει επιλογές μενού:
Follow the phone menu for account status. Press a key only after the menu
states what that key does. Enter the account number supplied by the caller.Η πλατφόρμα αφαιρεί μη υποστηριζόμενους χαρακτήρες και στέλνει έγκυρα ψηφία με τη σειρά. Αν δεν απομείνουν έγκυρα ψηφία ή η κλήση δεν μπορεί να στείλει είσοδο πληκτρολογίου, η αποτυχία επιστρέφεται στον πράκτορα ώστε να μπορεί να ανακάμψει.
no_response
Διατηρεί τον πράκτορα σιωπηλό ενώ ένα αυτοματοποιημένο σύστημα εξακολουθεί να μιλά ή του ζητά να συνεχίσει να ακούει, καθώς και όταν ένας καλών σκέφτεται φωναχτά («εεε, για να δω») ή στρέφεται για να μιλήσει σε κάποιον άλλο. Όταν ένας καλών ζητά από τον πράκτορα να περιμένει ενώ κάνει κάτι («ένα δευτερόλεπτο», «να το ελέγξω», «μπορείτε να περιμένετε ένα δευτερόλεπτο;») και δεν του δίνει κάτι άλλο για να απαντήσει, ο πράκτορας λέει μόνο «Βεβαίως.» (όχι «Πάρτε τον χρόνο σας») και περιμένει τον καλούντα να μιλήσει ξανά. Οι παρεμβάσεις ελέγχου σιωπής του πράκτορα εξακολουθούν να εκτελούνται και εκφωνούνται πάντα, αν η γραμμή παραμένει σιωπηλή. Δεν προορίζεται για χαιρετισμό από ζωντανό άτομο, για ερώτηση ή για πραγματική ουρά αναμονής. Είναι διαθέσιμη από προεπιλογή και δεν διαθέτει ρύθμιση πράκτορα.
Αν το prompt σας λέει στον πράκτορα τι να πει όταν ένας καλών ζητά λίγο χρόνο, το prompt υπερισχύει.
Συνήθως αρκεί η ενσωματωμένη περιγραφή. Για κλήσεις με εκτεταμένη χρήση IVR, ενισχύστε το όριο στην προτροπή:
Stay silent while a phone menu is still speaking. Answer a live person as soon
as they address you.Αυτή η ενέργεια δεν τερματίζει την κλήση.
wait_on_hold
Θέτει έναν εξερχόμενο πράκτορα σε κατάσταση σιωπηρής αναμονής έως ότου επιστρέψει ένα άτομο.
Το μοντέλο το χρησιμοποιεί μόνο αφού το άλλο μέρος δηλώσει ρητά ότι ο πράκτορας τίθεται
σε αναμονή. Είναι ενεργοποιημένο από προεπιλογή για εξερχόμενες κλήσεις· ορίστε το "wait_on_hold" στις system_tool_settings του πράκτορα για να το ενεργοποιήσετε ή να το απενεργοποιήσετε για κάθε κλήση.
If a person explicitly puts you on hold, wait silently. When they return,
continue from the question you were discussing.Μην προτρέπετε τον πράκτορα να το χρησιμοποιεί για το μήνυμα «παρακαλώ περιμένετε» ενός IVR. Η αναμονή διαρκεί
έως 15 λεπτά από προεπιλογή. Για συνήθεις εξερχόμενες κλήσεις, το POST /v1/call
δέχεται ένα θετικό ακέραιο max_hold_seconds; το ενσωματωμένο Realtime περιορίζει το
max_hold_seconds σε 10–900 δευτερόλεπτα. Αν το άτομο
επιστρέψει, ο πράκτορας συνεχίζει χωρίς να αλλάξει η αιτία τερματισμού της κλήσης. Αν το όριο
λήξει, η πλατφόρμα τερματίζει την κλήση με end_reason: "ai_hangup".
search_knowledge_base
Αναζητά έγγραφα που είναι συνδεδεμένα με τον πράκτορα και επιστρέφει σχετικά αποσπάσματα. Συνδέστε μια βάση γνώσεων ή μεμονωμένα έγγραφα γνώσεων για να το ενεργοποιήσετε και, στη συνέχεια, υποδείξτε στο μοντέλο ποιες απαντήσεις πρέπει να προέρχονται από αυτές τις πηγές:
Search the knowledge base before answering policy questions. If the first
search is inconclusive, try once more with different key terms.Αν μια αναζήτηση αποτύχει, το αποτέλεσμα επιστρέφεται στον πράκτορα. Ανατρέξτε στη Βάση γνώσεων για ρύθμιση στον πίνακα ελέγχου και μέσω API.
play_sound
Αναπαράγει τον διαμορφωμένο ήχο ειδοποίησης του πράκτορα μετά από οποιαδήποτε ομιλία στον ίδιο γύρο. Στον πίνακα ελέγχου, ορίστε Για προχωρημένους → Ήχος εργαλείου σε Κουδουνάκι, Ντινγκ, ή Μπιπ και, στη συνέχεια, αναπτύξτε τον πράκτορα. Η επιλογή Κανένα καταργεί το εργαλείο.
Με το Agents API, ορίστε προσωρινά το play_sound_asset ως
"chime", "ding" ή "beep" και, στη συνέχεια, αναπτύξτε. Ορίστε το σε "" για να απενεργοποιήσετε
το εργαλείο.
After confirming that an appointment was saved, say "You're all set" and play
the notification sound.Μια αποτυχία αναπαραγωγής επιστρέφεται στον πράκτορα και δεν τερματίζει την κλήση.
send_email
Στέλνει ένα email απλού κειμένου στον έναν παραλήπτη που έχει διαμορφώσει ο κάτοχος του πράκτορα. Το μοντέλο παρέχει το θέμα και το σώμα. Δεν βλέπει ποτέ παράμετρο παραλήπτη και δεν μπορεί να επιλέξει ή να αλλάξει τη διεύθυνση.
Στον πίνακα ελέγχου, ενεργοποιήστε Για προχωρημένους → Αποστολή email, αποθηκεύστε μια διεύθυνση παραλήπτη
και, στη συνέχεια, αναπτύξτε τον πράκτορα. Με το Agents API, ορίστε προσωρινά και τα δύο
send_email_enabled: true και ένα μη κενό send_email_recipient και, στη συνέχεια, αναπτύξτε.
Ορίστε το έναυσμα και το απαιτούμενο περιεχόμενο στην προτροπή:
When the caller asks to leave a message, collect their name, callback number,
and message. Read the details back for confirmation, then email them.Μια κλήση μπορεί να επιχειρήσει έως τρία email. Κάθε θέμα περιορίζεται σε 300 χαρακτήρες και κάθε σώμα σε 20.000 χαρακτήρες. Ελλιπής διαμόρφωση, μη έγκυρο περιεχόμενο, το όριο ανά κλήση και αποτυχίες παράδοσης επιστρέφονται στον πράκτορα. Μια αποτυχημένη παράδοση εξακολουθεί να χρησιμοποιεί μία από τις τρεις προσπάθειες.
Δοκιμάστε με ελεγχόμενο παραλήπτη πριν από ευρεία ανάπτυξη. Η λειτουργία «Μιλήστε» στο πρόγραμμα περιήγησης και οι προσομοιώσεις στέλνουν πραγματικά email· δεν υπάρχει λειτουργία δοκιμαστικής εκτέλεσης.
calculate
Αξιολογεί με ακρίβεια μια αριθμητική έκφραση και επιστρέφει το αποτέλεσμα, ώστε ο πράκτορας
να μη κάνει νοερά την πρόσθεση των τιμών. Είναι απενεργοποιημένο από προεπιλογή. Στον πίνακα ελέγχου,
ενεργοποιήστε Για προχωρημένους → Αριθμομηχανή και, στη συνέχεια, αναπτύξτε τον πράκτορα. Με το API
πρακτόρων, ορίστε στο στάδιο calculator_enabled: true και, στη συνέχεια, αναπτύξτε.
Το μοντέλο γράφει την έκφραση, όπως 2*23.5 + 16.5 + 4, και διαβάζει το
αποτέλεσμα στον καλούντα. Οι εκφράσεις μπορούν να χρησιμοποιούν αριθμούς, +, -, *, / και
παρενθέσεις. Μία κλήση μπορεί να περιλαμβάνει έως 10 εκφράσεις διαχωρισμένες με ;, όπως
ένα μερικό σύνολο και το σύνολο με χρέωση παράδοσης, έως 500 χαρακτήρες συνολικά.
Τα αποτελέσματα στρογγυλοποιούνται σε 10 δεκαδικά ψηφία. Τα μαθηματικά χρησιμοποιούν ακριβή δεκαδική αριθμητική, επομένως
το 0.1 + 0.2 επιστρέφει 0.3. Η διαίρεση με το μηδέν και οτιδήποτε άλλο στην έκφραση
επιστρέφουν στον πράκτορα ως σφάλμα για διόρθωση. Εκτελείται στο ThunderPhone και
απαντά αμέσως, χωρίς φράση αναμονής ή ήχο πληκτρολόγησης.
Ενεργοποιήστε το για πράκτορες που αναφέρουν σύνολα παραγγελιών, χρεώσεις ή ρέστα. Δεν απαιτείται αλλαγή στο prompt.
Σημείωση συμβατότητας
Η ρύθμιση Για προχωρημένους → Μη διακόψιμες γνωστοποιήσεις και το παλαιό
πεδίο speak_uninterruptible_enabled παραμένουν για συμβατότητα, αλλά η ενεργοποίησή
τους δεν έχει αποτέλεσμα. Αφήστε τη ρύθμιση απενεργοποιημένη· καμία προτροπή δεν μπορεί να ενεργοποιήσει αυτό το εργαλείο.
Για υποχρεωτική γνωστοποίηση στην αρχή της κλήσης, χρησιμοποιήστε την Ανακοίνωση συναίνεσης. Αναπαράγεται αυτολεξεί πριν από τη συνήθη συνομιλία και δεν μπορεί να διακοπεί. Ανατρέξτε στους Νόμους συναίνεσης για την καταγραφή κλήσεων.
Δοκιμή και παρακολούθηση ενσωματωμένων εργαλείων
Χρησιμοποιήστε τη λειτουργία «Μιλήστε» στο πρόγραμμα περιήγησης ή μια προσομοίωση για να ελέγξετε προτροπές, αναζήτηση γνώσεων, ήχους και email. Αυτά τα περιβάλλοντα δεν μπορούν να αναπαραγάγουν τη συμπεριφορά του τηλεφωνικού δικτύου. Δοκιμάστε την πλοήγηση με πληκτρολόγιο και την αναμονή σε μια εξερχόμενη τηλεφωνική κλήση και δοκιμάστε μια πλήρη θερμή μεταβίβαση σε πραγματική κλήση χρησιμοποιώντας έναν επιλέξιμο εισαγόμενο αριθμό VoIP. Η υποστήριξη Realtime είναι περιορισμένη, όπως εμφανίζεται στον παραπάνω πίνακα.
Κλήσεις, τιμολόγηση και webhook
Οι ενσωματωμένες ενέργειες δεν έχουν χρέωση εργαλείου ανά χρήση. Εξακολουθούν
να ισχύουν οι κανονικές χρεώσεις κλήσεων και παρόχου· δείτε την Τιμολόγηση. Οι κλήσεις και τα αποτελέσματά τους μπορεί
να εμφανίζονται στην ολοκληρωμένη απομαγνητοφώνηση, αλλά δεν εκπέμπουν telephony.tool ή web.tool.
Αυτά τα συμβάντα προορίζονται για συναρτήσεις που ορίζονται από τον χρήστη. Μόνο ένας ολοκληρωμένος
τερματισμός ή μια ολοκληρωμένη προώθηση αλλάζει το end_reason της κλήσης· οι υπόλοιπες αποτυχίες επιστρέφονται
στον πράκτορα. Δείτε τα Webhook ολοκλήρωσης κλήσης για την εγγραφή
της κλήσης.