Ehita Claude Code

Installi ThunderPhone

ThunderPhone pakub kodeerimisagentidele kolme kihti:

Oskused selgitavad, kuidas tööd teha. MCP võimaldab kodeerimisagendil sinu organisatsiooni uurida ja selles toiminguid teha. Toordokumendid pakuvad alusmaterjali küsimustele, mis jäävad väljapoole laaditud oskust.

Paigalda projekti#

See plokk paigaldab oskused, teeb võtme praeguses käsureaseansis kättesaadavaks ja lisab Claude Code'i projektipõhise MCP-serveri. Asenda kohatäide, lugedes tegeliku väärtuse oma saladuste haldurist; ära kleebi võtit hoidlasse ega vestlusesse.

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

Codexi jaoks asenda viimane käsk järgmisega:

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

Cursor loeb projekti konfiguratsiooni failist .cursor/mcp.json:

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

VS Code kasutab sama serverit võtme servers all failis .vscode/mcp.json:

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

Näidisseanss: kakskeelne hambaravi vastuvõtuagent#

1. Palu kodeerimisagendil laadida create-agent, thunderphone-prompt-builder, build-tool-integration, add-knowledge ja test-agent. Ütle talle, et ta planeeriks esmalt ega looks veel ressursse.
2. Anna talle kontrollitud andmed kliiniku kohta, toetatud ülesanded, eskaleerimisreeglid ja kaks nõutud lokaati. Lase tal kontrollida aktiivset häälekataloogi ja toetatud keeli, selle asemel et häält või lokaati välja mõelda.
3. Palu luua üks tootmiskeskkonna viip, mis põhineb üldpõhimõtetel ja faktidel. Häälagent peaks lülituma helistaja toetatud keelele, hoidma kõne lühikesena, esitama korraga ühe küsimuse ja vältima helistaja vastuste skripte.
4. Lase tal määratleda kitsalt piiritletud aja broneerimise tööriist ja lisada ainult need teadmised, mida vastuvõtuagent vajab. Enne juurutamist testi tööriista edukat tulemust, vaba aja puudumist, vigast sisendit, ajalõppu ja inimesele suunamist.
5. Genereeri stsenaariumid mõlema keele, katkestuste, paranduste, puuduva teabe, teadmistega seotud küsimuste, broneerimise ebaõnnestumiste ja eskaleerimise jaoks. Käivita need, kontrolli transkripte ja tööriista tõendeid, paranda väikseim üldreegel ning käivita sama komplekt uuesti.
6. Vaata üle täpne mustand ja testi tõendid, seejärel anna selgesõnaline luba juurutamiseks ja numbri ühendamiseks. Tee enne tegeliku kõneliikluse suunamist igas keeles kontrollitud helikõne.

Täiusta häälagenti suletud tsüklis#

Kui häälagent juba kõnesid vastu võtab, palu kodeerimisagendil laadida iterate-on-agent. Oskus käitab sama tsüklit, mida ThunderPhone kasutab oma häälagentide puhul, nii et iga muudatust mõõdetakse enne juurutamist:

1. Loe agenti, selle viipade versioone ja viipade stiilijuhendit. Viipade versioonid on REST-i ja MCP kaudu saadaval, nii et kodeerimisagent saab hiljutisi viibamuudatusi otse üle vaadata.
2. Koosta testikomplektid. import_conversations muudab hiljutised kõned testvestlusteks ja nende kõige keerulisemad hetked vastusevõtmetega näideteks; generate_conversations kirjutab need uue agendi jaoks, sealhulgas keeruliste helistajatega, mis on suunatud viiba nõrkadele kohtadele (need lähevad alati arendusharusse). Iga vestlus asub kas arendusharus häälestamiseks või testharus ühekordseks mõõtmiseks. Kõne, mille helistaja on testharus, jäetakse kõrvale: API-võtme või OAuthi tokeni kaudu tagastatakse see nii REST-is kui ka MCP-s ainult oma ID, algusaja ja held_out: true-ga, sellele kirjutamine lükatakse tagasi (held_out_call), nagu ka sellest edutatud testistsenaariumid; jäta see häälestamisel välja.
3. Määra lähteväärtus arendusharus run_replays-iga. Bolt v2 puhul esitatakse salvestatud heliga voor uuesti nii, nagu seda käivitaks reaalajas kõne.
4. Muuda mustandit. review_prompt kontrollib viipa stiilijuhendi alusel ning pakub otsimise ja asendamise muudatusi; update_agent rakendab need mustandile koos prompt_edits-iga; teine ülevaatus previous_prompt-iga kontrollib, mis muutus. refactor_prompt kirjutab ümber viiba, kuhu on kogunenud liiga palju parandusi, ja teatab igast muudetud käitumisest. Kui muudatus lisab või eemaldab käitumise, viib refresh_conversations testi- vestlused uue viibaga kooskõlla, taastades varasemad versioonid kohtades, kus reegel tagasi tuli.
5. Kontrolli run_replays-iga lähteväärtuse suhtes, lugedes ebaõnnestumisi nii, nagu helistaja neid kuuleks. compare_configs proovib samade arendusnäidete puhul muud helitaset, häält, kõnelõpu tuvastust või intellektitaset; võrdlused on ainult arenduseks.
6. Mõõda üks kord testharus. Testikäitus esitab uuesti ühe terve testi- kohordi ning selle esimene tulemus kulutab selle ära, seega vajab iga hilisem testikäitus mis tahes viiba jaoks värskeid testiandmeid imporditud kõnedest või loodud vestlustest. Iga näite mootor määratakse enne käitamist selle andmete põhjal (salvestatud heli esitatakse täpselt uuesti, ainult tekstiga näited tekstina). Kogusummad esitatakse mootori kaupa ja miski ei lange tagasi tekstile: Bolt v2-st erineva konfiguratsiooniga salvestatud heliga kohort lükatakse tagasi (test_needs_exact_replay) ja jääb kasutamata, seega mõõda seda konfiguratsiooni arendusharus. Kodeerimisagendid saavad ainult selle kogusummad, seega ei saa nad selle järgi häälestada.
7. Kuula run_simulation-i salvestist või ava vestluslink ja räägi mustandiga ise.
8. Juuruta, kui ütled.

Kõik krediite kulutavad toimingud nõuavad esmalt hinnapakkumist: saada hinnangu saamiseks dry_run: true, seejärel käivita toiming selle quote_id ja range ülempiiriga max_cost_cents. Hinnapakkumine katab ühe käituse: vestlustööd, taasesituskäitused ning mudelit kutsuvad viiba ülevaatused ja ümberkorraldused kasutavad selle käivitumisel püsivalt ära ning tagasi lükatud või enne ebaõnnestunud käivitus jätab selle kasutatavaks; pärast kasutamist korda ebaõnnestunud käitust uue proovikäitusega. Iga päring reserveerib enne saatmist selle suurima võimaliku kulu ning käituselt võetakse tasu tegeliku kulu järgi, seega jäta hinnangule varu. Täpne taasesitus reserveerib tüüpilise kõnevooru korral iga poolelioleva taasesituse jaoks umbes 85 senti kuni 1,25 dollarit (tavaline voor ja üks tootmiskeskkonna korduskäitus), kuigi tegelik kulu on mõni sent: määra taasesituskäitustele piisava varuga ülempiir. Eelarve otsa saanud voor arvestatakse eraldi ega kuluta ühtegi testkogumit. Agent käitab korraga üht vestlustööd või taasesituskäitust. OAuthi korral vajavad viibatööriistad õigust agents:write. Kui kõne salvestamine lülitatakse välja või kõne kustutatakse, eemaldatakse ka sellest võetud testvestlused ja näited. Testvestluse, taasesituse, viiba ülevaatuse ja kõneliini tööriistad kuuluvad agendi iteratsioonitööriistakomplekti, mis on beetaversiooni ajal lubatud organisatsioonipõhiselt; palu toel see sisse lülitada.

Kasuta tüübistatud REST-päringute jaoks Python või TypeScript SDK-d.

Kasuta MCP asemel REST-i, kui ehitus vajab deterministlikke andmekoormaid, versioonitud fikstuure, hulgikorraldust või toimingut, mida praeguses MCP tööriistade loendis ei ole. API algab aadressilt https://api.thunderphone.com/v1; vaata API sissejuhatust ja MCP juhendit.