ThunderPhone v3 on nüüd saadaval.Iseteenindusena alates 2 senti/min.Loe uudist

Getting Started

Ehita Claude Code

Installi ThunderPhone

ThunderPhone pakub kodeerimisagentidele kolme kihti:

KihtMida see agendile annab
Agendi oskusedSihtotstarbelised juhised agentide, viipade, numbrite, kõnede, tööriistade, veebikonksude, teadmiste, testimise, agendi suletud tsüklis täiustamise, kampaaniate, vidinate, reaalajaraamistike ja migreerimiste jaoks.
MCPAutenditud tööriistad hõlmavad agente, numbreid, kõnesid, testimist, teadmisi, tööriistu/veebikonkse, kampaaniaid, hääli, importimist ja dokumentatsiooni nende lisandumisel; aktiivse kataloogi kuvamiseks kutsu tools/list.
ToordokumentatsioonPraegused Markdowni lähtefailid toote käitumise ja API üksikasjade kohta.

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 viiba muudatusi ja viiba stiilijuhendit. Viiba muudatused on saadaval REST-i ja MCP kaudu, nii et programmeerimisagent saab hiljutisi viibamuudatusi otse kontrollida.
  2. Koosta testkogumid. import_conversations muudab hiljutised kõned või call_ids abil valitud kõned testvestlusteks ning nende keerukaimad hetked vastusevõtmetega näideteks; generate_conversations koostab need uue agendi jaoks, sealhulgas keeruliste helistajatega, mis on suunatud viiba nõrkadele kohtadele (need lähevad alati arendusjaotusse). Iga vestlus asub kas arendusjaotuses häälestamiseks või testjaotuses ühekordseks mõõtmiseks. Kõne, mille helistaja on testjaotuses, jäetakse välja: API-võtme või OAuthi tunnuse kaudu tagastatakse see nii REST-i kui ka MCP puhul ainult oma ID, algusaja ja held_out: true väärtusega, sellele kirjutamistoimingud lükatakse tagasi (held_out_call) ning samuti lükatakse tagasi sellest edendatud testistsenaariumid; jäta see häälestamisel välja.
  3. Loo algtase arendusjaotuses run_replays abil. Bolt v2 puhul esitatakse salvestatud heliga voor uuesti nii, nagu seda käitaks reaalajas kõne.
  4. Muuda mustandit. review_prompt kontrollib viipa stiilijuhendi järgi ning pakub otsi-ja-asenda muudatusi; update_agent rakendab need mustandile prompt_edits abil; teine kontroll previous_prompt abil kontrollib, mis muutus. refactor_prompt kirjutab ümber viiba, kuhu on kogunenud liiga palju parandusi, ning teatab mis tahes muudetud käitumisest. Kui muudatus lisab või eemaldab käitumise, viib refresh_conversations testvestlused vastavusse uue viibaga, taastades varasemad versioonid kohtades, kus reegel tagasi tuli.
  5. Kontrolli run_replays abil algtaseme suhtes, lugedes tõrkeid nii, nagu helistaja neid kuuleks. compare_configs proovib samadel arendusnäidetel teistsugust kuulamistasandit, häält, kõnelõpu tuvastust või intelligentsustaset; võrdlused on ainult arenduseks.
  6. Mõõda üks kord testjaotuses. Testikäitus esitab uuesti ühe tervikliku testkohordi ning selle esimene tulemus kasutab kohordi ära, seega vajab iga hilisem testikäitus mis tahes viiba jaoks värskeid testiandmeid imporditud kõnedest või genereeritud vestlustest. Iga näite mootor määratakse enne käitust selle andmete põhjal (salvestatud heli esitatakse uuesti täpselt, ainult tekstiga näited tekstina). Kogusummad esitatakse mootori kaupa ning miski ei kasuta varuvariandina teksti: salvestatud heliga kohort konfiguratsioonis, mis pole Bolt v2, lükatakse tagasi (test_needs_exact_replay) ja jääb kasutamata, seega mõõda seda konfiguratsiooni arendusjaotuses. Programmeerimisagendid saavad ainult selle kogusummad, seega ei saa nad selle põhjal häälestada.
  7. Kuula run_simulation salvestist või ava kõnelink ja räägi mustandiga ise.
  8. Juuruta, kui seda ü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.