Open in
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:
| Plast | Kaj zagotavlja agentu |
|---|---|
| Agent Skills | Osredotoč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. |
| MCP | Preverjena 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 dokumentacija | Trenutni 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/mcpZa Codex zadnji ukaz zamenjajte z:
codex mcp add thunderphone \
--url https://api.thunderphone.com/v1/mcp \
--bearer-token-env-var THUNDERPHONE_API_KEYCursor 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
- Agenta za programiranje prosite, naj naloži
create-agent,thunderphone-prompt-builder,build-tool-integration,add-knowledgeintest-agent. Povejte mu, naj najprej pripravi načrt in še ne ustvari virov. - 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.
- 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.
- 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.
- 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.
- 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:
- 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.
- Ustvarite preskusne nabore.
import_conversationspretvori nedavne klice ali izbrane klice pocall_idsv preskusne pogovore in njihove najzahtevnejše trenutke v primere s ključi odgovorov. Če ustvarjanje primerov za nekatere uvožene pogovore ni uspelo, zaženiteimport_conversationszredo_failed: true, da znova ustvarite primere za te pogovore agenta brez uvoza novih klicev.generate_conversationsjih 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 inheld_out: true, zapisi vanj so zavrnjeni (held_out_call), prav tako pa tudi preskusni scenariji, promovirani iz njega; pri prilagajanju ga izpustite. - Določite izhodišče z
run_replaysv razdelku dev. Z Bolt v2 se izmenjava s posnetim zvokom predvaja, kot bi jo izvedel živi klic. - Uredite osnutek.
review_promptpreveri poziv glede na slogovni priročnik in ponudi popravke za iskanje in zamenjavo;update_agentjih uporabi v osnutku sprompt_edits; drugo preverjanje sprevious_promptpreveri, kaj se je spremenilo.refactor_promptprepiše poziv, ki je zbral preveč popravkov, in poroča o vseh spremenjenih vedenjih. Ko urejanje doda ali odstrani vedenje,refresh_conversationsposodobi preskusne pogovore glede na novi poziv ter obnovi prejšnje različice, kjer se je pravilo vrnilo. - Preverite z
run_replaysglede na izhodišče in preberite neuspehe tako, kot bi jih slišal klicalec.compare_configspreizkusi drugo stopnjo zaznavanja, glas, določanje konca govora ali stopnjo inteligence na istih primerih dev; primerjave so samo za dev. - 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. - Poslušajte posnetek
run_simulationali odprite povezavo za pogovor in se sami pogovorite z osnutkom. - 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.