ThunderPhone v3 je zdaj na voljo.Začnite sami, že od 2 ¢/min.Preberite obvestilo

Getting Started

Gradite s Claude Code, Codex ali Cursor

Namestite veščine ThunderPhone Agent, povežite strežnik ThunderPhone MCP in kodirnemu agentu zagotovite trenutno dokumentacijo izdelka.

ThunderPhone ponuja tri plasti za agente za programiranje:

PlastKaj zagotavlja agentu
Agent SkillsOsredotočeni postopki za agente, pozive, številke, klice, orodja, spletne kljuke, znanje, preskušanje, izboljševanje agenta v zaprti zanki, kampanje, pripomočke, ogrodja v realnem času in migracije.
MCPPreverjena orodja pokrivajo agente, številke, klice, preskušanje, znanje, orodja/spletne kljuke, kampanje, glasove, uvoze in dokumentacijo, ko so na voljo; za aktualni katalog pokličite tools/list.
Izvorna dokumentacijaTrenutni viri Markdown za delovanje izdelka in podrobnosti API-ja.

Veščine pojasnjujejo, kako opraviti delo. MCP agentu za programiranje omogoča pregledovanje in upravljanje vaše organizacije. Surova dokumentacija zagotavlja izvorno gradivo za vprašanja zunaj naložene veščine.

Namestitev v projekt

Ta blok namesti veščine, omogoči ključ v trenutni lupini in doda strežnik MCP, omejen na projekt, v Claude Code. Nadomestni znak zamenjajte tako, da dejansko vrednost preberete iz upravitelja skrivnosti; ključa ne prilepite v repozitorij ali klepet.

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

Za Codex zadnji ukaz zamenjajte z:

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

Cursor prebere konfiguracijo projekta iz .cursor/mcp.json:

{
  "mcpServers": {
    "thunderphone": {
      "type": "http",
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:THUNDERPHONE_API_KEY}"
      }
    }
  }
}

VS Code uporablja isti strežnik pod ključem servers v .vscode/mcp.json:

{
  "servers": {
    "thunderphone": {
      "type": "http",
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:THUNDERPHONE_API_KEY}"
      }
    }
  }
}

Primer seje: dvojezični zobozdravstveni receptor

  1. Agenta za programiranje prosite, naj naloži create-agent, thunderphone-prompt-builder, build-tool-integration, add-knowledge in test-agent. Povejte mu, naj najprej pripravi načrt in še ne ustvari virov.
  2. Posredujte mu preverjena dejstva o ordinaciji, podprta opravila, pravila za eskalacijo in dva zahtevana jezika. Naj preveri katalog glasov v živo in podprte jezike, namesto da si izmisli glas ali jezikovno nastavitev.
  3. Zahtevajte en produkcijski poziv, zgrajen na splošnih načelih in dejstvih. Agent naj preklopi na klicateljev podprti jezik, naj bo govor jedrnat, naj postavlja eno vprašanje naenkrat in se izogiba skriptam za odgovore klicatelja.
  4. Naj določi ozko orodje za naročanje in priloži samo znanje, ki ga receptor potrebuje. Pred uvedbo preizkusite uspešno uporabo orodja, nedosegljive termine, neveljaven vnos, časovno omejitev in predajo človeku.
  5. Ustvarite scenarije za oba jezika, prekinitve, popravke, manjkajoče informacije, vprašanja o znanju, neuspehe pri naročanju in eskalacijo. Zaženite jih, preglejte prepise in dokaze orodij, popravite najmanjše splošno pravilo ter znova zaženite isti nabor.
  6. Preglejte natančen osnutek in dokaze preizkusov, nato izrecno odobrite uvedbo in pripenjanje številke. Pred preusmeritvijo dejanskega prometa opravite nadzorovan zvočni klic v vsakem jeziku.

Izboljšajte agenta v zaprti zanki

Ko agent začne sprejemati klice, prosite agenta za programiranje, naj naloži iterate-on-agent. Veščina izvaja enak cikel, ki ga ThunderPhone uporablja za svoje agente, zato se vsaka sprememba izmeri, preden se uvede:

  1. Preberite agenta, njegove revizije poziva in slogovni priročnik za pozive. Revizije pozivov so na voljo prek REST in MCP, zato lahko agent za programiranje neposredno pregleda nedavne spremembe poziva.
  2. Ustvarite preskusne nabore. import_conversations pretvori nedavne klice ali izbrane klice po call_ids v preskusne pogovore in njihove najzahtevnejše trenutke v primere s ključi odgovorov. Če ustvarjanje primerov za nekatere uvožene pogovore ni uspelo, zaženite import_conversations z redo_failed: true, da znova ustvarite primere za te pogovore agenta brez uvoza novih klicev. generate_conversations jih ustvari za novega agenta, vključno z zahtevnimi klicalci, usmerjenimi na šibke točke poziva (ti so vedno v razdelku dev). Vsak pogovor je v razdelku dev za prilagajanje ali v preskusnem razdelku za enkratno merjenje. Klic, katerega klicalec je v preskusnem razdelku, je izločen: za ključ API ali žeton OAuth se prek REST in MCP vrne le z ID-jem, časom začetka in held_out: true, zapisi vanj so zavrnjeni (held_out_call), prav tako pa tudi preskusni scenariji, promovirani iz njega; pri prilagajanju ga izpustite.
  3. Določite izhodišče z run_replays v razdelku dev. Z Bolt v2 se izmenjava s posnetim zvokom predvaja, kot bi jo izvedel živi klic.
  4. Uredite osnutek. review_prompt preveri poziv glede na slogovni priročnik in ponudi popravke za iskanje in zamenjavo; update_agent jih uporabi v osnutku s prompt_edits; drugo preverjanje s previous_prompt preveri, kaj se je spremenilo. refactor_prompt prepiše poziv, ki je zbral preveč popravkov, in poroča o vseh spremenjenih vedenjih. Ko urejanje doda ali odstrani vedenje, refresh_conversations posodobi preskusne pogovore glede na novi poziv ter obnovi prejšnje različice, kjer se je pravilo vrnilo.
  5. Preverite z run_replays glede na izhodišče in preberite neuspehe tako, kot bi jih slišal klicalec. compare_configs preizkusi drugo stopnjo zaznavanja, glas, določanje konca govora ali stopnjo inteligence na istih primerih dev; primerjave so samo za dev.
  6. Izmerite enkrat v preskusnem razdelku. Preskusni zagon ponovno predvaja eno celotno preskusno kohorto in jo s prvim rezultatom porabi, zato vsak poznejši preskusni zagon za kateri koli poziv potrebuje sveže preskusne podatke iz uvoženih klicev ali ustvarjenih pogovorov. Pogon posameznega primera se pred zagonom nastavi na podlagi njegovih podatkov (posneti zvok se ponovno predvaja natančno, primeri samo z besedilom pa kot besedilo). Skupni rezultati so na voljo za vsak pogon in nič se ne preklopi na besedilo: kohorta s posnetim zvokom v konfiguraciji, ki ni Bolt v2, je zavrnjena (test_needs_exact_replay) in ostane neuporabljena, zato to konfiguracijo izmerite v dev. Agenti za programiranje prejmejo le skupne rezultate in primerjalno razlago v razumljivem jeziku za zagone dev, zato ne morejo prilagajati v preskusnem razdelku.
  7. Poslušajte posnetek run_simulation ali odprite povezavo za pogovor in se sami pogovorite z osnutkom.
  8. Uvedite ga, ko tako določite.

Vse, kar porablja dobroimetje, najprej ustvari ponudbo: za oceno pošljite dry_run: true, nato pa zaženite s ponudbinima quote_id in max_cost_cents, ki predstavlja strogo zgornjo mejo. Ponudba krije en zagon: opravila pogovorov, zagoni ponovitev ter pregledi in preoblikovanja pozivov, ki kličejo model, jo ob začetku trajno porabijo. Plačani zagoni, začeti z vašim ključem API, aplikacijo OAuth ali MCP, se prav tako vštevajo v isto kvoto kompleta orodij, ki jo je omogočila vaša organizacija, zavrnjen ali neuspešen začetek pa jo ohrani uporabno; po porabi neuspešen zagon ponovite z novim suhim zagonom. Vsaka zahteva pred pošiljanjem rezervira najvišji možni strošek, zagon pa se zaračuna po dejanskem strošku, zato pustite rezervo v oceni. Natančna ponovitev za običajen obrat rezervira približno od 85 centov do 1,25 USD na ponovitev v izvajanju (običajen obrat in eno ponovno izvajanje v produkciji), dejanski strošek pa je nekaj centov: za zagone ponovitev nastavite omejitev z dovolj rezerve. Obrat, ki mu še vedno zmanjka proračuna, se šteje ločeno in ne porabi nobene testne kohorte. Agent hkrati izvaja eno opravilo pogovora ali zagon ponovitve. Pri OAuth orodja za pozive potrebujejo obseg agents:write. Ko je snemanje klica izklopljeno ali je klic izbrisan, se odstranijo tudi testni pogovori in primeri, pridobljeni iz njega. Orodja za testne pogovore, ponovitve in preglede pozivov so del kompleta orodij za iteracijo agenta, ki je med beta različico omogočen za posamezno organizacijo (povezave za pogovor so omogočene za vsako organizacijo); za vklop se obrnite na podporo.

Za tipizirane zahteve REST uporabite Python ali TypeScript SDK.

REST uporabite namesto MCP, kadar izdelava zahteva deterministične koristne vsebine, različicirane pripravljene podatke, množično orkestracijo ali operacijo, ki ni na trenutnem seznamu orodij MCP. API se začne na https://api.thunderphone.com/v1; glejte uvod v API in vodič za MCP.