Open in
Αναπτύξτε με Claude Code, Codex ή Cursor
Εγκαταστήστε τα Agent Skills του ThunderPhone, συνδέστε τον διακομιστή MCP του ThunderPhone και δώστε σε έναν πράκτορα προγραμματισμού την τρέχουσα τεκμηρίωση του προϊόντος.
Το ThunderPhone παρέχει τρία επίπεδα για πράκτορες προγραμματισμού:
| Επίπεδο | Τι προσφέρει στον πράκτορα |
|---|---|
| Δεξιότητες πρακτόρων | Στοχευμένες διαδικασίες για πράκτορες, προτροπές, αριθμούς, κλήσεις, εργαλεία, webhooks, γνώση, δοκιμές, βελτίωση ενός πράκτορα σε κλειστό βρόχο, καμπάνιες, γραφικά στοιχεία, πλαίσια πραγματικού χρόνου και μετεγκαταστάσεις. |
| MCP | Τα εργαλεία με έλεγχο ταυτότητας καλύπτουν πράκτορες, αριθμούς, κλήσεις, δοκιμές, γνώση, εργαλεία/webhooks, καμπάνιες, φωνές, εισαγωγές και τεκμηρίωση καθώς διατίθενται· καλέστε το tools/list για τον τρέχοντα κατάλογο. |
| Ακατέργαστη τεκμηρίωση | Τρέχουσες πηγές Markdown για τη συμπεριφορά του προϊόντος και τις λεπτομέρειες του API. |
Οι δεξιότητες εξηγούν πώς να εκτελέσετε την εργασία. Το MCP επιτρέπει στον πράκτορα προγραμματισμού να επιθεωρεί και να ενεργεί στον οργανισμό σας. Η ακατέργαστη τεκμηρίωση παρέχει το υλικό πηγής για ερωτήσεις εκτός μιας φορτωμένης δεξιότητας.
Εγκατάσταση σε έργο
Αυτό το μπλοκ εγκαθιστά τις δεξιότητες, καθιστά το κλειδί διαθέσιμο στο τρέχον κέλυφος και προσθέτει τον MCP διακομιστή με εμβέλεια έργου στο Claude Code. Αντικαταστήστε το σύμβολο κράτησης διαβάζοντας την πραγματική τιμή από τον διαχειριστή μυστικών σας· μην επικολλάτε κλειδί σε αποθετήριο ή συνομιλία.
npx skills add thunderphone/skills
export THUNDERPHONE_API_KEY='replace-with-value-from-your-secret-manager'
claude mcp add --transport http --scope project \
--header 'Authorization: Bearer ${THUNDERPHONE_API_KEY}' \
thunderphone https://api.thunderphone.com/v1/mcpΓια το Codex, αντικαταστήστε την τελική εντολή με:
codex mcp add thunderphone \
--url https://api.thunderphone.com/v1/mcp \
--bearer-token-env-var THUNDERPHONE_API_KEYΤο Cursor διαβάζει μια ρύθμιση έργου από το .cursor/mcp.json:
{
"mcpServers": {
"thunderphone": {
"type": "http",
"url": "https://api.thunderphone.com/v1/mcp",
"headers": {
"Authorization": "Bearer ${env:THUNDERPHONE_API_KEY}"
}
}
}
}Το VS Code χρησιμοποιεί τον ίδιο διακομιστή κάτω από ένα κλειδί servers στο .vscode/mcp.json:
{
"servers": {
"thunderphone": {
"type": "http",
"url": "https://api.thunderphone.com/v1/mcp",
"headers": {
"Authorization": "Bearer ${env:THUNDERPHONE_API_KEY}"
}
}
}
}Παράδειγμα συνεδρίας: δίγλωσσος οδοντιατρικός γραμματέας
- Ζητήστε από τον προγραμματιστικό πράκτορα να φορτώσει τα
create-agent,thunderphone-prompt-builder,build-tool-integration,add-knowledgeκαιtest-agent. Πείτε του να σχεδιάσει πρώτα και να μην δημιουργήσει ακόμη πόρους. - Δώστε του επαληθευμένα στοιχεία του ιατρείου, υποστηριζόμενες εργασίες, κανόνες κλιμάκωσης και τις δύο απαιτούμενες γλωσσικές ρυθμίσεις. Ζητήστε του να ελέγξει τον ενεργό κατάλογο φωνών και τις υποστηριζόμενες γλώσσες αντί να επινοήσει μια φωνή ή γλωσσική ρύθμιση.
- Ζητήστε ένα prompt παραγωγής, βασισμένο σε γενικές αρχές και στοιχεία. Ο πράκτορας θα πρέπει να αλλάζει στην υποστηριζόμενη γλώσσα του καλούντος, να διατηρεί τον λόγο σύντομο, να κάνει μία ερώτηση κάθε φορά και να αποφεύγει προκαθορισμένα σενάρια απαντήσεων του καλούντος.
- Ζητήστε του να ορίσει ένα περιορισμένο εργαλείο προγραμματισμού και να επισυνάψει μόνο τις γνώσεις που χρειάζεται ο γραμματέας. Δοκιμάστε επιτυχία εργαλείου, μη διαθεσιμότητα, μη έγκυρη είσοδο, χρονικό όριο και μεταβίβαση σε άνθρωπο πριν από την ανάπτυξη.
- Δημιουργήστε σενάρια για αμφότερες τις γλώσσες, διακοπές, διορθώσεις, ελλιπείς πληροφορίες, ερωτήσεις γνώσεων, αποτυχίες προγραμματισμού και κλιμάκωση. Εκτελέστε τα, ελέγξτε τις απομαγνητοφωνήσεις και τα στοιχεία του εργαλείου, διορθώστε τον μικρότερο γενικό κανόνα και εκτελέστε ξανά το ίδιο σύνολο.
- Ελέγξτε το ακριβές προσχέδιο και τα στοιχεία δοκιμών και, στη συνέχεια, εξουσιοδοτήστε ρητά την ανάπτυξη και τη σύνδεση αριθμού. Πραγματοποιήστε μια ελεγχόμενη ηχητική κλήση σε κάθε γλώσσα πριν μεταφέρετε πραγματική κίνηση.
Βελτιώστε έναν πράκτορα σε κλειστό βρόχο
Μόλις ένας πράκτορας δέχεται κλήσεις, ζητήστε από τον πράκτορα προγραμματισμού να φορτώσει το iterate-on-agent.
Η δεξιότητα εκτελεί τον ίδιο βρόχο που χρησιμοποιεί το ThunderPhone στους δικούς του πράκτορες, ώστε κάθε
αλλαγή να μετριέται πριν κυκλοφορήσει:
- Διαβάστε τον πράκτορα, τις αναθεωρήσεις προτροπών του και τον οδηγό στυλ προτροπών. Οι αναθεωρήσεις προτροπών είναι διαθέσιμες μέσω REST και MCP, ώστε ένας πράκτορας προγραμματισμού να μπορεί να επιθεωρεί απευθείας τις πρόσφατες αλλαγές προτροπών.
- Δημιουργήστε σύνολα δοκιμών. Το
import_conversationsμετατρέπει πρόσφατες κλήσεις ή επιλεγμένες κλήσεις βάσειcall_idsσε συνομιλίες δοκιμών και τις δυσκολότερες στιγμές τους σε παραδείγματα με κλειδιά απαντήσεων. Αν η δημιουργία παραδειγμάτων απέτυχε για ορισμένες εισαγμένες συνομιλίες, εκτελέστε τοimport_conversationsμεredo_failed: trueγια να δημιουργήσετε ξανά παραδείγματα για εκείνες τις συνομιλίες πρακτόρων χωρίς να εισαγάγετε κλήσεις. Τοgenerate_conversationsδημιουργεί συνομιλίες για έναν νέο πράκτορα, συμπεριλαμβανομένων δύσκολων καλούντων που στοχεύουν στα αδύναμα σημεία της προτροπής (αυτοί πηγαίνουν πάντα στη διαίρεση dev). Κάθε συνομιλία βρίσκεται σε μια διαίρεση dev, για βελτιστοποίηση, ή σε μια διαίρεση test, για μία μέτρηση. Μια κλήση της οποίας ο καλών βρίσκεται σε διαίρεση test αποκλείεται: για ένα κλειδί API ή διακριτικό OAuth, τόσο μέσω REST όσο και μέσω MCP, επιστρέφει μόνο με το αναγνωριστικό της, την ώρα έναρξης καιheld_out: true, οι εγγραφές σε αυτήν απορρίπτονται (held_out_call), όπως και τα σενάρια δοκιμών που προωθούνται από αυτήν· μην τη συμπεριλαμβάνετε κατά τη βελτιστοποίηση. - Ορίστε μια βάση αναφοράς με
run_replaysστη διαίρεση dev. Με το Bolt v2, μια σειρά με καταγεγραμμένο ήχο αναπαράγεται όπως θα την εκτελούσε μια ζωντανή κλήση. - Επεξεργαστείτε το προσχέδιο. Το
review_promptελέγχει την προτροπή βάσει του οδηγού στυλ και προτείνει επεξεργασίες εύρεσης και αντικατάστασης· τοupdate_agentτις εφαρμόζει στο προσχέδιο μεprompt_edits· ένας δεύτερος έλεγχος μεprevious_promptελέγχει τι άλλαξε. Τοrefactor_promptξαναγράφει μια προτροπή που έχει συγκεντρώσει υπερβολικές διορθώσεις και αναφέρει κάθε συμπεριφορά που άλλαξε. Όταν μια επεξεργασία προσθέτει ή αφαιρεί μια συμπεριφορά, τοrefresh_conversationsενημερώνει τις συνομιλίες δοκιμών σύμφωνα με τη νέα προτροπή, επαναφέροντας προηγούμενες εκδόσεις όπου ένας κανόνας επανήλθε. - Επαληθεύστε με
run_replaysσε σύγκριση με τη βάση αναφοράς, διαβάζοντας τις αποτυχίες όπως θα τις άκουγε ένας καλών. Τοcompare_configsδοκιμάζει ένα διαφορετικό επίπεδο ακοής, φωνή, εντοπισμό τέλους εκφοράς ή επίπεδο νοημοσύνης στα ίδια παραδείγματα dev· οι συγκρίσεις είναι μόνο για dev. - Μετρήστε μία φορά στη διαίρεση test. Μια εκτέλεση δοκιμής αναπαράγει μία ολόκληρη
κοόρτη δοκιμών και το πρώτο αποτέλεσμά της τη χρησιμοποιεί, επομένως κάθε μεταγενέστερη εκτέλεση δοκιμής, για οποιαδήποτε
προτροπή, χρειάζεται νέα δεδομένα δοκιμών από εισαγμένες κλήσεις ή δημιουργημένες
συνομιλίες. Η μηχανή κάθε παραδείγματος ορίζεται πριν από την εκτέλεση από τα
δεδομένα του (ο καταγεγραμμένος ήχος αναπαράγεται ακριβώς, τα παραδείγματα μόνο με κείμενο ως κείμενο).
Τα σύνολα αποτελεσμάτων παρέχονται ανά μηχανή και τίποτα δεν επιστρέφει σε κείμενο: μια κοόρτη με
καταγεγραμμένο ήχο σε διαμόρφωση διαφορετική από Bolt v2 απορρίπτεται
(
test_needs_exact_replay) και παραμένει αχρησιμοποίητη, επομένως μετρήστε αυτή τη διαμόρφωση στο dev. Οι πράκτορες προγραμματισμού λαμβάνουν μόνο σύνολα αποτελεσμάτων, καθώς και μια ανάγνωση σύγκρισης σε απλή γλώσσα στις εκτελέσεις dev, ώστε να μην μπορούν να βελτιστοποιούν στη διαίρεση test. - Ακούστε μια εγγραφή
run_simulationή ανοίξτε έναν σύνδεσμο συνομιλίας και μιλήστε οι ίδιοι με το προσχέδιο. - Αναπτύξτε όταν το αποφασίσετε.
Ό,τι καταναλώνει πιστώσεις απαιτεί πρώτα προσφορά: στείλτε dry_run: true για εκτίμηση και, στη συνέχεια, εκτελέστε το με το quote_id της και το max_cost_cents, ένα αυστηρό όριο. Μια προσφορά καλύπτει μία εκτέλεση: οι εργασίες συνομιλιών, οι εκτελέσεις επανάληψης και οι αναθεωρήσεις και αναδιαρθρώσεις προτροπών που καλούν το μοντέλο την καταναλώνουν οριστικά κατά την έναρξή τους. Οι επί πληρωμή εκτελέσεις που ξεκινούν από το κλειδί API σας, την εφαρμογή OAuth ή το MCP υπολογίζονται επίσης στο ίδιο όριο του κιτ εργαλείων που έχει ενεργοποιήσει ο οργανισμός σας,
και μια έναρξη που απορρίπτεται ή αποτυγχάνει αρχικά την αφήνει διαθέσιμη· αφού
χρησιμοποιηθεί, επαναλάβετε μια αποτυχημένη εκτέλεση με νέα δοκιμαστική εκτέλεση. Κάθε αίτημα
δεσμεύει το μέγιστο πιθανό κόστος του πριν σταλεί και η εκτέλεση χρεώνεται
με το πραγματικό της κόστος, επομένως αφήστε περιθώριο στην εκτίμηση. Μια ακριβής επανάληψη δεσμεύει
περίπου 85 σεντ έως 1,25 $ ανά επανάληψη σε εξέλιξη για έναν τυπικό γύρο
(έναν κανονικό γύρο συν μία επανεκτέλεση παραγωγής), έναντι πραγματικού κόστους λίγων
σεντ: δώστε στις εκτελέσεις επανάληψης ένα όριο με περιθώριο. Ένας γύρος που εξακολουθεί να εξαντλεί τον
προϋπολογισμό καταμετράται ξεχωριστά και δεν καταναλώνει καμία ομάδα δοκιμών. Ένας
πράκτορας εκτελεί μία εργασία συνομιλίας ή εκτέλεση επανάληψης κάθε φορά. Με OAuth, τα εργαλεία
προτροπών χρειάζονται το πεδίο agents:write. Όταν η εγγραφή μιας κλήσης απενεργοποιείται
ή η κλήση διαγράφεται, διαγράφονται επίσης οι δοκιμαστικές συνομιλίες και τα παραδείγματα που
προήλθαν από αυτήν. Τα εργαλεία δοκιμαστικών συνομιλιών,
επανάληψης και αναθεώρησης προτροπών αποτελούν μέρος του κιτ εργαλείων επανάληψης
πρακτόρων, το οποίο ενεργοποιείται ανά οργανισμό όσο βρίσκεται σε βήτα (οι σύνδεσμοι συνομιλίας
είναι ενεργοί για κάθε οργανισμό)· ζητήστε από την
υποστήριξη να το ενεργοποιήσει.
Χρησιμοποιήστε το SDK Python ή TypeScript για αιτήματα REST με τύπους.
Χρησιμοποιήστε REST αντί για MCP όταν μια κατασκευή χρειάζεται ντετερμινιστικά φορτία, εκδόσιμα
fixtures, μαζική ενορχήστρωση ή μια λειτουργία που δεν υπάρχει στην τρέχουσα λίστα εργαλείων MCP. Το API ξεκινά στο https://api.thunderphone.com/v1; δείτε την
εισαγωγή στο API και τον
οδηγό MCP.