Το ThunderPhone v3 είναι πλέον διαθέσιμο.Ξεκινήστε μόνοι σας, από 2¢/λεπτό.Διαβάστε την ανακοίνωση

Connect tools & data

Χρησιμοποιήστε το 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 με τον πάροχο ενός βοηθού που καλύπτει τον χώρο εργασίας που χρησιμοποιείτε:

  1. Ένας διαχειριστής οργανισμού ανοίγει το Οργανισμός → Γενικά → Πρόσβαση βοηθού AI στο ThunderPhone και επιβεβαιώνει αυτή την κάλυψη.
  2. Συνδέστε τον βοηθό ως προσαρμοσμένο σύνδεσμο με αυτήν τη διεύθυνση 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 (ιστός, υπολογιστής και κινητό)

  1. Ανοίξτε Προσαρμογή → Συνδέσεις (Ρυθμίσεις → Συνδέσεις σε παλαιότερες εκδόσεις). Αν το ThunderPhone εμφανίζεται στον κατάλογο συνδέσεων, επιλέξτε το. Διαφορετικά, επιλέξτε Προσθήκη προσαρμοσμένης σύνδεσης, ονομάστε τη ThunderPhone και εισαγάγετε https://api.thunderphone.com/v1/mcp.
  2. Επιλέξτε Σύνδεση, συνδεθείτε στο ThunderPhone, επιλέξτε τον οργανισμό και εγκρίνετε τα δικαιώματα.
  3. Σε μια συνομιλία, ενεργοποιήστε το 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

  1. Αν το ThunderPhone εμφανίζεται στον κατάλογο εφαρμογών του ChatGPT, επιλέξτε το και συνδεθείτε.
  2. Διαφορετικά, ανοίξτε Ρυθμίσεις → Εφαρμογές και συνδέσεις → Σύνθετες ρυθμίσεις, ενεργοποιήστε τη Λειτουργία προγραμματιστή και δημιουργήστε μια σύνδεση με τη διεύθυνση URL https://api.thunderphone.com/v1/mcp και έλεγχο ταυτότητας OAuth.
  3. Συνδεθείτε στο 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_agentagent_idR, IΑνακτά έναν πράκτορα.
create_agentδιαμόρφωση πράκτορα—Δημιουργεί έναν πράκτορα. Δέχεται τις ίδιες ρυθμίσεις με το update_agent, συμπεριλαμβανομένων των steps, handoffs, intro_clip και intro_ring_count.
update_agentagent_id, τροποποιημένα πεδία, προαιρετικά prompt_edits, expected_prompt_sha256DΚαταχωρίζει πεδία στο πρόχειρο του πράκτορα, αντικαθιστώντας όσα περιείχε το πρόχειρο. Εκτελείται χωρίς βήμα επιβεβαίωσης: ο αναπτυγμένος πράκτορας παραμένει αμετάβλητος έως το deploy_agent, ενώ το discard_agent_draft επαναφέρει το πρόχειρο. Μπορείτε επίσης να ορίσετε τα max_hold_seconds, system_tool_settings και words. Για να αλλάξετε μέρος του prompt, στείλτε prompt_edits (δείτε την Επεξεργασία ενός prompt επιτόπου).
deploy_agentagent_id, προαιρετικά if_updated_atD, IΠροωθεί το πρόχειρο στην παραγωγή.
discard_agent_draftagent_id, προαιρετικά if_updated_at, confirmation_token στο δεύτερο αίτημαD, IΑπορρίπτει τις σταδιακά καταχωρισμένες αλλαγές. Δύο βήματα, δείτε την Επιβεβαίωση καταστροφικών ενεργειών.
duplicate_agentagent_id, προαιρετικά name—Αντιγράφει έναν πράκτορα εντός του οργανισμού.
delete_agentagent_id, confirmation_token στο δεύτερο αίτημαD, IΔιαγράφει οριστικά έναν πράκτορα. Δύο βήματα.
list_agent_versionsagent_idR, IΠαραθέτει τις εκδόσεις διαμόρφωσης που έχουν αναπτυχθεί.
list_prompt_revisionsagent_id, προαιρετικά source, limit, offsetR, IΠαραθέτει κάθε αλλαγή στο κείμενο prompt του πράκτορα, συμπεριλαμβανομένων των πρόχειρων, καθεμία με διαφορά σε σύγκριση με την αναθεώρηση που αντικατέστησε. Διαθέσιμο όταν η εργαλειοθήκη επανάληψης πρακτόρων είναι διαθέσιμη στη σύνδεσή σας (δείτε παρακάτω).
review_promptagent_id, προαιρετικά prompt, previous_prompt, quote_id, max_cost_cents—Ελέγχει το πρόχειρο prompt (ή το κείμενο που στέλνετε) σε σχέση με τον οδηγό ύφους prompt. Κάθε εύρημα παραθέτει το απόσπασμα, ονομάζει την οδηγία και προσφέρει μια επεξεργασία εύρεσης και αντικατάστασης· το αποτέλεσμα παραθέτει επίσης τις συμπεριφορές που ζητά το prompt, με σταθερά αναγνωριστικά, αν απαιτείται αναδιαμόρφωση και, για το prompt του ίδιου του πράκτορα, αν οι δοκιμαστικές συνομιλίες του χρειάζονται ανανέωση. Δεν αλλάζει τίποτα στον πράκτορα· ο κατάλογος αποθηκεύεται με την αναθεώρηση του prompt του. Είναι επί πληρωμή, επομένως δεν επισημαίνεται ως μόνο για ανάγνωση: λάβετε πρώτα προσφορά με dry_run, έπειτα εκτελέστε το ξανά χωρίς dry_run, με το quote_id που επιστρέφει και το max_cost_cents. Αυτές οι επί πληρωμή εκτελέσεις υπολογίζονται πλέον στο ίδιο όριο εργαλειοθήκης του οργανισμού με τις άλλες εκτελέσεις εργαλειοθήκης. Διαθέσιμο όταν η εργαλειοθήκη επανάληψης πρακτόρων είναι διαθέσιμη στη σύνδεσή σας (δείτε παρακάτω).
refactor_promptagent_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_instructionname, content—Δημιουργεί μια ασύνδετη επαναχρησιμοποιήσιμη οδηγία. Μόνο για διαχειριστές.

Αριθμοί τηλεφώνου και πάροχοι

ΕργαλείοΚύρια ορίσματαΣημειώσειςΤι κάνει
list_phone_numbers—R, IΠαραθέτει τους αριθμούς και τη δρομολόγηση του οργανισμού.
get_phone_number_limits—R, IΛαμβάνει τη χρήση και τα όρια των διαχειριζόμενων αριθμών.
provision_phone_numberπροαιρετικά area_code, city, state, idempotency_keyD, OΑγοράζει έναν εισερχόμενο αριθμό που διαχειρίζεται το ThunderPhone.
list_voip_connections—R, IΠαραθέτει τους συνδεδεμένους παρόχους του πελάτη.
search_voip_numbersconnection_id, country, type, προαιρετικά area_codeR, I, OΑναζητά στο απόθεμα του παρόχου.
import_voip_numbersconnection_id, numbersD, OΕισάγει αριθμούς που ανήκουν ήδη στον πάροχο.
update_phone_numberphone_number_id, πεδία δρομολόγησης/ετικέτας/webhookDΕνημερώνει τη δρομολόγηση αριθμού, συμπεριλαμβανομένης της ανάθεσης πράκτορα.
delete_phone_numberphone_number_id, confirm, προαιρετικά release_at_provider, confirmation_token στο δεύτερο αίτημαD, I, OΑποδεσμεύει έναν αριθμό. Δύο βήματα.
get_voip_setup_sessionπροαιρετικά session_idR, IΔιαβάζει μια καθοδηγούμενη ρύθμιση παρόχου (κατάσταση, λίστα ελέγχου, την ερώτηση που αναμένει) ή παραθέτει ανοιχτές ρυθμίσεις. Μια ρύθμιση ξεκινά στον πίνακα ελέγχου επειδή απαιτεί τον κωδικό πρόσβασης του παρόχου. Μόνο για διαχειριστές.
answer_voip_setup_questionsession_id, question_id, answerOΜεταβιβάζει την απάντηση του χρήστη στη ρύθμιση. Οι κωδικοί πρόσβασης, η συγκατάθεση για δοκιμαστική κλήση, η διεύθυνση διακομιστή, το όνομα χρήστη και η άδεια στο ThunderPhone να συνδεθεί στον λογαριασμό παρόχου απαντώνται μόνο στον οδηγό ρύθμισης· για αυτά επιστρέφει τον σύνδεσμο του οδηγού και δεν στέλνει τίποτα.
save_voip_setupsession_id, προαιρετικά name, confirmation_token στο δεύτερο αίτημαD, I, OΑποθηκεύει ένα συνδεδεμένο πρόχειρο σύνδεσης ώστε να μπορεί να χρησιμοποιηθεί. Δύο βήματα.
check_phone_numberphone_number ή phone_number_idR, I, OΔιαγιγνώσκει έναν από τους αριθμούς του οργανισμού βάσει στοιχείων: δρομολόγηση, σύνδεση, επαλήθευση, πρόσφατες κλήσεις παρόχου και δοκιμαστικές κλήσεις, και πού τον στέλνει ο πάροχος.

SMS

ΕργαλείοΚύρια ορίσματαΕπισημάνσειςΤι κάνει
send_smsfrom_number, to, body, idempotency_keyD, I, OΣτέλνει ένα SMS απλού κειμένου μέσω ενός συνδεδεμένου αριθμού Twilio ή Telnyx.

Κλήσεις

ΕργαλείοΚύρια ορίσματαΣημειώσειςΤι κάνει
list_callsπροαιρετικά φίλτρα, limit, offsetR, IΕμφανίζει κλήσεις με τα φίλτρα ιστορικού κλήσεων REST, συμπεριλαμβανομένου του exclude_test_calls.
get_callcall_idR, IΛαμβάνει την κατάσταση και τα μεταδεδομένα της κλήσης.
get_call_transcriptcall_id, προαιρετικό liveR, IΛαμβάνει την απομαγνητοφώνηση της κλήσης.
get_call_audio_urlcall_id, προαιρετικό downloadR, I, OΕπιστρέφει ένα υπογεγραμμένο URL ήχου· δεν μεταδίδει ποτέ ήχο μέσω MCP.
get_call_gradecall_idR, IΛαμβάνει την πιο πρόσφατη αξιολόγηση κλήσης.
place_callagent_id, from_number, to_numberD, OΠραγματοποιεί μία μη ιδιοσυγκρασιακή εξερχόμενη κλήση.
export_callsφίλτρα κλήσεων, export_formatR, IΕξάγει έως το όριο του τελικού σημείου REST ως JSON ή CSV.
get_call_analyticsπροαιρετικά since_days, agent_idR, IΣυγκεντρώνει πραγματικές κλήσεις ανά κατάσταση, κατεύθυνση, αποτέλεσμα, αξιολόγηση και ζήτημα, με τις δοκιμαστικές κλήσεις να καταμετρώνται ξεχωριστά.
get_call_insightscall_ids (έως 10)R, IΛαμβάνει ταυτόχρονα την αξιολόγηση, το αποτέλεσμα, τη σύνοψη και τα εντοπισμένα ζητήματα πολλών κλήσεων.

Δοκιμές και επικύρωση

ΕργαλείοΚύρια ορίσματαΣημειώσειςΤι κάνει
list_test_scenariosagent_idR, IΠαραθέτει σενάρια δοκιμών.
create_test_scenarioagent_id, title, scenario_prompt, προαιρετικές συνθήκες—Δημιουργεί ένα σενάριο.
generate_test_scenariosagent_id, προαιρετικά count, include_edge_cases, localeOΔημιουργεί σενάρια από την προτροπή του πράκτορα.
run_agent_testsagent_id, channel, consent_to_charge, προαιρετική επιλογή/μήτραD, OΕκτελεί σενάρια μέσω ιστού ή τηλεφωνίας.
get_test_runagent_id, batch_idR, IΛαμβάνει την κατάσταση παρτίδας και τα αποτελέσματα ανά σενάριο.
test_my_agentagent_id, consent_to_charge, προαιρετικά scenario_ids, count, wait_secondsD, OΔοκιμάζει έναν πράκτορα με μία κλήση: εκτελεί τα αποθηκευμένα σενάριά του (δημιουργώντας ορισμένα όταν δεν έχει) και περιμένει έως ένα λεπτό για τις αξιολογήσεις ή επιστρέφει το batch_id για το get_test_run. Χρεώνεται όπως το run_agent_tests.
test_in_textagent_id, callers (1 έως 3 περιγραφές), προαιρετικά version, directionOΔοκιμή ελεύθερου κειμένου: προσομοιωμένοι καλούντες μιλούν με το προσχέδιο του πράκτορα (ή την ενεργή έκδοση) σε κείμενο μέσω της πραγματικής διοχέτευσης και τα απομαγνητοφωνημένα κείμενα επιστρέφουν σε περίπου ένα λεπτό. Τα αποτελέσματα του εργαλείου είναι προσομοιωμένα.
run_simulationagent_id, consent_to_charge, προαιρετικά scenario_prompt, direction, languageD, OΞεκινά μία προσομοιωμένη τηλεφωνική κλήση μεταξύ ενός καλούντος AI και του προσχεδίου του πράκτορα, ώστε ένα άτομο να μπορεί να ακούσει μια αλλαγή. Επιστρέφει την εκτέλεση με in_progress. Καταγράφεται όταν ο πράκτορας καταγράφει κλήσεις και αξιολογείται αφού ολοκληρωθεί. Χρεώνεται όπως μια δοκιμαστική κλήση, πρώτα από τον δωρεάν προϋπολογισμό δοκιμών.
get_simulationsimulation_idR, IΛαμβάνει την κατάσταση μιας προσομοιωμένης κλήσης και, μόλις ολοκληρωθεί, όσα παρήγαγε: ένα URL εγγραφής περιορισμένης διάρκειας και το απομαγνητοφωνημένο κείμενο όταν ο πράκτορας καταγράφει κλήσεις, καθώς και τη βαθμολογία μόλις ολοκληρωθεί η αξιολόγηση (null προηγουμένως).
list_validation_runsagent_idR, IΠαραθέτει πρόσφατες εκτελέσεις επικύρωσης προσχεδίων.
get_validation_statusagent_idR, IΛαμβάνει την πιο πρόσφατη κατάσταση επικύρωσης και την αντιστοίχιση του προσχεδίου.
list_conversationsagent_id, προαιρετικά split, sourceR, IΠαραθέτει τις συνομιλίες έναντι των οποίων δοκιμάζεται ο πράκτορας. Απαιτεί την εργαλειοθήκη επανάληψης πράκτορα.
get_conversationconversation_idR, IΛαμβάνει μία συνομιλία δοκιμής με τις τρέχουσες εναλλαγές της. Απαιτεί την εργαλειοθήκη επανάληψης πράκτορα.
get_conversation_revisionsconversation_id, προαιρετικά limit, offsetR, IΠαραθέτει κάθε αναθεώρηση μιας συνομιλίας δοκιμής: πώς και γιατί άλλαξε (ανανεώθηκε για αλλαγή προτροπής, αποκαταστάθηκε από προηγούμενη αναθεώρηση), τις συμπεριφορές που προστέθηκαν, αφαιρέθηκαν και άλλαξαν, τα παραδείγματα που μετακινήθηκαν ή αποσύρθηκαν και τη διαφορά γραμμών. Απαιτεί την εργαλειοθήκη επανάληψης πράκτορα.
generate_conversationsagent_id, προαιρετικά count, styleOΣυντάσσει προσομοιωμένες συνομιλίες δοκιμής έναντι του προσχεδίου του πράκτορα και μετατρέπει τις δυσκολότερες στιγμές τους σε παραδείγματα επικύρωσης με κλειδιά απαντήσεων. Ζητήστε πρώτα προσφορά με dry_run; μια πραγματική εκτέλεση χρειάζεται το quote_id και το max_cost_cents. Απαιτεί την εργαλειοθήκη επανάληψης πράκτορα.
import_conversationsagent_id, προαιρετικά since_days, max_callsOΜετατρέπει τις πρόσφατες κλήσεις του πράκτορα σε συνομιλίες δοκιμής (το πολύ δύο ανά καλούντα, με παράλειψη κλήσεων χωρίς καταγραφή) και τις δυσκολότερες στιγμές τους σε παραδείγματα. Ζητήστε πρώτα προσφορά με dry_run; μια πραγματική εκτέλεση χρειάζεται το quote_id και το max_cost_cents. Απαιτεί την εργαλειοθήκη επανάληψης πράκτορα.
refresh_conversationsagent_id, προαιρετικά conversation_ids, from_prompt_revision_idOΕνημερώνει τις συνομιλίες δοκιμής του πράκτορα σύμφωνα με την τρέχουσα προτροπή του μετά την προσθήκη, αφαίρεση ή αλλαγή συμπεριφορών: επαναστοχεύει, αποκαθιστά μια προηγούμενη αναθεώρηση (συμπεριλαμβανομένου πραγματικού ήχου) ή ξαναγράφει τις παρωχημένες εναλλαγές και αποσύρει παραδείγματα των οποίων η εναλλαγή του καλούντος δεν υπάρχει πλέον. Ζητήστε πρώτα προσφορά με dry_run; μια πραγματική εκτέλεση χρειάζεται το quote_id και το max_cost_cents. Απαιτεί την εργαλειοθήκη επανάληψης πράκτορα.
get_conversation_jobjob_idR, IΛαμβάνει μια εργασία δημιουργίας, εισαγωγής ή ανανέωσης: την κατάσταση, το κόστος έως τώρα σε σχέση με το όριό της και όσα έγραψε ή ανανέωσε. Απαιτεί την εργαλειοθήκη επανάληψης πράκτορα.
run_replaysagent_id, προαιρετικά overrides, split, engine, sample_size, sample_seed, max_cost_cents, quote_id, dry_runD, 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_configsagent_id, configs (2 έως 4, η πρώτη είναι η γραμμή βάσης), προαιρετικά sample_size, sample_seed, max_cost_cents, quote_id, dry_runOΕπαναπαράγει τα ίδια παραδείγματα με κάθε διαμόρφωση και αναφέρει ποσοστό επιτυχίας, παραδείγματα που διορθώθηκαν και χάλασαν σε σχέση με τη γραμμή βάσης, καθυστέρηση έως τον πρώτο ήχο, πόσο συχνά ο καλών περίμενε επιβεβαίωση, ήχους αναμονής ή σιωπή και κόστος ανά εναλλαγή, ανά μηχανή. Ζητήστε προσφορά με dry_run όπως στο run_replays. Μόνο για τον διαχωρισμό ανάπτυξης: στον διαχωρισμό δοκιμών απορρίπτεται (comparison_dev_only)· συγκρίνετε στην ανάπτυξη και, στη συνέχεια, μετρήστε την επιλογή με run_replays. Απαιτεί την εργαλειοθήκη επανάληψης πράκτορα.
get_replay_runrun_id, προαιρετικά include_traceR, IΛαμβάνει τα σύνολα, τις ανατροπές και τα αποτελέσματα ανά παράδειγμα μιας εκτέλεσης επανάληψης, καθώς και την ομάδα σύγκρισής της. Οι ακριβείς επαναλήψεις που χρειάστηκαν περισσότερο από τον προϋπολογισμό τους μετρώνται ξεχωριστά (budget_exhausted), εκτός του ποσοστού επιτυχίας. Απαιτεί την εργαλειοθήκη επανάληψης πράκτορα.
create_talk_linkagent_id, προαιρετικά variant_id, language, expires_in_minutesOΔημιουργεί έναν σύνδεσμο μίας χρήσης που ένα άτομο ανοίγει σε πρόγραμμα περιήγησης για να μιλήσει με το τρέχον προσχέδιο του πράκτορα, όπως το κουμπί «Μιλήστε» του πίνακα ελέγχου. Ο σύνδεσμος λήγει έπειτα από 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_basename, προαιρετικό description—Δημιουργεί μια βάση γνώσης.
add_knowledge_documentknowledge_base_id, name, content—Προσθέτει κείμενο ή Markdown.
import_knowledge_urlurl, προαιρετικό nameOΠροσθέτει μια δημόσια σελίδα σε ουρά για ασφαλή εισαγωγή.
search_knowledgeknowledge_base_id, queryR, IΑναζητά μέσω ανάκτησης παραγωγής.

Ενσωματώσεις, webhook και απομακρυσμένοι διακομιστές MCP

ΕργαλείοΚύρια ορίσματαΣχολιασμοίΤι κάνει
list_integrations—R, IΠαραθέτει τις ενσωματώσεις συναρτήσεων HTTP.
create_integrationdisplay_name, spec συνάρτησης, προαιρετικά πεδία τελικού σημείου—Δημιουργεί ένα εργαλείο HTTP. Προσθέστε κεφαλίδες ελέγχου ταυτότητας στον πίνακα ελέγχου.
test_integrationurl, προαιρετικά 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_idR, IΠαραθέτει πρόσφατα αποτελέσματα παραδόσεων webhook χωρίς φορτίο δεδομένων.
create_webhook_endpointlabel, url, προαιρετικά events/statusOΔημιουργεί ένα υπογεγραμμένο τελικό σημείο webhook.
copy_webhook_endpointendpoint_id, target_agent_idIΑντιγράφει το webhook ενός πράκτορα, μαζί με το μυστικό υπογραφής, σε άλλον πράκτορα στον διακομιστή. Μόνο για διαχειριστές.
test_webhook_endpointendpoint_idOΣτέλνει ένα συνθετικό συμβάν μέσω της κανονικής παράδοσης.
list_mcp_servers—R, IΠαραθέτει απομακρυσμένους διακομιστές που μπορούν να καλούνται από φωνητικούς πράκτορες.
create_mcp_serverdisplay_name, urlOΚαταχωρεί και συγχρονίζει έναν απομακρυσμένο διακομιστή. Οι διακομιστές που χρειάζονται κεφαλίδες ελέγχου ταυτότητας προστίθενται στον πίνακα ελέγχου.
sync_mcp_server_toolsserver_idD, OΑνανεώνει τον κατάλογο εργαλείων ενός απομακρυσμένου διακομιστή.

Καμπάνιες

ΕργαλείοΚύρια ορίσματαΣχολιασμοίΤι κάνει
list_campaigns—R, IΠαραθέτει εξερχόμενες καμπάνιες.
create_campaignπεδία καμπάνιας—Δημιουργεί μια πρόχειρη καμπάνια.
add_campaign_contactscampaign_id, contacts—Προσθέτει έως 5.000 επαφές JSON.
campaign_actioncampaign_id, action, προαιρετικά consent_to_charge, confirmation_token στο δεύτερο αίτημαD, OΕκτελεί start, pause, resume ή stop. Τα start και resume έχουν δύο βήματα· τα pause και stop εκτελούνται άμεσα.
get_campaign_statscampaign_idR, IΛαμβάνει μετρητές και πρόσφατα αποτελέσματα.
check_campaignπροαιρετικά campaign_id, contact_phone_number, contact_statusR, 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, searchR, IΕμφανίζει τους αποκλεισμένους αριθμούς καλούντων.
block_callersnumbers, προαιρετικό note, confirmation_token στο δεύτερο αίτημαD, IΑπορρίπτει κλήσεις από αυτούς τους αριθμούς προτού απαντήσει οποιοσδήποτε πράκτορας. Σε δύο βήματα, μόνο για διαχειριστές.
unblock_callersnumbers, 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_humansummaryOΖητά βοήθεια από την ομάδα του ThunderPhone. Απαντούν στο ThunderPhone. Για οργανισμούς που ενδέχεται να διαχειρίζονται PHI, αποστέλλεται εκτός ThunderPhone μόνο μια ουδέτερη σημείωση.
request_featuretitle, request, detailsOΥποβάλλει αίτημα λειτουργίας στην ομάδα του ThunderPhone. Έως τρία ανά οργανισμό την ημέρα.
start_agent_importplatformR, IΕπιστρέφει τον σύνδεσμο του πίνακα ελέγχου όπου εισάγετε το κλειδί Vapi, Retell, ElevenLabs ή Bland και επιλέγετε πράκτορες. Κανένα εργαλείο δεν δέχεται το κλειδί.
get_agent_importπροαιρετικό import_idR, IΕμφανίζει πρόσφατες εισαγωγές ή την κατάσταση μιας εισαγωγής και τους αντιστοιχισμένους πράκτορες.
commit_agent_importimport_id, προαιρετικά item_idsOΔημιουργεί τους πράκτορες από μια έτοιμη εισαγωγή, στο παρασκήνιο. Μόνο για διαχειριστές.

Φωνές, χρέωση και τεκμηρίωση

ΕργαλείοΚύρια ορίσματαΣημειώσειςΤι κάνει
list_voices—R, IΠαραθέτει τις φωνές και τις υποστηριζόμενες γλώσσες.
preview_voicevoice, language, textOΔημιουργεί ένα δείγμα και επιστρέφει ένα υπογεγραμμένο URL.
list_voice_clones—R, IΠαραθέτει προσαρμοσμένους κλώνους φωνής.
get_billing_summary—R, IΕπιστρέφει το υπόλοιπο και τις επίσημες τιμές βαθμίδων· δεν εκτίθενται μεταβολές πληρωμών.
search_docsquery, προαιρετικό limitR, I, OΑναζητά στο ευρετήριο της δημόσιας τεκμηρίωσης.
get_doc_pagepathR, 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_receptionist
  • run_agent_tests
  • buy_and_attach_number
  • review_low_grade_calls
  • add_url_to_agent_knowledge
  • improve_agent_from_calls
  • check_change_before_deploy
  • test_my_agent
  • diagnose_phone_number
  • why_campaign_not_calling
  • call_report
  • import_agents

Χρησιμοποιήστε το prompts/get με το αναφερόμενο όνομα προτροπής και τα δηλωμένα ορίσματά του για να λάβετε ένα έτοιμο προς εκτέλεση μήνυμα χρήστη.

Πόροι

Το resources/list εκθέτει δημόσιες, αποθηκευμένες στην προσωρινή μνήμη αναφορές:

URIΠεριεχόμενο
thunderphone://docs/llms.txtΕυρετήριο δημόσιας τεκμηρίωσης.
thunderphone://docs/quickstartMarkdown γρήγορης εκκίνησης.
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.