ThunderPhone v3 jau veikia.Viską atlikite savarankiškai – nuo 2 ct/min.Skaityti pranešimą

Getting Started

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:

SluoksnisKą jis suteikia agentui
Agentų įgūdžiaiTikslinė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.
MCPAutentifikuoti į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 dokumentacijaDabartiniai 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/mcp

Jei naudojate Codex, paskutinę komandą pakeiskite šia:

codex mcp add thunderphone \
  --url https://api.thunderphone.com/v1/mcp \
  --bearer-token-env-var THUNDERPHONE_API_KEY

Cursor 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

  1. Paprašykite programavimo agento įkelti create-agent, thunderphone-prompt-builder, build-tool-integration, add-knowledge ir test-agent. Nurodykite jam pirmiausia parengti planą ir dar nekurti išteklių.
  2. 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ę.
  3. 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ų.
  4. 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.
  5. 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į.
  6. 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:

  1. 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.
  2. Sukurkite testų rinkinius. import_conversations paverčia naujausius skambučius arba pagal call_ids pasirinktus skambučius į testavimo pokalbius ir sudėtingiausias jų vietas į pavyzdžius su atsakymų raktais. Jei nepavyko sukurti pavyzdžių kai kuriems importuotiems pokalbiams, paleiskite import_conversations su redo_failed: true, kad vėl sukurtumėte pavyzdžius tiems agento pokalbiams neimportuodami jokių skambučių. generate_conversations juos 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 ir held_out: true, įrašai į jį atmetami (held_out_call), taip pat atmetami iš jo perkelti testavimo scenarijai; koreguodami jo nenaudokite.
  3. Nustatykite pradinį lygį naudodami run_replays kūrimo dalyje. Su Bolt v2 pokalbio žingsnis su įrašytu garsu yra atkuriamas taip, kaip jis būtų vykdomas tiesioginio skambučio metu.
  4. Redaguokite juodraštį. review_prompt patikrina raginimą pagal stiliaus vadovą ir siūlo paieškos bei keitimo pataisas; update_agent pritaiko jas juodraščiui naudodamas prompt_edits; antroji peržiūra su previous_prompt patikrina, kas pasikeitė. refactor_prompt perrašo raginimą, kuriame susikaupė per daug pataisų, ir praneša apie bet kokią pakeistą elgseną. Kai pataisa prideda ar pašalina elgseną, refresh_conversations atnaujina testavimo pokalbius pagal naują raginimą ir atkuria ankstesnes versijas ten, kur taisyklė vėl atsirado.
  5. Patikrinkite naudodami run_replays, palyginti su pradiniu lygiu, vertindami nesėkmes taip, kaip jas girdėtų skambinantysis. compare_configs tuose pačiuose kūrimo pavyzdžiuose išbando kitą klausymo pakopą, balsą, pokalbio pabaigos aptikimą arba intelekto pakopą; palyginimai skirti tik kūrimui.
  6. 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į.
  7. Paklausykite run_simulation įrašo arba atidarykite pokalbio nuorodą ir patys pasikalbėkite su juodraščiu.
  8. Į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ą.