Open in
Χρησιμοποιήστε το ThunderPhone ως διακομιστή MCP
Δημιουργήστε, δοκιμάστε, επικυρώστε και διαχειριστείτε φωνητικούς πράκτορες ThunderPhone από το Claude, το ChatGPT, το Claude Code, το Codex, το Cursor, το VS Code ή άλλο πρόγραμμα-πελάτη Streamable HTTP MCP.
Το ThunderPhone παρέχει έναν διακομιστή Streamable HTTP του Model Context Protocol στη διεύθυνση:
https://api.thunderphone.com/v1/mcpΑυτή είναι η αντίθετη κατεύθυνση από τη σύνδεση ενός απομακρυσμένου διακομιστή MCP σε έναν φωνητικό πράκτορα:
| Κατεύθυνση | Αποτέλεσμα |
|---|---|
| Απομακρυσμένος διακομιστής MCP → πράκτορας ThunderPhone | Ένας φωνητικός πράκτορας μπορεί να καλεί τα εργαλεία του απομακρυσμένου διακομιστή. |
| ThunderPhone → ο πελάτης MCP σας | Ο πράκτορας προγραμματισμού σας μπορεί να δημιουργεί, να δοκιμάζει και να διαχειρίζεται το ThunderPhone. |
Έλεγχος ταυτότητας
Χρησιμοποιήστε OAuth από προεπιλογή για πελάτες καταλόγου: συνδεθείτε, επιλέξτε έναν οργανισμό και εγκρίνετε τα ζητούμενα δικαιώματα. Αποσυνδέστε τον από Ρυθμίσεις → Ασφάλεια → Συνδεδεμένες εφαρμογές. Η αλλαγή ή επαναφορά του κωδικού πρόσβασής σας ή η αλλαγή του email του λογαριασμού σας ανακαλεί επίσης τη σύνδεση, επομένως συνδέστε ξανά τον πελάτη στη συνέχεια.
Για πελάτες που έχουν ρυθμιστεί με κλειδί API, δημιουργήστε ένα κλειδί sk_live_ από Ενσωματώσεις → Κλειδιά API και διαθέστε το στον πελάτη MCP ως THUNDERPHONE_API_KEY. Το κλειδί συνδέεται με έναν οργανισμό· ένα ID που ανήκει σε άλλον οργανισμό αντιμετωπίζεται ως μη βρέθηκε.
Οργανισμοί που διαχειρίζονται PHI
Αν οι κλήσεις του οργανισμού σας ενδέχεται να περιέχουν προστατευμένες πληροφορίες υγείας (PHI),
επειδή έχετε BAA με το ThunderPhone ή οι πράκτορές σας έχουν οριστεί να
επεξεργάζονται PHI, η παραπάνω διεύθυνση URL δεν επιστρέφει ποτέ περιεχόμενο κλήσεων: απομαγνητοφωνήσεις,
ηχογραφήσεις, αξιολογήσεις, λίστες κλήσεων, εξαγωγές, αποτελέσματα καμπανιών, αναλυτικά στοιχεία κλήσεων και
πληροφορίες, συνομιλίες που δημιουργήθηκαν από πραγματικές κλήσεις και αποτελέσματα επανάληψης. Αυτά τα εργαλεία επιστρέφουν σφάλμα με
code: "phi_content_unavailable". Η δημιουργία, η δοκιμή και η διαμόρφωση πρακτόρων
λειτουργεί ως συνήθως.
Αυτή η διεύθυνση URL είναι εκείνη που αναφέρεται στους δημόσιους καταλόγους βοηθών, οι οποίοι ενδέχεται να μην μεταφέρουν PHI. Αν ο οργανισμός σας έχει δικό του BAA με τον πάροχο ενός βοηθού που καλύπτει τον χώρο εργασίας που χρησιμοποιείτε:
- Ένας διαχειριστής οργανισμού ανοίγει το Οργανισμός → Γενικά → Πρόσβαση βοηθού AI στο ThunderPhone και επιβεβαιώνει αυτή την κάλυψη.
- Συνδέστε τον βοηθό ως προσαρμοσμένο σύνδεσμο με αυτήν τη διεύθυνση URL:
https://api.thunderphone.com/v1/mcp/baaΤο περιεχόμενο κλήσεων είναι τότε διαθέσιμο εκεί, συμπεριλαμβανομένων κλήσεων που ενδέχεται να περιέχουν PHI. Η ανάκληση της επιβεβαίωσης το διακόπτει στο επόμενο αίτημα του βοηθού. Μια κλήση που ο οργανισμός σας χειρίστηκε ως μη περιέχουσα PHI είναι διαθέσιμη και στις δύο διευθύνσεις URL.
Εναλλακτικές CLI και stdio
Το CLI του ThunderPhone μπορεί να εγγράψει τη ρύθμιση πελάτη διατηρώντας τους άσχετους διακομιστές:
npx -y @thunderphone/mcp setup --client cursor --api-key-env THUNDERPHONE_API_KEY
npx thunderphone mcp setup --client claude-desktop --scope userΜετά από καθολική εγκατάσταση του @thunderphone/mcp, χρησιμοποιήστε το thunderphone-mcp setup με τις
ίδιες επιλογές. Η ρύθμιση υποστηρίζει Claude Code, Codex, Cursor, VS Code, Gemini, Claude
Desktop και Windsurf. Προτιμάται το απευθείας HTTP· το Desktop χρησιμοποιεί stdio.
Για κάθε πελάτη που υποστηρίζει stdio, ρυθμίστε command: "npx" με
args: ["-y", "@thunderphone/mcp"]. Το περιτύλιγμα χρησιμοποιεί πρώτα το THUNDERPHONE_API_KEY,
έπειτα διαπιστευτήρια από το thunderphone login, ανανεώνοντας ληγμένα διακριτικά, και στη συνέχεια
OAuth μέσω mcp-remote. Η σύνδεση συσκευής και το OAuth απαιτούν την αντίστοιχη διάθεση
OAuth του API. Η διαδρομή κλειδιού API δεν το απαιτεί. Οι απευθείας ρυθμίσεις HTTP δεν διαβάζουν
τον χώρο αποθήκευσης διαπιστευτηρίων του CLI· χρησιμοποιήστε το περιτύλιγμα stdio για να επαναχρησιμοποιήσετε τη σύνδεση συσκευής.
Αυτές είναι εναλλακτικές στις μη αυτόματες ρυθμίσεις πελάτη παρακάτω.
Διαμόρφωση προγράμματος-πελάτη
Το Claude και το ChatGPT συνδέονται με OAuth· δεν απαιτείται κλειδί API. Αν δεν έχετε ακόμη λογαριασμό ThunderPhone, επιλέξτε Δημιουργία λογαριασμού στη σελίδα σύνδεσης και θα επιστρέψετε στην οθόνη έγκρισης αφού επαληθεύσετε το email σας.
Claude (ιστός, υπολογιστής και κινητό)
- Ανοίξτε Προσαρμογή → Συνδέσεις (Ρυθμίσεις → Συνδέσεις σε παλαιότερες εκδόσεις). Αν το ThunderPhone εμφανίζεται στον κατάλογο συνδέσεων, επιλέξτε το. Διαφορετικά, επιλέξτε Προσθήκη προσαρμοσμένης σύνδεσης, ονομάστε τη
ThunderPhoneκαι εισαγάγετεhttps://api.thunderphone.com/v1/mcp. - Επιλέξτε Σύνδεση, συνδεθείτε στο ThunderPhone, επιλέξτε τον οργανισμό και εγκρίνετε τα δικαιώματα.
- Σε μια συνομιλία, ενεργοποιήστε το ThunderPhone από το μενού εργαλείων και ζητήστε ό,τι χρειάζεστε, για παράδειγμα «Εμφάνιση των πρακτόρων μου».
Το Claude ζητά επιβεβαίωση πριν χρησιμοποιήσει κάθε εργαλείο για πρώτη φορά. Για να παραλείψετε τα περισσότερα από αυτά τα μηνύματα, ανοίξτε Προσαρμογή → Συνδέσεις → ThunderPhone και ορίστε τα Εργαλεία μόνο για ανάγνωση σε πάντα επιτρέπονται. Αυτά τα εργαλεία πραγματοποιούν μόνο αναζητήσεις: πράκτορες, κλήσεις, απομαγνητοφωνήσεις, υπόλοιπα, έγγραφα. Διατηρήστε τα Εργαλεία εγγραφής/διαγραφής σε έγκριση, αν θέλετε να βλέπετε κάθε αλλαγή πριν πραγματοποιηθεί.
Οι προσαρμοσμένες συνδέσεις απαιτούν πρόγραμμα Claude επί πληρωμή. Στα προγράμματα Team και Enterprise, ένας κάτοχος προσθέτει πρώτα τη σύνδεση στις ρυθμίσεις συνδέσεων του οργανισμού και έπειτα κάθε μέλος συνδέει τον δικό του λογαριασμό ThunderPhone.
Τι διαφέρει στο Claude
Το Claude (ο σύνδεσμος και το πρόσθετο Claude Code) διαθέτει ένα πιο περιορισμένο σύνολο εργαλείων, σύμφωνα με την πολιτική του καταλόγου συνδέσμων του Claude:
- Κάθε κλήση και μήνυμα κειμένου επιβεβαιώνονται ένα κάθε φορά. Τα
place_callκαιsend_smsεπιστρέφουν αρχικά μια προεπισκόπηση (τον πράκτορα, τους αριθμούς αποστολέα και παραλήπτη και, για μήνυμα κειμένου, το μήνυμα) μαζί με έναconfirmation_token; δεν πραγματοποιείται ούτε αποστέλλεται τίποτα έως ότου το Claude επαναλάβει το αίτημα με το διακριτικό μετά την επιβεβαίωσή σας. - Χωρίς διαχείριση καμπανιών. Τα
create_campaign,add_campaign_contactsκαιcampaign_actionδεν είναι διαθέσιμα· δημιουργήστε, φορτώστε και ξεκινήστε καμπάνιες στον πίνακα ελέγχου. Ταlist_campaigns,get_campaign_statsκαιcheck_campaignεξακολουθούν να λειτουργούν. - Χωρίς
test_integration. Δοκιμάστε το αίτημα μιας ενσωμάτωσης από τη σελίδα της στον πίνακα ελέγχου. - Το
preview_voiceαναπαράγει έναν σταθερό δείγμα χαιρετισμού στη φωνή και τη γλώσσα που επιλέγετε· δεν εκφωνεί προσαρμοσμένο κείμενο. - Τα
list_voicesκαιlist_agentsεπιστρέφουν μια σύνοψη· τοget_agentπεριέχει την πλήρη διαμόρφωση ενός πράκτορα.
Γνωστοποίηση AI
Κάθε κλήση που πραγματοποιεί ή απαντά ένας πράκτορας ThunderPhone ξεκινά με προφορική γνωστοποίηση AI. Από προεπιλογή αναφέρει «Αυτή η κλήση γίνεται με έναν AI πράκτορα και θα καταγραφεί και θα απομαγνητοφωνηθεί.» Η απενεργοποίησή της (consent_announcement_enabled false ή ai_live_processing_disclosure_override off) απορρίπτεται, εκτός αν ένας διαχειριστής του οργανισμού έχει προηγουμένως καταγράψει μια υπογεγραμμένη βεβαίωση στον πίνακα ελέγχου, από οποιοδήποτε πρόγραμμα-πελάτη, συμπεριλαμβανομένου του Claude.
ChatGPT
- Αν το ThunderPhone εμφανίζεται στον κατάλογο εφαρμογών του ChatGPT, επιλέξτε το και συνδεθείτε.
- Διαφορετικά, ανοίξτε Ρυθμίσεις → Εφαρμογές και συνδέσεις → Σύνθετες ρυθμίσεις, ενεργοποιήστε τη Λειτουργία προγραμματιστή και δημιουργήστε μια σύνδεση με τη διεύθυνση URL
https://api.thunderphone.com/v1/mcpκαι έλεγχο ταυτότητας OAuth. - Συνδεθείτε στο ThunderPhone, επιλέξτε τον οργανισμό και εγκρίνετε τα δικαιώματα. Προσθέστε το ThunderPhone σε μια συνομιλία από το μενού εργαλείων.
Η διαγραφή ενός πράκτορα ή αριθμού τηλεφώνου, η απόρριψη ενός προσχεδίου, η έναρξη μιας καμπάνιας και η αποστολή ενός δοκιμαστικού αιτήματος που μπορεί να εγγράψει δεδομένα σε εξωτερικό σύστημα απαιτούν δεύτερη επιβεβαίωση σε κάθε εφαρμογή· ανατρέξτε στην ενότητα Επιβεβαίωση καταστροφικών ενεργειών.
Claude Code
claude mcp add --transport http thunderphone https://api.thunderphone.com/v1/mcp \
--header "Authorization: Bearer $THUNDERPHONE_API_KEY"Codex
Προσθέστε το παρακάτω στο ~/.codex/config.toml:
[mcp_servers.thunderphone]
url = "https://api.thunderphone.com/v1/mcp"
bearer_token_env_var = "THUNDERPHONE_API_KEY"Cursor
Δημιουργήστε το .cursor/mcp.json:
{
"mcpServers": {
"thunderphone": {
"url": "https://api.thunderphone.com/v1/mcp",
"headers": {
"Authorization": "Bearer ${env:THUNDERPHONE_API_KEY}"
}
}
}
}Claude Desktop
Προσθέστε μια γέφυρα mcp-remote στη διαμόρφωση του Claude Desktop:
{
"mcpServers": {
"thunderphone": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://api.thunderphone.com/v1/mcp",
"--header",
"Authorization: Bearer ${THUNDERPHONE_API_KEY}"
],
"env": {
"THUNDERPHONE_API_KEY": "sk_live_YOUR_API_KEY"
}
}
}
}VS Code
Δημιουργήστε το .vscode/mcp.json και εισαγάγετε το κλειδί μέσω του μηνύματος εισαγωγής του VS Code:
{
"inputs": [
{
"type": "promptString",
"id": "thunderphone-api-key",
"description": "ThunderPhone organization API key",
"password": true
}
],
"servers": {
"thunderphone": {
"type": "http",
"url": "https://api.thunderphone.com/v1/mcp",
"headers": {
"Authorization": "Bearer ${input:thunderphone-api-key}"
}
}
}
}Εργαλεία
Κάθε εργαλείο φέρει σημειώσεις MCP. Στους πίνακες, το R σημαίνει μόνο για ανάγνωση, το D καταστροφικό, το I ιδιοσταθές και το O αλληλεπίδραση με εξωτερικό δίκτυο. Μια παύλα σημαίνει ότι δεν έχει οριστεί υπόδειξη.
Σύνδεση
| Εργαλείο | Κύρια ορίσματα | Σημειώσεις | Τι κάνει |
|---|---|---|---|
get_connection_identity | — | R, I | Επικυρώνει το διαπιστευτήριο και επιστρέφει τον οργανισμό του και ασφαλή μεταδεδομένα διαπιστευτηρίου. |
Πράκτορες
| Εργαλείο | Κύρια ορίσματα | Σημειώσεις | Τι κάνει |
|---|---|---|---|
list_agents | — | R, I | Παραθέτει τους πράκτορες. |
get_agent | agent_id | R, I | Ανακτά έναν πράκτορα. |
create_agent | διαμόρφωση πράκτορα | — | Δημιουργεί έναν πράκτορα. Δέχεται τις ίδιες ρυθμίσεις με το update_agent, συμπεριλαμβανομένων των steps, handoffs, intro_clip και intro_ring_count. |
update_agent | agent_id, τροποποιημένα πεδία, προαιρετικά prompt_edits, expected_prompt_sha256 | D | Καταχωρίζει πεδία στο πρόχειρο του πράκτορα, αντικαθιστώντας όσα περιείχε το πρόχειρο. Εκτελείται χωρίς βήμα επιβεβαίωσης: ο αναπτυγμένος πράκτορας παραμένει αμετάβλητος έως το deploy_agent, ενώ το discard_agent_draft επαναφέρει το πρόχειρο. Μπορείτε επίσης να ορίσετε τα max_hold_seconds, system_tool_settings και words. Για να αλλάξετε μέρος του prompt, στείλτε prompt_edits (δείτε την Επεξεργασία ενός prompt επιτόπου). |
deploy_agent | agent_id, προαιρετικά if_updated_at | D, I | Προωθεί το πρόχειρο στην παραγωγή. |
discard_agent_draft | agent_id, προαιρετικά if_updated_at, confirmation_token στο δεύτερο αίτημα | D, I | Απορρίπτει τις σταδιακά καταχωρισμένες αλλαγές. Δύο βήματα, δείτε την Επιβεβαίωση καταστροφικών ενεργειών. |
duplicate_agent | agent_id, προαιρετικά name | — | Αντιγράφει έναν πράκτορα εντός του οργανισμού. |
delete_agent | agent_id, confirmation_token στο δεύτερο αίτημα | D, I | Διαγράφει οριστικά έναν πράκτορα. Δύο βήματα. |
list_agent_versions | agent_id | R, I | Παραθέτει τις εκδόσεις διαμόρφωσης που έχουν αναπτυχθεί. |
list_prompt_revisions | agent_id, προαιρετικά source, limit, offset | R, I | Παραθέτει κάθε αλλαγή στο κείμενο prompt του πράκτορα, συμπεριλαμβανομένων των πρόχειρων, καθεμία με διαφορά σε σύγκριση με την αναθεώρηση που αντικατέστησε. Διαθέσιμο όταν η εργαλειοθήκη επανάληψης πρακτόρων είναι διαθέσιμη στη σύνδεσή σας (δείτε παρακάτω). |
review_prompt | agent_id, προαιρετικά prompt, previous_prompt, quote_id, max_cost_cents | — | Ελέγχει το πρόχειρο prompt (ή το κείμενο που στέλνετε) σε σχέση με τον οδηγό ύφους prompt. Κάθε εύρημα παραθέτει το απόσπασμα, ονομάζει την οδηγία και προσφέρει μια επεξεργασία εύρεσης και αντικατάστασης· το αποτέλεσμα παραθέτει επίσης τις συμπεριφορές που ζητά το prompt, με σταθερά αναγνωριστικά, αν απαιτείται αναδιαμόρφωση και, για το prompt του ίδιου του πράκτορα, αν οι δοκιμαστικές συνομιλίες του χρειάζονται ανανέωση. Δεν αλλάζει τίποτα στον πράκτορα· ο κατάλογος αποθηκεύεται με την αναθεώρηση του prompt του. Είναι επί πληρωμή, επομένως δεν επισημαίνεται ως μόνο για ανάγνωση: λάβετε πρώτα προσφορά με dry_run, έπειτα εκτελέστε το ξανά χωρίς dry_run, με το quote_id που επιστρέφει και το max_cost_cents. Αυτές οι επί πληρωμή εκτελέσεις υπολογίζονται πλέον στο ίδιο όριο εργαλειοθήκης του οργανισμού με τις άλλες εκτελέσεις εργαλειοθήκης. Διαθέσιμο όταν η εργαλειοθήκη επανάληψης πρακτόρων είναι διαθέσιμη στη σύνδεσή σας (δείτε παρακάτω). |
refactor_prompt | agent_id, προαιρετικά prompt, inventory, instructions, quote_id, max_cost_cents | — | Επαναγράφει το prompt στη μορφή του οδηγού ύφους και αντιστοιχίζει κάθε συμπεριφορά ως διατηρημένη, συγχωνευμένη, αναδιατυπωμένη ή αφαιρεμένη. Επιστρέφει το νέο κείμενο και μια διαφορά και, από προεπιλογή, το επανελέγχει για να αναφέρει τα behavior_changes (προστέθηκαν, αφαιρέθηκαν ή άλλαξαν) και το behavior_preserved· εφαρμόστε το με το update_agent. Επί πληρωμή: λάβετε προσφορά με dry_run, έπειτα εκτελέστε το μία φορά με το quote_id που επιστρέφει και το max_cost_cents. Διαθέσιμο όταν η εργαλειοθήκη επανάληψης πρακτόρων είναι διαθέσιμη στη σύνδεσή σας (δείτε παρακάτω). |
list_reusable_instructions | — | R, I | Παραθέτει επαναχρησιμοποιήσιμες οδηγίες: κοινόχρηστους κανόνες prompt που συνδέονται με πολλούς πράκτορες μέσω των reusable_instruction_ids του update_agent. |
create_reusable_instruction | name, content | — | Δημιουργεί μια ασύνδετη επαναχρησιμοποιήσιμη οδηγία. Μόνο για διαχειριστές. |
Αριθμοί τηλεφώνου και πάροχοι
| Εργαλείο | Κύρια ορίσματα | Σημειώσεις | Τι κάνει |
|---|---|---|---|
list_phone_numbers | — | R, I | Παραθέτει τους αριθμούς και τη δρομολόγηση του οργανισμού. |
get_phone_number_limits | — | R, I | Λαμβάνει τη χρήση και τα όρια των διαχειριζόμενων αριθμών. |
provision_phone_number | προαιρετικά area_code, city, state, idempotency_key | D, O | Αγοράζει έναν εισερχόμενο αριθμό που διαχειρίζεται το ThunderPhone. |
list_voip_connections | — | R, I | Παραθέτει τους συνδεδεμένους παρόχους του πελάτη. |
search_voip_numbers | connection_id, country, type, προαιρετικά area_code | R, I, O | Αναζητά στο απόθεμα του παρόχου. |
import_voip_numbers | connection_id, numbers | D, O | Εισάγει αριθμούς που ανήκουν ήδη στον πάροχο. |
update_phone_number | phone_number_id, πεδία δρομολόγησης/ετικέτας/webhook | D | Ενημερώνει τη δρομολόγηση αριθμού, συμπεριλαμβανομένης της ανάθεσης πράκτορα. |
delete_phone_number | phone_number_id, confirm, προαιρετικά release_at_provider, confirmation_token στο δεύτερο αίτημα | D, I, O | Αποδεσμεύει έναν αριθμό. Δύο βήματα. |
get_voip_setup_session | προαιρετικά session_id | R, I | Διαβάζει μια καθοδηγούμενη ρύθμιση παρόχου (κατάσταση, λίστα ελέγχου, την ερώτηση που αναμένει) ή παραθέτει ανοιχτές ρυθμίσεις. Μια ρύθμιση ξεκινά στον πίνακα ελέγχου επειδή απαιτεί τον κωδικό πρόσβασης του παρόχου. Μόνο για διαχειριστές. |
answer_voip_setup_question | session_id, question_id, answer | O | Μεταβιβάζει την απάντηση του χρήστη στη ρύθμιση. Οι κωδικοί πρόσβασης, η συγκατάθεση για δοκιμαστική κλήση, η διεύθυνση διακομιστή, το όνομα χρήστη και η άδεια στο ThunderPhone να συνδεθεί στον λογαριασμό παρόχου απαντώνται μόνο στον οδηγό ρύθμισης· για αυτά επιστρέφει τον σύνδεσμο του οδηγού και δεν στέλνει τίποτα. |
save_voip_setup | session_id, προαιρετικά name, confirmation_token στο δεύτερο αίτημα | D, I, O | Αποθηκεύει ένα συνδεδεμένο πρόχειρο σύνδεσης ώστε να μπορεί να χρησιμοποιηθεί. Δύο βήματα. |
check_phone_number | phone_number ή phone_number_id | R, I, O | Διαγιγνώσκει έναν από τους αριθμούς του οργανισμού βάσει στοιχείων: δρομολόγηση, σύνδεση, επαλήθευση, πρόσφατες κλήσεις παρόχου και δοκιμαστικές κλήσεις, και πού τον στέλνει ο πάροχος. |
SMS
| Εργαλείο | Κύρια ορίσματα | Επισημάνσεις | Τι κάνει |
|---|---|---|---|
send_sms | from_number, to, body, idempotency_key | D, I, O | Στέλνει ένα SMS απλού κειμένου μέσω ενός συνδεδεμένου αριθμού Twilio ή Telnyx. |
Κλήσεις
| Εργαλείο | Κύρια ορίσματα | Σημειώσεις | Τι κάνει |
|---|---|---|---|
list_calls | προαιρετικά φίλτρα, limit, offset | R, I | Εμφανίζει κλήσεις με τα φίλτρα ιστορικού κλήσεων REST, συμπεριλαμβανομένου του exclude_test_calls. |
get_call | call_id | R, I | Λαμβάνει την κατάσταση και τα μεταδεδομένα της κλήσης. |
get_call_transcript | call_id, προαιρετικό live | R, I | Λαμβάνει την απομαγνητοφώνηση της κλήσης. |
get_call_audio_url | call_id, προαιρετικό download | R, I, O | Επιστρέφει ένα υπογεγραμμένο URL ήχου· δεν μεταδίδει ποτέ ήχο μέσω MCP. |
get_call_grade | call_id | R, I | Λαμβάνει την πιο πρόσφατη αξιολόγηση κλήσης. |
place_call | agent_id, from_number, to_number | D, O | Πραγματοποιεί μία μη ιδιοσυγκρασιακή εξερχόμενη κλήση. |
export_calls | φίλτρα κλήσεων, export_format | R, I | Εξάγει έως το όριο του τελικού σημείου REST ως JSON ή CSV. |
get_call_analytics | προαιρετικά since_days, agent_id | R, I | Συγκεντρώνει πραγματικές κλήσεις ανά κατάσταση, κατεύθυνση, αποτέλεσμα, αξιολόγηση και ζήτημα, με τις δοκιμαστικές κλήσεις να καταμετρώνται ξεχωριστά. |
get_call_insights | call_ids (έως 10) | R, I | Λαμβάνει ταυτόχρονα την αξιολόγηση, το αποτέλεσμα, τη σύνοψη και τα εντοπισμένα ζητήματα πολλών κλήσεων. |
Δοκιμές και επικύρωση
| Εργαλείο | Κύρια ορίσματα | Σημειώσεις | Τι κάνει |
|---|---|---|---|
list_test_scenarios | agent_id | R, I | Παραθέτει σενάρια δοκιμών. |
create_test_scenario | agent_id, title, scenario_prompt, προαιρετικές συνθήκες | — | Δημιουργεί ένα σενάριο. |
generate_test_scenarios | agent_id, προαιρετικά count, include_edge_cases, locale | O | Δημιουργεί σενάρια από την προτροπή του πράκτορα. |
run_agent_tests | agent_id, channel, consent_to_charge, προαιρετική επιλογή/μήτρα | D, O | Εκτελεί σενάρια μέσω ιστού ή τηλεφωνίας. |
get_test_run | agent_id, batch_id | R, I | Λαμβάνει την κατάσταση παρτίδας και τα αποτελέσματα ανά σενάριο. |
test_my_agent | agent_id, consent_to_charge, προαιρετικά scenario_ids, count, wait_seconds | D, O | Δοκιμάζει έναν πράκτορα με μία κλήση: εκτελεί τα αποθηκευμένα σενάριά του (δημιουργώντας ορισμένα όταν δεν έχει) και περιμένει έως ένα λεπτό για τις αξιολογήσεις ή επιστρέφει το batch_id για το get_test_run. Χρεώνεται όπως το run_agent_tests. |
test_in_text | agent_id, callers (1 έως 3 περιγραφές), προαιρετικά version, direction | O | Δοκιμή ελεύθερου κειμένου: προσομοιωμένοι καλούντες μιλούν με το προσχέδιο του πράκτορα (ή την ενεργή έκδοση) σε κείμενο μέσω της πραγματικής διοχέτευσης και τα απομαγνητοφωνημένα κείμενα επιστρέφουν σε περίπου ένα λεπτό. Τα αποτελέσματα του εργαλείου είναι προσομοιωμένα. |
run_simulation | agent_id, consent_to_charge, προαιρετικά scenario_prompt, direction, language | D, O | Ξεκινά μία προσομοιωμένη τηλεφωνική κλήση μεταξύ ενός καλούντος AI και του προσχεδίου του πράκτορα, ώστε ένα άτομο να μπορεί να ακούσει μια αλλαγή. Επιστρέφει την εκτέλεση με in_progress. Καταγράφεται όταν ο πράκτορας καταγράφει κλήσεις και αξιολογείται αφού ολοκληρωθεί. Χρεώνεται όπως μια δοκιμαστική κλήση, πρώτα από τον δωρεάν προϋπολογισμό δοκιμών. |
get_simulation | simulation_id | R, I | Λαμβάνει την κατάσταση μιας προσομοιωμένης κλήσης και, μόλις ολοκληρωθεί, όσα παρήγαγε: ένα URL εγγραφής περιορισμένης διάρκειας και το απομαγνητοφωνημένο κείμενο όταν ο πράκτορας καταγράφει κλήσεις, καθώς και τη βαθμολογία μόλις ολοκληρωθεί η αξιολόγηση (null προηγουμένως). |
list_validation_runs | agent_id | R, I | Παραθέτει πρόσφατες εκτελέσεις επικύρωσης προσχεδίων. |
get_validation_status | agent_id | R, I | Λαμβάνει την πιο πρόσφατη κατάσταση επικύρωσης και την αντιστοίχιση του προσχεδίου. |
list_conversations | agent_id, προαιρετικά split, source | R, I | Παραθέτει τις συνομιλίες έναντι των οποίων δοκιμάζεται ο πράκτορας. Απαιτεί την εργαλειοθήκη επανάληψης πράκτορα. |
get_conversation | conversation_id | R, I | Λαμβάνει μία συνομιλία δοκιμής με τις τρέχουσες εναλλαγές της. Απαιτεί την εργαλειοθήκη επανάληψης πράκτορα. |
get_conversation_revisions | conversation_id, προαιρετικά limit, offset | R, I | Παραθέτει κάθε αναθεώρηση μιας συνομιλίας δοκιμής: πώς και γιατί άλλαξε (ανανεώθηκε για αλλαγή προτροπής, αποκαταστάθηκε από προηγούμενη αναθεώρηση), τις συμπεριφορές που προστέθηκαν, αφαιρέθηκαν και άλλαξαν, τα παραδείγματα που μετακινήθηκαν ή αποσύρθηκαν και τη διαφορά γραμμών. Απαιτεί την εργαλειοθήκη επανάληψης πράκτορα. |
generate_conversations | agent_id, προαιρετικά count, style | O | Συντάσσει προσομοιωμένες συνομιλίες δοκιμής έναντι του προσχεδίου του πράκτορα και μετατρέπει τις δυσκολότερες στιγμές τους σε παραδείγματα επικύρωσης με κλειδιά απαντήσεων. Ζητήστε πρώτα προσφορά με dry_run; μια πραγματική εκτέλεση χρειάζεται το quote_id και το max_cost_cents. Απαιτεί την εργαλειοθήκη επανάληψης πράκτορα. |
import_conversations | agent_id, προαιρετικά since_days, max_calls | O | Μετατρέπει τις πρόσφατες κλήσεις του πράκτορα σε συνομιλίες δοκιμής (το πολύ δύο ανά καλούντα, με παράλειψη κλήσεων χωρίς καταγραφή) και τις δυσκολότερες στιγμές τους σε παραδείγματα. Ζητήστε πρώτα προσφορά με dry_run; μια πραγματική εκτέλεση χρειάζεται το quote_id και το max_cost_cents. Απαιτεί την εργαλειοθήκη επανάληψης πράκτορα. |
refresh_conversations | agent_id, προαιρετικά conversation_ids, from_prompt_revision_id | O | Ενημερώνει τις συνομιλίες δοκιμής του πράκτορα σύμφωνα με την τρέχουσα προτροπή του μετά την προσθήκη, αφαίρεση ή αλλαγή συμπεριφορών: επαναστοχεύει, αποκαθιστά μια προηγούμενη αναθεώρηση (συμπεριλαμβανομένου πραγματικού ήχου) ή ξαναγράφει τις παρωχημένες εναλλαγές και αποσύρει παραδείγματα των οποίων η εναλλαγή του καλούντος δεν υπάρχει πλέον. Ζητήστε πρώτα προσφορά με dry_run; μια πραγματική εκτέλεση χρειάζεται το quote_id και το max_cost_cents. Απαιτεί την εργαλειοθήκη επανάληψης πράκτορα. |
get_conversation_job | job_id | R, I | Λαμβάνει μια εργασία δημιουργίας, εισαγωγής ή ανανέωσης: την κατάσταση, το κόστος έως τώρα σε σχέση με το όριό της και όσα έγραψε ή ανανέωσε. Απαιτεί την εργαλειοθήκη επανάληψης πράκτορα. |
run_replays | agent_id, προαιρετικά overrides, split, engine, sample_size, sample_seed, max_cost_cents, quote_id, dry_run | D, O | Επαναπαράγει ένα δείγμα από τα παραδείγματα του πράκτορα με το προσχέδιό του ή με παρακάμψεις όπως μια υποψήφια προτροπή, φωνή ή βαθμίδα, και αξιολογεί κάθε απάντηση σε σχέση με το κλειδί απαντήσεων του παραδείγματος. Οι ακριβείς επαναλήψεις εκτελούν τον καταγεγραμμένο ήχο της εναλλαγής όπως θα τον εκτελούσε μια πραγματική κλήση· τα ποσοστά επιτυχίας αναφέρονται ανά μηχανή. Οι επαναλήψεις κλήσεων PHI εκτελούνται ως PHI και μια διαμόρφωση που δεν μπορούν να εκτελέσουν (μια φωνή ElevenLabs, ένα πειραματικό προϊόν) απορρίπτεται. Το dry_run επιστρέφει μια εκτίμηση, το sample_seed που επέλεξε και ένα quote_id; μια πραγματική εκτέλεση στέλνει το ίδιο αίτημα με αυτό το quote_id και το sample_seed, καθώς και το max_cost_cents, ένα αυστηρό όριο: κάθε αίτημα δεσμεύει το ανώτατο κόστος του πριν σταλεί και η εκτέλεση σταματά αντί να στείλει κάποιο που δεν χωρά, επομένως αφήστε το largest_reservation_cents της εκτίμησης ως περιθώριο ανά εργαζόμενο. Μια ακριβής επανάληψη δεσμεύει το χειρότερο σενάριό της, περίπου 85 σεντ έως $1.25 ανά ενεργή επανάληψη για μια τυπική εναλλαγή (δύο εκτελούνται ταυτόχρονα), έναντι πραγματικού κόστους λίγων σεντ· η εκτέλεση χρεώνεται ό,τι πραγματικά κοστίζουν οι επαναλήψεις, επομένως ορίστε το max_cost_cents με περιθώριο. Μια ακριβής επανάληψη εκτελείται με προϋπολογισμό για μια κανονική εναλλαγή συν μία επανεκτέλεση του είδους που απαιτεί η παραγωγή (η απάντηση ανταγωνίζεται ξανά και γίνεται επανάληψη από επιτήρηση)· μια εναλλαγή που χρειάζεται περισσότερα καταγράφεται ως σφάλμα, replay_budget_exhausted, μετράται ξεχωριστά ως budget_exhausted, εξαιρείται από το ποσοστό επιτυχίας και, στον διαχωρισμό δοκιμών, δεν καταναλώνει κοόρτη. Στον διαχωρισμό δοκιμών, μια κοόρτη με καταγεγραμμένο ήχο καλούντος υπό διαμόρφωση διαφορετική από Bolt v2 απορρίπτεται (test_needs_exact_replay) και παραμένει αχρησιμοποίητη: μετρήστε αυτή τη διαμόρφωση στον διαχωρισμό ανάπτυξης. Απαιτεί την εργαλειοθήκη επανάληψης πράκτορα. |
compare_configs | agent_id, configs (2 έως 4, η πρώτη είναι η γραμμή βάσης), προαιρετικά sample_size, sample_seed, max_cost_cents, quote_id, dry_run | O | Επαναπαράγει τα ίδια παραδείγματα με κάθε διαμόρφωση και αναφέρει ποσοστό επιτυχίας, παραδείγματα που διορθώθηκαν και χάλασαν σε σχέση με τη γραμμή βάσης, καθυστέρηση έως τον πρώτο ήχο, πόσο συχνά ο καλών περίμενε επιβεβαίωση, ήχους αναμονής ή σιωπή και κόστος ανά εναλλαγή, ανά μηχανή. Ζητήστε προσφορά με dry_run όπως στο run_replays. Μόνο για τον διαχωρισμό ανάπτυξης: στον διαχωρισμό δοκιμών απορρίπτεται (comparison_dev_only)· συγκρίνετε στην ανάπτυξη και, στη συνέχεια, μετρήστε την επιλογή με run_replays. Απαιτεί την εργαλειοθήκη επανάληψης πράκτορα. |
get_replay_run | run_id, προαιρετικά include_trace | R, I | Λαμβάνει τα σύνολα, τις ανατροπές και τα αποτελέσματα ανά παράδειγμα μιας εκτέλεσης επανάληψης, καθώς και την ομάδα σύγκρισής της. Οι ακριβείς επαναλήψεις που χρειάστηκαν περισσότερο από τον προϋπολογισμό τους μετρώνται ξεχωριστά (budget_exhausted), εκτός του ποσοστού επιτυχίας. Απαιτεί την εργαλειοθήκη επανάληψης πράκτορα. |
create_talk_link | agent_id, προαιρετικά variant_id, language, expires_in_minutes | O | Δημιουργεί έναν σύνδεσμο μίας χρήσης που ένα άτομο ανοίγει σε πρόγραμμα περιήγησης για να μιλήσει με το τρέχον προσχέδιο του πράκτορα, όπως το κουμπί «Μιλήστε» του πίνακα ελέγχου. Ο σύνδεσμος λήγει έπειτα από 30 λεπτά από προεπιλογή (το πολύ 120)· η συνομιλία χρεώνεται όπως μια δοκιμαστική κλήση «Μιλήστε». Δείτε Συνδέσμους «Μιλήστε». |
Τα εργαλεία που επισημαίνονται ότι χρειάζονται την εργαλειοθήκη επανάληψης πράκτορα αποτελούν μέρος της· η εργαλειοθήκη ενεργοποιείται ανά οργανισμό όσο βρίσκεται σε beta και, χωρίς αυτήν, επιστρέφουν feature_not_enabled μαζί με τις επόμενες ενέργειες. Κάθε συνομιλία ενός πράκτορα βρίσκεται είτε στον διαχωρισμό ανάπτυξης είτε στον διαχωρισμό δοκιμών του. Ο διαχωρισμός δοκιμών προορίζεται για τη μέτρηση μιας αλλαγής, όχι για τη ρύθμισή της, επομένως τα εργαλεία συνομιλιών επιστρέφουν μια συνομιλία του διαχωρισμού δοκιμών μόνο με το αναγνωριστικό, τον διαχωρισμό, την πηγή, την κατάσταση και τις μετρήσεις της. Μια εκτέλεση επαναλήψεων στον διαχωρισμό δοκιμών επαναλαμβάνει μία ολόκληρη ομάδα δοκιμών (sample_size και sample_seed αγνοούνται), κάθε παράδειγμα στη μηχανή που επιτρέπουν τα δεδομένα του, η οποία ορίζεται πριν από την εκτέλεση από το παράδειγμα (ακριβής για καταγεγραμμένο ήχο καλούντος, κείμενο για παράδειγμα μόνο με κείμενο· μια διαμόρφωση διαφορετική από Bolt v2 δεν έχει ακριβή διαδρομή, επομένως μια ομάδα με καταγεγραμμένο ήχο απορρίπτεται για αυτήν με test_needs_exact_replay και παραμένει αχρησιμοποίητη· το engine παραλείπεται ή είναι auto, καθώς τα exact ή text απορρίπτονται με test_engine_per_example και τίποτα δεν επιστρέφει σε κείμενο), και επιστρέφει μόνο συγκεντρωτικά στοιχεία, ανά μηχανή: ποσοστό επιτυχίας, αποτυχίες ανά σοβαρότητα και είδος, καθυστέρηση και κόστος. Το πρώτο αποτέλεσμά της που αποθηκεύει μια επανάληψη καταναλώνει την ομάδα, επομένως η επόμενη εκτέλεση δοκιμών, για οποιαδήποτε προτροπή, λαμβάνει άλλη, και όταν δεν απομένει καμία απορρίπτεται με no_test_cohort (η εισαγωγή κλήσεων ή η δημιουργία συνομιλιών συμπληρώνει νέες ομάδες)· μια εκτέλεση που ολοκληρώνεται πριν αποθηκεύσει μία (το Core δεν μπορεί να επαναλάβει ακριβώς τα παραδείγματα ήχου του, exact_replay_unavailable, η χωρητικότητα επαναλήψεών του παραμένει απασχολημένη, core_busy, ή κάθε γύρος εξάντλησε τον προϋπολογισμό του, replay_budget_exhausted) αφήνει την ομάδα αχρησιμοποίητη. Στον διαχωρισμό ανάπτυξης, μια ακριβής επανάληψη που δεν μπορεί να εκτελέσει το Core επιστρέφει σε κείμενο και η εκτέλεση επισημαίνεται ως degraded. Οι συγκρίσεις εκτελούνται μόνο στον διαχωρισμό ανάπτυξης. Κάθε επί πληρωμή εργαλείο δέχεται το quote_id της δοκιμαστικής εκτέλεσής του, το οποίο ισχύει για μία εκτέλεση: καταναλώνεται μία φορά, μόνιμα, όταν ξεκινά η εκτέλεση, ενώ μια έναρξη που απορρίπτεται ή αποτυγχάνει πριν από τότε το αφήνει χρησιμοποιήσιμο· μια εκτέλεση που αποτυγχάνει μετά από αυτό το δηλώνει και επαναλαμβάνεται με νέα δοκιμαστική εκτέλεση για νέο quote_id. Με OAuth, τα review_prompt και refactor_prompt χρειάζονται το εύρος agents:write, συμπεριλαμβανομένων των δοκιμαστικών εκτελέσεων, και τα εργαλεία συνομιλιών και επαναλήψεων χρειάζονται το testing:write για να εκτελεστούν. Οι χρήστες βλέπουν ολόκληρο τον διαχωρισμό δοκιμών στον πίνακα ελέγχου. Μια κλήση της οποίας ο καλών βρίσκεται στον διαχωρισμό δοκιμών ενός πράκτορα εξαιρείται, επειδή αποτελεί μέρος του συνόλου δοκιμών. Σε έναν οργανισμό με την εργαλειοθήκη, τα list_calls, get_call, get_call_transcript, get_call_audio_url, get_call_grade και export_calls την επιστρέφουν ακριβώς ως {"call_id", "start_time", "held_out": true} (started_at αντί για start_time στις γραμμές μιας εξαγωγής), χωρίς την απομαγνητοφώνηση, την εγγραφή, το ιστορικό, τη βαθμολογία ή την αναφορά της· κάθε άλλο πεδίο της κλήσης απουσιάζει, επομένως διαβάστε μια εξαιρεμένη γραμμή από το held_out της πριν από οτιδήποτε άλλο. Το REST API κάνει το ίδιο για κλειδιά API και διακριτικά OAuth, και οι προβολές του σε πολλές κλήσεις (συνοπτικές αναφορές, συστάδες ζητημάτων, διερευνήσεις, αναφορές διοχέτευσης) αφήνουν τις εξαιρεμένες κλήσεις εκτός των μετρήσεων, των συστάδων και των δειγμάτων τους και αποκρύπτουν οποιοδήποτε κείμενο έγραψε ένα μοντέλο από αυτές. Μια εγγραφή σε εξαιρεμένη κλήση (βαθμολόγηση, προώθησή της σε σενάριο δοκιμής, αναδημιουργία ενός γύρου) απορρίπτεται με held_out_call. Ένα σενάριο δοκιμής που κάποιος προώθησε από εξαιρεμένη κλήση επιστρέφεται από το list_test_scenarios και στις εκτελέσεις δοκιμών ακριβώς ως {"id", "held_out": true}, και μια εκτέλεση προσομοίωσης από αυτό, από το get_test_run και τα εργαλεία προσομοίωσης, ακριβώς ως {"id", "scenario_id", "held_out": true}· οι προσομοιωμένες κλήσεις του εξαιρούνται επίσης και οι εκτελέσεις δοκιμών εξακολουθούν να το εκτελούν. Μια συνομιλία ανάπτυξης, ένα παράδειγμα ή ένα αποτέλεσμα επανάληψης που αντιγράφηκε από κλήση εξαιρεμένου καλούντος (οι διαχωρισμοί είναι ανά πράκτορα, επομένως αυτός ο καλών μπορεί να βρίσκεται στον διαχωρισμό δοκιμών άλλου πράκτορα) διαβάζεται όπως ένα του διαχωρισμού δοκιμών. Οι χρήστες βλέπουν πλήρως τις εξαιρεμένες κλήσεις στον πίνακα ελέγχου και ένας διαχειριστής μπορεί να επιτρέψει σε ένα κλειδί API να τις βλέπει πλήρως (include_held_out_calls, απενεργοποιημένο από προεπιλογή, ορίζεται μόνο στον πίνακα ελέγχου), για μια ενσωμάτωση που χρειάζεται κάθε κλήση· το MCP δεν το χρησιμοποιεί ποτέ. Τα webhook παραμένουν αμετάβλητα. Οι οργανισμοί χωρίς την εργαλειοθήκη δεν βλέπουν πεδίο held_out και δεν υπάρχει καμία αλλαγή.
generate_conversations, import_conversations και refresh_conversations καταναλώνουν πιστώσεις μοντέλου. Καλέστε τα πρώτα με dry_run: true: η απάντηση είναι μια εκτίμηση κόστους, βήμα προς βήμα, με ένα quote_id, και δεν εκτελείται τίποτα. Η εκτίμηση υπολογίζει κάθε αίτημα που μπορεί να υποβάλει η εκτέλεση σε τυπικό μέγεθος. Μια πραγματική εκτέλεση χρειάζεται αυτό το quote_id (λήγει μετά από 15 λεπτά και λειτουργεί μόνο με τα ίδια ορίσματα) και το max_cost_cents, ένα αυστηρό ανώτατο όριο: πριν από κάθε αίτημα, η εργασία δεσμεύει το μέγιστο ποσό που μπορεί να κοστίσει αυτό το αίτημα και σταματά αντί να στείλει ένα που δεν χωράει, διατηρώντας όσα έγραψε. Λόγω αυτής της δέσμευσης, μια εκτέλεση μπορεί να σταματήσει με μέρος του ορίου της αδιάθετο· το largest_reservation_cents της εκτίμησης υποδεικνύει πόσο περιθώριο να αφήσετε. Οι προσομοιωμένοι καλούντες επινοούνται από την προτροπή του πράκτορα· το style: "adversarial" δημιουργεί δύσκολους καλούντες που πιέζουν στα αδύναμα σημεία της προτροπής, και αυτές οι συνομιλίες πηγαίνουν πάντα στον διαχωρισμό ανάπτυξης. Το target: "changed_behaviors" στρέφει τους καλούντες σε ό,τι άλλαξε στην τελευταία επεξεργασία της προτροπής. Κάθε πράκτορας εκτελεί μία από αυτές τις εργασίες ή μία εκτέλεση επανάληψης κάθε φορά, ώστε μια ανανέωση να μην αλλάζει ποτέ τα παραδείγματα στα οποία εκτελείται μια επανάληψη· η έναρξη ενώ εκτελείται το άλλο επιστρέφει job_active, replay_run_active ή conversation_job_active μαζί με το στοιχείο που πρέπει να περιμένετε.
Μετά από επεξεργασία προτροπής που προσθέτει, αφαιρεί ή αλλάζει μια συμπεριφορά, το review_prompt στο πρόχειρο του πράκτορα αναφέρει πόσες δοκιμαστικές συνομιλίες γράφτηκαν για μια προτροπή με άλλες συμπεριφορές (conversations.refresh_suggested). Το refresh_conversations έπειτα τις ενημερώνει σύμφωνα με το πρόχειρο, ώστε τα σύνολα ανάπτυξης και δοκιμών να μετρούν τη νέα προτροπή σε ιστορικά που θα μπορούσε να είχε παράγει. Μια ανανέωση δεν χάνει ποτέ τίποτα: κάθε συνομιλία διατηρεί κάθε προηγούμενη αναθεώρηση και, όταν ένας κανόνας που αφαιρέθηκε επανέρχεται, αποκαθίσταται η αναθεώρηση από τότε που υπήρχε μαζί με τον πραγματικό ήχο του καλούντος. Μια ανανέωση που ξεκινά ένας πράκτορας προγραμματισμού εξαιρεί από την επιλογή, την εκτίμηση, την πρόοδο και το κόστος τις συνομιλίες του διαχωρισμού δοκιμών και τις συνομιλίες που αντιγράφηκαν από αποκλεισμένες κλήσεις· η αναφορά μίας στο conversation_ids επιστρέφει 403 test_conversation. Ένα άτομο τις ανανεώνει από τον πίνακα ελέγχου και, για τους πράκτορες προγραμματισμού, τα αποτελέσματα αυτής της εργασίας τις εμφανίζουν μόνο ως αναγνωριστικά και πλήθη. Ένα active παράδειγμα του οποίου το ιστορικό, η απάντηση ή το κλειδί απαντήσεων ξαναγράφεται από μια ανανέωση επιστρέφει σε pending_review, με ετικέτα refreshed_needs_review. Η εκτίμηση μιας ανανέωσης κοστολογεί κάθε συνομιλία που διαβάζει σαν να ξαναγραφόταν, κάθε κλήση μοντέλου στο ανώτατο όριο εξόδου της, και ισχύει για την προτροπή και τις συνομιλίες για τις οποίες εκδόθηκε η εκτίμηση: όταν οποιοδήποτε από αυτά αλλάξει πριν από την εκτέλεση, ζητήστε ξανά εκτίμηση· όταν η προτροπή αλλάξει ενώ εκτελείται, η εργασία σταματά ως failed, διατηρώντας όσα ανανέωσε.
Γνώση
| Εργαλείο | Κύρια ορίσματα | Σημειώσεις | Τι κάνει |
|---|---|---|---|
list_knowledge_bases | — | R, I | Παραθέτει βάσεις γνώσης. |
create_knowledge_base | name, προαιρετικό description | — | Δημιουργεί μια βάση γνώσης. |
add_knowledge_document | knowledge_base_id, name, content | — | Προσθέτει κείμενο ή Markdown. |
import_knowledge_url | url, προαιρετικό name | O | Προσθέτει μια δημόσια σελίδα σε ουρά για ασφαλή εισαγωγή. |
search_knowledge | knowledge_base_id, query | R, I | Αναζητά μέσω ανάκτησης παραγωγής. |
Ενσωματώσεις, webhook και απομακρυσμένοι διακομιστές MCP
| Εργαλείο | Κύρια ορίσματα | Σχολιασμοί | Τι κάνει |
|---|---|---|---|
list_integrations | — | R, I | Παραθέτει τις ενσωματώσεις συναρτήσεων HTTP. |
create_integration | display_name, spec συνάρτησης, προαιρετικά πεδία τελικού σημείου | — | Δημιουργεί ένα εργαλείο HTTP. Προσθέστε κεφαλίδες ελέγχου ταυτότητας στον πίνακα ελέγχου. |
test_integration | url, προαιρετικά method/body/timeout, integration_id με header_names, confirmation_token στο δεύτερο αίτημα | D, O | Στέλνει ένα περιορισμένο δοκιμαστικό αίτημα με προστασία από SSRF. Οι αποθηκευμένες τιμές κεφαλίδων συμπληρώνονται από την ενσωμάτωση και αποστέλλονται μόνο στον δικό της κεντρικό υπολογιστή. Τα POST (η προεπιλογή), PUT, PATCH και DELETE έχουν δύο βήματα· το GET εκτελείται αμέσως. |
list_webhook_endpoints | — | R, I | Παραθέτει τα υπογεγραμμένα τελικά σημεία webhook. |
list_webhook_deliveries | προαιρετικό agent_id, προαιρετικό endpoint_id | R, I | Παραθέτει πρόσφατα αποτελέσματα παραδόσεων webhook χωρίς φορτίο δεδομένων. |
create_webhook_endpoint | label, url, προαιρετικά events/status | O | Δημιουργεί ένα υπογεγραμμένο τελικό σημείο webhook. |
copy_webhook_endpoint | endpoint_id, target_agent_id | I | Αντιγράφει το webhook ενός πράκτορα, μαζί με το μυστικό υπογραφής, σε άλλον πράκτορα στον διακομιστή. Μόνο για διαχειριστές. |
test_webhook_endpoint | endpoint_id | O | Στέλνει ένα συνθετικό συμβάν μέσω της κανονικής παράδοσης. |
list_mcp_servers | — | R, I | Παραθέτει απομακρυσμένους διακομιστές που μπορούν να καλούνται από φωνητικούς πράκτορες. |
create_mcp_server | display_name, url | O | Καταχωρεί και συγχρονίζει έναν απομακρυσμένο διακομιστή. Οι διακομιστές που χρειάζονται κεφαλίδες ελέγχου ταυτότητας προστίθενται στον πίνακα ελέγχου. |
sync_mcp_server_tools | server_id | D, O | Ανανεώνει τον κατάλογο εργαλείων ενός απομακρυσμένου διακομιστή. |
Καμπάνιες
| Εργαλείο | Κύρια ορίσματα | Σχολιασμοί | Τι κάνει |
|---|---|---|---|
list_campaigns | — | R, I | Παραθέτει εξερχόμενες καμπάνιες. |
create_campaign | πεδία καμπάνιας | — | Δημιουργεί μια πρόχειρη καμπάνια. |
add_campaign_contacts | campaign_id, contacts | — | Προσθέτει έως 5.000 επαφές JSON. |
campaign_action | campaign_id, action, προαιρετικά consent_to_charge, confirmation_token στο δεύτερο αίτημα | D, O | Εκτελεί start, pause, resume ή stop. Τα start και resume έχουν δύο βήματα· τα pause και stop εκτελούνται άμεσα. |
get_campaign_stats | campaign_id | R, I | Λαμβάνει μετρητές και πρόσφατα αποτελέσματα. |
check_campaign | προαιρετικά campaign_id, contact_phone_number, contact_status | R, I | Εξηγεί γιατί μια καμπάνια δεν πραγματοποιεί κλήσεις: το παράθυρο κλήσεων στη δική της ζώνη ώρας, τις επαφές που πρέπει να κληθούν τώρα και τι εμποδίζει την κλήση. |
Ρυθμίσεις οργανισμού και αποκλεισμένοι καλούντες
| Εργαλείο | Κύρια ορίσματα | Σημειώσεις | Τι κάνει |
|---|---|---|---|
get_org_settings | — | R, I | Διαβάζει τη ζώνη ώρας, το ωράριο λειτουργίας, τους αριθμούς δοκιμών, τις ετικέτες αποτελέσματος κλήσεων, τα ονόματα καταστάσεων και ποιες ειδοποιήσεις είναι απενεργοποιημένες, με updated_at. |
update_org_settings | τροποποιημένες ρυθμίσεις, if_updated_at, confirmation_token όταν ζητηθεί | D, I | Τις αλλάζει (μόνο διαχειριστές). Οι λίστες και τα αντικείμενα αντικαθιστούν την αποθηκευμένη τιμή. Η απενεργοποίηση μιας ειδοποίησης ή η προσθήκη αριθμού δοκιμής γίνεται σε δύο βήματα. Το αποτέλεσμα περιλαμβάνει τις προηγούμενες τιμές για αναίρεση. |
get_account_limits | — | R, I | Λαμβάνει τα όρια της πλατφόρμας με τις τιμές του συγκεκριμένου οργανισμού. |
list_blocked_callers | προαιρετικά number, search | R, I | Εμφανίζει τους αποκλεισμένους αριθμούς καλούντων. |
block_callers | numbers, προαιρετικό note, confirmation_token στο δεύτερο αίτημα | D, I | Απορρίπτει κλήσεις από αυτούς τους αριθμούς προτού απαντήσει οποιοσδήποτε πράκτορας. Σε δύο βήματα, μόνο για διαχειριστές. |
unblock_callers | numbers, confirmation_token στο δεύτερο αίτημα | D, I | Αφαιρεί αριθμούς από τη λίστα αποκλεισμού. Σε δύο βήματα, μόνο για διαχειριστές. |
Τα get_org_settings, update_org_settings και get_account_limits απαιτούν το πεδίο OAuth org:read ή org:write· μια σύνδεση που δημιουργήθηκε πριν υπάρξουν ζητά έγκριση κατά την πρώτη χρήση.
Δυνατότητες, βοήθεια και εισαγωγές
| Εργαλείο | Κύρια ορίσματα | Σημειώσεις | Τι κάνει |
|---|---|---|---|
get_supported_languages | — | R, I | Εμφανίζει τις γλώσσες που μιλούν οι πράκτορες, μαζί με κωδικούς. |
get_agent_capabilities | — | R, I | Αναφέρει τι μπορεί να κάνει ένας πράκτορας σε μια κλήση και ποιες ρυθμίσεις και ενσωματώσεις υπάρχουν. |
escalate_to_human | summary | O | Ζητά βοήθεια από την ομάδα του ThunderPhone. Απαντούν στο ThunderPhone. Για οργανισμούς που ενδέχεται να διαχειρίζονται PHI, αποστέλλεται εκτός ThunderPhone μόνο μια ουδέτερη σημείωση. |
request_feature | title, request, details | O | Υποβάλλει αίτημα λειτουργίας στην ομάδα του ThunderPhone. Έως τρία ανά οργανισμό την ημέρα. |
start_agent_import | platform | R, I | Επιστρέφει τον σύνδεσμο του πίνακα ελέγχου όπου εισάγετε το κλειδί Vapi, Retell, ElevenLabs ή Bland και επιλέγετε πράκτορες. Κανένα εργαλείο δεν δέχεται το κλειδί. |
get_agent_import | προαιρετικό import_id | R, I | Εμφανίζει πρόσφατες εισαγωγές ή την κατάσταση μιας εισαγωγής και τους αντιστοιχισμένους πράκτορες. |
commit_agent_import | import_id, προαιρετικά item_ids | O | Δημιουργεί τους πράκτορες από μια έτοιμη εισαγωγή, στο παρασκήνιο. Μόνο για διαχειριστές. |
Φωνές, χρέωση και τεκμηρίωση
| Εργαλείο | Κύρια ορίσματα | Σημειώσεις | Τι κάνει |
|---|---|---|---|
list_voices | — | R, I | Παραθέτει τις φωνές και τις υποστηριζόμενες γλώσσες. |
preview_voice | voice, language, text | O | Δημιουργεί ένα δείγμα και επιστρέφει ένα υπογεγραμμένο URL. |
list_voice_clones | — | R, I | Παραθέτει προσαρμοσμένους κλώνους φωνής. |
get_billing_summary | — | R, I | Επιστρέφει το υπόλοιπο και τις επίσημες τιμές βαθμίδων· δεν εκτίθενται μεταβολές πληρωμών. |
search_docs | query, προαιρετικό limit | R, I, O | Αναζητά στο ευρετήριο της δημόσιας τεκμηρίωσης. |
get_doc_page | path | R, I, O | Ανακτά μία δημόσια σελίδα τεκμηρίωσης Markdown. |
Τα αποτελέσματα σχετικά με έναν πράκτορα, μια κλήση, έναν αριθμό, μια καμπάνια ή μια ρύθμιση περιλαμβάνουν το web_url, την αντίστοιχη σελίδα του πίνακα ελέγχου, ώστε να μπορείτε να την ανοίξετε στο ThunderPhone ή να συνεχίσετε εκεί με το Zeus.
Όλα τα εργαλεία προϊόντος χρησιμοποιούν τις ίδιες διαδρομές κώδικα REST με το δημόσιο API. Η επικύρωση REST, η οριοθέτηση οργανισμού, οι ρόλοι, η έγκριση χρέωσης, τα όρια, η επιβεβαίωση TCPA, η ασφάλεια παρόχων και η συμπεριφορά ελέγχου εφαρμόζονται επομένως χωρίς αλλαγές.
Επεξεργασία μιας προτροπής επιτόπου
Το update_agent μπορεί να αλλάξει μέρος της πρόχειρης προτροπής χωρίς να στείλει ολόκληρο το κείμενο ξανά. Το prompt_edits είναι μια ταξινομημένη λίστα ζευγών εύρεσης και αντικατάστασης, στην ίδια μορφή που επιστρέφουν τα review_prompt και refactor_prompt:
{
"agent_id": 123,
"expected_prompt_sha256": "9c1f…",
"prompt_edits": [
{
"find": "Ask for their name and their phone number, then tell them we will call back.",
"replace": "Tell them we will call back, then ask for their name. Once they answer, ask for their phone number."
}
]
}Ο διακομιστής εφαρμόζει τις επεξεργασίες με τη σειρά στην τρέχουσα πρόχειρη προτροπή του πράκτορα (την αναπτυγμένη προτροπή όταν δεν υπάρχει πρόχειρο) και γράφει το αποτέλεσμα στο πρόχειρο μέσω της ίδιας διαδρομής με ένα update_agent για ολόκληρη προτροπή. Κάθε find πρέπει να εμφανίζεται ακριβώς μία φορά στην προτροπή όπως είναι τη στιγμή που έρχεται η σειρά αυτής της επεξεργασίας. Αν δεν εμφανίζεται, δεν γράφεται τίποτα και το σφάλμα αναφέρει την επεξεργασία:
| Κωδικός | Σημασία | Τι να κάνετε |
|---|---|---|
prompt_edit_not_found | Το κείμενο find δεν βρίσκεται στην τρέχουσα πρόχειρη προτροπή. Το edit_index υποδεικνύει ποια επεξεργασία είναι. | Διαβάστε ξανά τον πράκτορα και αντιγράψτε το απόσπασμα ακριβώς. |
prompt_edit_ambiguous | Το κείμενο find εμφανίζεται περισσότερες από μία φορές. Το occurrences υποδεικνύει πόσες φορές. | Συμπεριλάβετε περισσότερο από το περιβάλλον κείμενο. |
stale_prompt | Το expected_prompt_sha256 δεν είναι το SHA-256 της τρέχουσας πρόχειρης προτροπής: άλλαξε αφού τη διαβάσατε. | Διαβάστε ξανά τον πράκτορα, ξαναγράψτε την αλλαγή με βάση το τρέχον κείμενο και στείλτε το SHA-256 του. |
conflict | Μια άλλη εγγραφή ολοκληρώθηκε μεταξύ της ανάγνωσης του πρόχειρου από τον διακομιστή και της εγγραφής του. | Δοκιμάστε ξανά· το πρόχειρο δεν άλλαξε από αυτή την κλήση. |
Το expected_prompt_sha256 είναι προαιρετικό και προστατεύει επίσης μια εγγραφή ολόκληρης προτροπής. Χρησιμοποιήστε το prompt_sha256 από το review_prompt ή το source_prompt_sha256 από το refactor_prompt. Κάθε κλήση που αλλάζει την προτροπή επιστρέφει prompt_sha256 για το νέο κείμενο, previous_prompt_sha256 όταν ο διακομιστής διάβασε πρώτα το πρόχειρο, και ένα next_step που προτείνει review_prompt με το previous_prompt ορισμένο στο κείμενο πριν από την αλλαγή. Το REST API δέχεται μόνο ολόκληρη την προτροπή: PATCH /v1/agents/{agent_id} με prompt και if_updated_at.
Επιβεβαίωση καταστροφικών ενεργειών
Τα εργαλεία με σήμανση D αλλάζουν ή αφαιρούν κάτι ή ξεκινούν κλήσεις προς πραγματικούς ανθρώπους. Όσα δεν μπορούν να αναιρεθούν απαιτούν δύο αιτήματα. Το πρώτο αίτημα δεν αλλάζει τίποτα και επιστρέφει:
{
"status": "confirmation_required",
"action": "Delete agent",
"target": { "id": 195, "name": "Front Desk Receptionist" },
"confirmation_token": "…",
"expires_in_seconds": 600,
"next_step": "…"
}Ο βοηθός δείχνει στον χρήστη τι επηρεάζεται και ζητά επιβεβαίωση. Στη συνέχεια επαναλαμβάνει το αίτημα με τα ίδια ορίσματα και το confirmation_token. Ένα διακριτικό ισχύει για 10 λεπτά, λειτουργεί μία φορά (ακόμη και αν η κλήση αποτύχει) και καλύπτει έναν οργανισμό, ένα άτομο, ένα εργαλείο και ένα ακριβές σύνολο ορισμάτων, επομένως η διαγραφή τριών πρακτόρων απαιτεί τρεις επιβεβαιώσεις. Το campaign_action με pause ή stop παραλείπει αυτό το βήμα, ώστε μια ενεργή καμπάνια να μπορεί πάντα να διακοπεί αμέσως, όπως και το test_integration με GET. Ορισμένα εργαλεία D εκτελούνται με ένα αίτημα, επειδή το D επισημαίνει την ενέργειά τους και όχι μια επιβεβαίωση από την πλευρά του διακομιστή: το update_agent αντικαθιστά ό,τι είχε το πρόχειρο (discard_agent_draft το επαναφέρει), το deploy_agent αντικαθιστά την ενεργή διαμόρφωση, το update_phone_number αναδρομολογεί ενεργές κλήσεις, το sync_mcp_server_tools αντικαθιστά τον κατάλογο εργαλείων ενός απομακρυσμένου διακομιστή, το import_voip_numbers επανασυνδέει αριθμούς με τον πάροχό σας, τα run_agent_tests και run_simulation μπορούν να καταναλώσουν πίστωση, τα send_sms και place_call επικοινωνούν με πραγματικό άτομο (το place_call διατηρεί τη δική του επιβεβαίωση συγκατάθεσης) και το provision_phone_number αγοράζει έναν αριθμό. Το test_my_agent καταναλώνει πίστωση δοκιμών και απαιτεί consent_to_charge. Το run_replays καταναλώνει επίσης χρήματα· η εκτίμηση του dry_run και το όριο max_cost_cents λειτουργούν αντί για την επιβεβαίωση. Ο πελάτης MCP σας ενδέχεται παρ’ όλα αυτά να σας ζητήσει να τα εγκρίνετε.
Ορισμένες αλλαγές που μπορούν να αναιρεθούν εξακολουθούν να απαιτούν επιβεβαίωση: τα block_callers, unblock_callers και save_voip_setup πάντα, το update_org_settings όταν απενεργοποιεί μια ειδοποίηση ή προσθέτει έναν αριθμό δοκιμής και το update_agent όταν τα attention_reasons του απενεργοποιούν μία από τις ειδοποιήσεις του πράκτορα. Το next_step τους ζητά να επιβεβαιώσετε την ακριβή αλλαγή αντί να προειδοποιεί ότι δεν μπορεί να αναιρεθεί.
Αρχικές προτροπές
Το prompts/list παρέχει δώδεκα επαναχρησιμοποιήσιμες ροές εργασίας:
create_inbound_receptionistrun_agent_testsbuy_and_attach_numberreview_low_grade_callsadd_url_to_agent_knowledgeimprove_agent_from_callscheck_change_before_deploytest_my_agentdiagnose_phone_numberwhy_campaign_not_callingcall_reportimport_agents
Χρησιμοποιήστε το prompts/get με το αναφερόμενο όνομα προτροπής και τα δηλωμένα ορίσματά του για να λάβετε ένα έτοιμο προς εκτέλεση μήνυμα χρήστη.
Πόροι
Το resources/list εκθέτει δημόσιες, αποθηκευμένες στην προσωρινή μνήμη αναφορές:
| URI | Περιεχόμενο |
|---|---|
thunderphone://docs/llms.txt | Ευρετήριο δημόσιας τεκμηρίωσης. |
thunderphone://docs/quickstart | Markdown γρήγορης εκκίνησης. |
thunderphone://pricing | Τρέχον Markdown δημόσιας τιμολόγησης. |
thunderphone://guides/prompt-style | Ο οδηγός ύφους προτροπών για φωνητικούς πράκτορες, με τον οποίο συγκρίνει το review_prompt. Τα αναγνωριστικά οδηγιών του (P1, W2 και ούτω καθεξής) είναι εκείνα που αναφέρουν τα ευρήματα. |
thunderphone://guides/working-with-thunderphone | Πώς πρέπει να εργάζεται ένας βοηθός με αυτά τα εργαλεία: μικροί κύκλοι στο προσχέδιο, έλεγχος πριν από κάθε ανάπτυξη, η συγκατάθεση του χρήστη για οτιδήποτε είναι ενεργό ή χρεώσιμο και να μη ζητά ποτέ μυστικά. |
Διαβάστε έναν πόρο με το resources/read. Οι δημόσιες ανακτήσεις χρησιμοποιούν σύντομο χρονικό όριο, όριο 2 MiB και δεκάλεπτη προσωρινή μνήμη εντός διεργασίας.
Πρωτόκολλο και σφάλματα
Ο διακομιστής υποστηρίζει τις εκδόσεις πρωτοκόλλου 2025-06-18 και 2025-03-26· επιστρέφει ως ηχώ μια υποστηριζόμενη έκδοση πελάτη και διαφορετικά επιλέγει την 2025-06-18. Υλοποιεί τα initialize, ping, εργαλεία, προτροπές, πόρους και ειδοποιήσεις. Οι ειδοποιήσεις επιστρέφουν 202 Accepted. Αυτός ο διακομιστής χωρίς κατάσταση δεν εκθέτει ακροατή SSE ή διαγραφή συνεδρίας, επομένως τα GET και DELETE επιστρέφουν 405 Method Not Allowed με Allow: POST.
Οι αποτυχίες εργαλείων παραμένουν επιτυχημένες αποκρίσεις JSON-RPC με isError: true. Το κείμενό τους περιέχει μια σύντομη πρόταση ακολουθούμενη από ένα μπλοκ JSON:
{
"code": "insufficient_balance",
"detail": "There is not enough prepaid balance.",
"next_step": "Call get_billing_summary, add funds in Organization > Billing, then retry."
}Το διακριτό πρόθεμα outbound_tcpa_confirmation_required: διατηρείται για το place_call. Άγνωστες μέθοδοι JSON-RPC επιστρέφουν -32601 σε απόκριση HTTP 200. Οι παρτίδες JSON-RPC δεν υποστηρίζονται από το MCP 2025-06-18 και επιστρέφουν ένα καθαρό σφάλμα μη έγκυρου αιτήματος -32600.