Open in
Kurkite naudodami Claude Code, Codex arba Cursor
Įdiekite ThunderPhone Agent Skills, prijunkite ThunderPhone MCP serverį ir suteikite programavimo agentui naujausią produkto dokumentaciją.
ThunderPhone pateikia tris kodavimo agentams skirtus sluoksnius:
| Sluoksnis | Ką jis suteikia agentui |
|---|---|
| Agentų įgūdžiai | Tikslinės procedūros agentams, raginimams, numeriams, skambučiams, įrankiams, žiniatinklio kabliukams, žinioms, testavimui, agento tobulinimui uždarame cikle, kampanijoms, valdikliams, realiojo laiko sistemoms ir perkėlimams. |
| MCP | Autentifikuoti įrankiai apima agentus, numerius, skambučius, testavimą, žinias, įrankius ir žiniatinklio kabliukus, kampanijas, balsus, importavimą ir dokumentaciją, kai jie diegiami; aktyviam katalogui iškviesti tools/list. |
| Neapdorota dokumentacija | Dabartiniai Markdown šaltiniai apie produkto veikimą ir API informaciją. |
Įgūdžiai paaiškina, kaip atlikti darbą. MCP leidžia kodavimo agentui tikrinti jūsų organizaciją ir joje atlikti veiksmus. Neapdorota dokumentacija pateikia šaltinę medžiagą klausimams, kurie nepatenka į įkeltą įgūdį.
Įdiekite projekte
Šis blokas įdiegia įgūdžius, padaro raktą prieinamą dabartiniam apvalkalui ir prideda projektui skirtą MCP serverį į Claude Code. Pakeiskite vietos rezervavimo ženklą nuskaitydami tikrąją reikšmę iš savo paslapčių tvarkyklės; neįklijuokite rakto į saugyklą ar pokalbį.
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/mcpJei naudojate Codex, paskutinę komandą pakeiskite šia:
codex mcp add thunderphone \
--url https://api.thunderphone.com/v1/mcp \
--bearer-token-env-var THUNDERPHONE_API_KEYCursor nuskaito projekto konfigūraciją iš .cursor/mcp.json:
{
"mcpServers": {
"thunderphone": {
"type": "http",
"url": "https://api.thunderphone.com/v1/mcp",
"headers": {
"Authorization": "Bearer ${env:THUNDERPHONE_API_KEY}"
}
}
}
}VS Code naudoja tą patį serverį su raktu servers faile .vscode/mcp.json:
{
"servers": {
"thunderphone": {
"type": "http",
"url": "https://api.thunderphone.com/v1/mcp",
"headers": {
"Authorization": "Bearer ${env:THUNDERPHONE_API_KEY}"
}
}
}
}Pavyzdinis seansas: dvikalbis odontologijos registratūros darbuotojas
- Paprašykite programavimo agento įkelti
create-agent,thunderphone-prompt-builder,build-tool-integration,add-knowledgeirtest-agent. Nurodykite jam pirmiausia parengti planą ir dar nekurti išteklių. - Pateikite jam patikrintus klinikos faktus, palaikomas užduotis, eskalavimo taisykles ir dvi reikiamas lokales. Paprašykite patikrinti tiesioginį balsų katalogą ir palaikomas kalbas, užuot sukūrus balsą ar lokalę.
- Paprašykite vienos produkcinės instrukcijos, sukurtos remiantis bendraisiais principais ir faktais. Agentas turėtų persijungti į skambintojo palaikomą kalbą, kalbėti glaustai, užduoti po vieną klausimą ir vengti skambintojo atsakymų scenarijų.
- Nurodykite jam apibrėžti siaurą registravimo įrankį ir pridėti tik tas žinias, kurių reikia registratūros darbuotojui. Prieš diegdami išbandykite sėkmingą įrankio veikimą, laisvų laikų nebuvimą, neteisingą įvestį, skirtąjį laiką ir perdavimą žmogui.
- Sugeneruokite scenarijus abiem kalboms, pertraukimams, pataisymams, trūkstamai informacijai, žinių klausimams, registravimo nesėkmėms ir eskalavimui. Juos vykdykite, peržiūrėkite transkripcijas ir įrankio įrodymus, pataisykite mažiausią bendrą taisyklę ir pakartokite tą patį rinkinį.
- Peržiūrėkite tikslų juodraštį ir testų įrodymus, tada aiškiai autorizuokite diegimą ir numerio prijungimą. Prieš nukreipdami realų srautą, atlikite kontroliuojamą garso skambutį kiekviena kalba.
Tobulinkite agentą uždarame cikle
Kai agentas pradeda priimti skambučius, paprašykite kodavimo agento įkelti iterate-on-agent.
Šis įgūdis vykdo tą patį ciklą, kurį ThunderPhone naudoja savo agentams, todėl kiekvienas
pakeitimas išmatuojamas prieš jį diegiant:
- Perskaitykite agentą, jo raginimo redakcijas ir raginimo stiliaus vadovą. Raginimo redakcijos pasiekiamos per REST ir MCP, todėl programavimo agentas gali tiesiogiai peržiūrėti naujausius raginimo pakeitimus.
- Sukurkite testų rinkinius.
import_conversationspaverčia naujausius skambučius arba pagalcall_idspasirinktus skambučius į testavimo pokalbius ir sudėtingiausias jų vietas į pavyzdžius su atsakymų raktais. Jei nepavyko sukurti pavyzdžių kai kuriems importuotiems pokalbiams, paleiskiteimport_conversationssuredo_failed: true, kad vėl sukurtumėte pavyzdžius tiems agento pokalbiams neimportuodami jokių skambučių.generate_conversationsjuos sukuria naujam agentui, įskaitant sudėtingus skambinančiuosius, skirtus raginimo silpnosioms vietoms (jie visada patenka į kūrimo dalį). Kiekvienas pokalbis yra kūrimo dalyje, skirtoje koregavimui, arba testavimo dalyje, skirtoje vienkartiniam matavimui. Skambutis, kurio skambinantysis yra testavimo dalyje, yra neįtrauktas: API raktui ar OAuth prieigos raktui tiek per REST, tiek per MCP jis grąžinamas tik su savo ID, pradžios laiku irheld_out: true, įrašai į jį atmetami (held_out_call), taip pat atmetami iš jo perkelti testavimo scenarijai; koreguodami jo nenaudokite. - Nustatykite pradinį lygį naudodami
run_replayskūrimo dalyje. Su Bolt v2 pokalbio žingsnis su įrašytu garsu yra atkuriamas taip, kaip jis būtų vykdomas tiesioginio skambučio metu. - Redaguokite juodraštį.
review_promptpatikrina raginimą pagal stiliaus vadovą ir siūlo paieškos bei keitimo pataisas;update_agentpritaiko jas juodraščiui naudodamasprompt_edits; antroji peržiūra suprevious_promptpatikrina, kas pasikeitė.refactor_promptperrašo raginimą, kuriame susikaupė per daug pataisų, ir praneša apie bet kokią pakeistą elgseną. Kai pataisa prideda ar pašalina elgseną,refresh_conversationsatnaujina testavimo pokalbius pagal naują raginimą ir atkuria ankstesnes versijas ten, kur taisyklė vėl atsirado. - Patikrinkite naudodami
run_replays, palyginti su pradiniu lygiu, vertindami nesėkmes taip, kaip jas girdėtų skambinantysis.compare_configstuose pačiuose kūrimo pavyzdžiuose išbando kitą klausymo pakopą, balsą, pokalbio pabaigos aptikimą arba intelekto pakopą; palyginimai skirti tik kūrimui. - Išmatuokite vieną kartą testavimo dalyje. Testavimo vykdymas atkartoja vieną visą testavimo kohortą, o pirmasis jo rezultatas ją sunaudoja, todėl kiekvienam vėlesniam testavimo vykdymui su bet kokiu raginimu reikia naujų testavimo duomenų iš importuotų skambučių arba sugeneruotų pokalbių. Kiekvieno pavyzdžio vykdymo modulis prieš vykdymą nustatomas pagal jo duomenis (įrašytas garsas atkuriamas tiksliai, tik tekstiniai pavyzdžiai vykdomi kaip tekstas). Suvestinės pateikiamos pagal vykdymo modulį, ir niekas negrįžta prie teksto režimo: kohorta su įrašytu garsu, naudojama su kita nei Bolt v2 konfigūracija, atmetama (
test_needs_exact_replay) ir lieka nepanaudota, todėl tokią konfigūraciją matuokite kūrimo dalyje. Programavimo agentai gauna tik suvestines ir paprasta kalba pateikiamą palyginimo įvertinimą apie kūrimo vykdymus, todėl jie negali koreguoti pagal testavimo dalį. - Paklausykite
run_simulationįrašo arba atidarykite pokalbio nuorodą ir patys pasikalbėkite su juodraščiu. - Įdiekite, kai nurodysite.
Viskam, kas naudoja kreditus, pirmiausia pateikiama sąmata: įvertinimui siųskite dry_run: true, tada vykdykite su jos quote_id ir max_cost_cents – griežtu limitu. Viena sąmata apmoka vieną vykdymą: pokalbių užduotys, atkūrimo vykdymai, taip pat raginimų peržiūros ir pertvarkymai, kurie iškviečia modelį, ją negrįžtamai panaudoja prasidėjus vykdymui. Mokami vykdymai, pradėti naudojant jūsų API raktą, OAuth programą ar MCP, taip pat įskaičiuojami į tą patį jūsų organizacijai įjungtą įrankių rinkinio limitą, o atmestas arba iš karto nepavykęs paleidimas palieka ją panaudojamą; ją panaudoję, nepavykusį vykdymą pakartokite atlikę naują bandomąjį vykdymą. Kiekviena užklausa prieš išsiunčiant rezervuoja didžiausią galimą kainą, o už vykdymą nuskaičiuojama jo faktinė kaina, todėl palikite įvertinimo rezervą. Tikslus atkūrimas tipiniam vykdomam pokalbio etapui rezervuoja apie 85 centus–$1.25 už vieną atkūrimą (įprastas etapas ir vienas pakartotinis paleidimas produkcinėje aplinkoje), nors faktinė kaina yra keli centai: atkūrimo vykdymams nustatykite limitą su atsarga. Etapas, kuriam vis tiek nepakanka biudžeto, skaičiuojamas atskirai ir nenaudoja jokios testavimo grupės. Agentas vienu metu vykdo vieną pokalbio užduotį arba atkūrimo vykdymą. Naudojant OAuth, raginimų įrankiams reikia agents:write srities. Išjungus skambučio įrašymą arba ištrynus skambutį, iš jo paimti testiniai pokalbiai ir pavyzdžiai taip pat pašalinami. Testinių pokalbių, atkūrimo ir raginimų peržiūros įrankiai yra agento iteravimo įrankių rinkinio dalis; beta laikotarpiu jis įjungiamas kiekvienai organizacijai atskirai (pokalbių nuorodos įjungtos kiekvienai organizacijai); paprašykite pagalbos tarnybos jį įjungti.
Tipizuotoms REST užklausoms naudokite Python arba TypeScript SDK.
Naudokite REST vietoj MCP, kai kūrimui reikia deterministinių užklausų turinių, versijuojamų
testinių duomenų, masinio orkestravimo arba operacijos, kurios nėra dabartiniame MCP
įrankių sąraše. API prasideda adresu https://api.thunderphone.com/v1; žr.
API įvadą ir
MCP vadovą.