ThunderPhone v3 je dostupan.Postavite sve sami, već od 2 ¢/min.Pročitajte objavu

Getting Started

Gradite uz Claude Code, Codex ili Cursor

Instalirajte ThunderPhone Agent Skills, povežite ThunderPhone MCP poslužitelj i omogućite agentu za programiranje pristup aktualnoj dokumentaciji proizvoda.

ThunderPhone pruža tri sloja za agente za programiranje:

SlojŠto pruža agentu
Vještine agentaUsmjereni postupci za agente, upite, brojeve, pozive, alate, web-dojave, znanje, testiranje, poboljšavanje agenta u zatvorenoj petlji, kampanje, widgete, okvire za rad u stvarnom vremenu i migracije.
MCPAutentificirani alati obuhvaćaju agente, brojeve, pozive, testiranje, znanje, alate/web-dojave, kampanje, glasove, uvoze i dokumentaciju kako se uvode; pozovite tools/list za aktualni katalog.
Izvorna dokumentacijaAktualni izvori u Markdownu za ponašanje proizvoda i pojedinosti API-ja.

Vještine objašnjavaju kako obaviti posao. MCP omogućuje agentu za programiranje da pregleda vašu organizaciju i izvršava radnje u njoj. Sirova dokumentacija pruža izvorni materijal za pitanja izvan učitane vještine.

Instalirajte u projekt

Ovaj blok instalira vještine, čini ključ dostupnim trenutačnoj ljusci i dodaje MCP poslužitelj na razini projekta u Claude Code. Zamijenite rezervirano mjesto stvarnom vrijednošću iz upravitelja tajni; ne lijepite ključ u repozitorij ili chat.

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 zamijenite posljednju naredbu sljedećom:

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

Cursor čita konfiguraciju 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 koristi isti poslužitelj pod ključem servers u .vscode/mcp.json:

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

Primjer sesije: dvojezični recepcijski agent stomatološke ordinacije

  1. Zatražite od agenta za programiranje da učita create-agent, thunderphone-prompt-builder, build-tool-integration, add-knowledge i test-agent. Recite mu da najprije izradi plan i da još ne stvara resurse.
  2. Dajte mu provjerene podatke o ordinaciji, podržane zadatke, pravila eskalacije i dva potrebna lokaliteta. Zatražite da provjeri katalog dostupnih glasova i podržane jezike uživo umjesto da izmišlja glas ili lokalitet.
  3. Zatražite jedan produkcijski prompt izrađen na temelju općih načela i činjenica. Agent treba prijeći na podržani jezik pozivatelja, govor zadržati sažetim, postavljati jedno pitanje odjednom i izbjegavati skripte odgovora pozivatelja.
  4. Neka definira ograničeni alat za zakazivanje i priloži samo znanje koje recepcijski agent treba. Prije objave testirajte uspjeh alata, nedostupnost termina, neispravan unos, prekoračenje vremena i preusmjeravanje na osobu.
  5. Generirajte scenarije za oba jezika, prekide, ispravke, nedostajuće informacije, pitanja o znanju, neuspjehe zakazivanja i eskalaciju. Pokrenite ih, pregledajte transkripte i dokaze alata, ispravite najmanje opće pravilo i ponovno pokrenite isti skup.
  6. Pregledajte točan nacrt i dokaze testiranja, zatim izričito odobrite objavu i pridruživanje broja. Uputite kontrolirani audio poziv na svakom jeziku prije preusmjeravanja stvarnih poziva.

Poboljšajte agenta u zatvorenoj petlji

Kad agent počne primati pozive, zatražite od agenta za programiranje da učita iterate-on-agent. Vještina pokreće istu petlju koju ThunderPhone koristi za vlastite agente, tako da se svaka promjena mjeri prije puštanja u rad:

  1. Pročitajte glasovnog agenta, njegove revizije prompta i vodič za stil prompta. Revizije prompta dostupne su putem REST-a i MCP-a, pa agent za programiranje može izravno pregledati nedavne promjene prompta.
  2. Izradite skupove za testiranje. import_conversations pretvara nedavne pozive ili odabrane pozive prema call_ids u testne razgovore i njihove najzahtjevnije trenutke u primjere s ključevima odgovora. Ako izrada primjera nije uspjela za neke uvezene razgovore, pokrenite import_conversations s redo_failed: true da biste ponovno izradili primjere za te razgovore agenta bez uvoza poziva. generate_conversations zapisuje ih za novog agenta, uključujući zahtjevne pozivatelje usmjerene na slabe točke prompta (oni uvijek idu u dev podjelu). Svaki se razgovor nalazi u dev podjeli za podešavanje ili testnoj podjeli za jednokratno mjerenje. Poziv čiji je pozivatelj u testnoj podjeli izdvojen je: API ključu ili OAuth tokenu, putem REST-a i MCP-a, vraća se samo njegov ID, vrijeme početka i held_out: true, upisi u njega odbijaju se (held_out_call), a odbijaju se i testni scenariji promovirani iz njega; izostavite ga pri podešavanju.
  3. Uspostavite početnu vrijednost pomoću run_replays u dev podjeli. Uz Bolt v2, potez sa snimljenim zvukom ponovno se izvodi kao što bi ga izveo stvarni poziv.
  4. Uredite nacrt. review_prompt provjerava prompt prema vodiču za stil i nudi izmjene za pronalaženje i zamjenu; update_agent ih primjenjuje na nacrt pomoću prompt_edits; druga provjera s previous_prompt provjerava što se promijenilo. refactor_prompt prepisuje prompt koji je prikupio previše zakrpa i prijavljuje svako ponašanje koje je promijenio. Kada izmjena doda ili ukloni ponašanje, refresh_conversations usklađuje testne razgovore s novim promptom, vraćajući ranije verzije ondje gdje se pravilo vratilo.
  5. Provjerite pomoću run_replays u odnosu na početnu vrijednost, tumačeći neuspjehe onako kako bi ih čuo pozivatelj. compare_configs isprobava drukčiju razinu slušanja, glas, određivanje završetka govora ili razinu inteligencije na istim dev primjerima; usporedbe su samo za dev.
  6. Izmjerite jednom u testnoj podjeli. Testno pokretanje ponovno izvodi jednu cijelu testnu kohortu i prvi rezultat je troši, pa svako kasnije testno pokretanje, za bilo koji prompt, treba svježe testne podatke iz uvezenih poziva ili generiranih razgovora. Pokretač svakog primjera postavlja se prije pokretanja prema njegovim podacima (snimljeni zvuk ponovno se izvodi točno, primjeri samo s tekstom kao tekst). Ukupni rezultati dolaze po pokretaču i ništa se ne vraća na tekst: kohorta sa snimljenim zvukom pod konfiguracijom koja nije Bolt v2 odbija se (test_needs_exact_replay) i ostaje neiskorištena, pa tu konfiguraciju mjerite u dev podjeli. Agenti za programiranje dobivaju samo ukupne rezultate, uz usporedno tumačenje jednostavnim jezikom za dev pokretanja, pa se ne mogu podešavati na testnoj podjeli.
  7. Poslušajte snimku run_simulation ili otvorite poveznicu za razgovor i sami razgovarajte s nacrtom.
  8. Implementirajte kada to odredite.

Sve što troši kredite najprije pribavlja ponudu: pošaljite dry_run: true za procjenu, a zatim pokrenite s pripadajućima quote_id i max_cost_cents, što je čvrsto ograničenje. Ponuda plaća jedno pokretanje: poslovi razgovora, pokretanja ponavljanja te pregledi i refaktoriranja uputa koji pozivaju model trajno je potroše pri pokretanju. Plaćena pokretanja koja pokrenete svojim API ključem, OAuth aplikacijom ili MCP-om također se uračunavaju u isto ograničenje alata koje je vaša organizacija omogućila, a pokretanje koje je odbijeno ili prvo ne uspije ostavlja je dostupnom; nakon što je iskorištena, ponovite neuspjelo pokretanje s novim probnim pokretanjem. Svaki zahtjev rezervira najveći mogući trošak prije slanja, a pokretanje se naplaćuje prema stvarnom trošku, stoga ostavite prostor u procjeni. Točno ponavljanje rezervira oko 85 centi do 1,25 USD po ponavljanju u tijeku za tipičan potez (uobičajen potez plus jedno ponovno pokretanje u produkciji), uz stvarni trošak od nekoliko centi: pokretanjima ponavljanja dodijelite ograničenje s dovoljno prostora. Potez koji i dalje premaši proračun računa se zasebno i ne troši nijednu testnu kohortu. Agent istodobno pokreće jedan posao razgovora ili jedno pokretanje ponavljanja. Uz OAuth alati za upute trebaju opseg agents:write. Kada se snimanje poziva isključi ili se poziv izbriše, uklanjaju se i testni razgovori i primjeri preuzeti iz njega. Alati za testne razgovore, ponavljanja i pregled uputa dio su skupa alata za iteraciju agenta, koji se omogućuje po organizaciji dok je u beta fazi (poveznice za razgovor uključene su za svaku organizaciju); zatražite od podrške da ga uključi.

Koristite Python ili TypeScript SDK za tipizirane REST zahtjeve.

Koristite REST umjesto MCP-a kada izrada zahtijeva determinističke korisne terete, verzionirane testne podatke, skupnu orkestraciju ili operaciju koja nije prisutna na trenutačnom popisu MCP alata. API počinje na https://api.thunderphone.com/v1; pogledajte uvod u API i MCP vodič.