Open in
Vytvárajte s Claude Code, Codex alebo Cursor
Nainštalujte ThunderPhone Agent Skills, pripojte server ThunderPhone MCP a poskytnite programovaciemu agentovi aktuálnu dokumentáciu k produktu.
ThunderPhone poskytuje tri vrstvy pre programovacích agentov:
| Vrstva | Čo poskytuje agentovi |
|---|---|
| Agent Skills | Cielené postupy pre agentov, prompty, čísla, hovory, nástroje, webhooky, znalosti, testovanie, zlepšovanie agenta v uzavretej slučke, kampane, widgety, frameworky pre reálny čas a migrácie. |
| MCP | Autentifikované nástroje pokrývajú agentov, čísla, hovory, testovanie, znalosti, nástroje/webhooky, kampane, hlasy, importy a dokumentáciu podľa toho, ako sú sprístupňované; pre aktuálny katalóg zavolajte tools/list. |
| Surová dokumentácia | Aktuálne zdroje v Markdown formáte pre správanie produktu a podrobnosti API. |
Skills vysvetľujú, ako vykonať prácu. MCP umožňuje programovaciemu agentovi preskúmať vašu organizáciu a vykonávať v nej akcie. Surová dokumentácia poskytuje zdrojový materiál pre otázky mimo načítaného skillu.
Inštalácia v projekte
Tento blok nainštaluje skills, sprístupní kľúč aktuálnemu shellu a pridá server MCP na úrovni projektu do Claude Code. Zástupný symbol nahraďte načítaním skutočnej hodnoty zo správcu tajomstiev; kľúč nevkladajte do repozitára ani chatu.
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/mcpPre Codex nahraďte posledný príkaz týmto:
codex mcp add thunderphone \
--url https://api.thunderphone.com/v1/mcp \
--bearer-token-env-var THUNDERPHONE_API_KEYCursor načíta konfiguráciu projektu zo súboru .cursor/mcp.json:
{
"mcpServers": {
"thunderphone": {
"type": "http",
"url": "https://api.thunderphone.com/v1/mcp",
"headers": {
"Authorization": "Bearer ${env:THUNDERPHONE_API_KEY}"
}
}
}
}VS Code používa rovnaký server pod kľúčom servers v súbore .vscode/mcp.json:
{
"servers": {
"thunderphone": {
"type": "http",
"url": "https://api.thunderphone.com/v1/mcp",
"headers": {
"Authorization": "Bearer ${env:THUNDERPHONE_API_KEY}"
}
}
}
}Príklad relácie: dvojjazyčný zubný recepčný agent
- Požiadajte programovacieho agenta, aby načítal
create-agent,thunderphone-prompt-builder,build-tool-integration,add-knowledgeatest-agent. Povedzte mu, aby najprv vytvoril plán a zatiaľ nevytváral žiadne zdroje. - Poskytnite mu overené fakty o ambulancii, podporované úlohy, pravidlá eskalácie a dve požadované lokality. Nech skontroluje aktuálny katalóg hlasov a podporované jazyky namiesto vymýšľania hlasu alebo lokality.
- Požiadajte o jeden produkčný prompt vytvorený zo všeobecných princípov a faktov. Agent má prepnúť do podporovaného jazyka volajúceho, udržiavať reč stručnú, klásť vždy jednu otázku a vyhýbať sa skriptom odpovedí volajúceho.
- Nech definuje úzko zameraný nástroj na plánovanie a pripojí len znalosti, ktoré recepčný agent potrebuje. Pred nasadením otestujte úspešné volanie nástroja, nedostupnú kapacitu, neplatný vstup, časový limit a odovzdanie človeku.
- Vygenerujte scenáre pre oba jazyky, prerušenia, opravy, chýbajúce informácie, otázky týkajúce sa znalostí, zlyhania plánovania a eskaláciu. Spustite ich, skontrolujte prepisy a dôkazy z nástrojov, opravte najmenšie všeobecné pravidlo a znova spustite rovnakú sadu.
- Skontrolujte presný návrh a dôkazy z testov, potom výslovne schváľte nasadenie a pripojenie čísla. Pred presmerovaním skutočnej prevádzky uskutočnite kontrolovaný zvukový hovor v každom jazyku.
Zlepšujte agenta v uzavretom cykle
Keď agent vybavuje hovory, požiadajte agenta na programovanie, aby načítal iterate-on-agent.
Táto zručnosť vykonáva rovnaký cyklus, aký ThunderPhone používa pre vlastných agentov, takže každá
zmena sa pred nasadením zmeria:
- Prečítajte si agenta, jeho revízie promptov a štýlovú príručku pre prompty. Revízie promptov sú dostupné cez REST a MCP, takže programovací agent môže priamo kontrolovať nedávne zmeny promptu.
- Vytvorte testovacie sady.
import_conversationspremení nedávne hovory alebo vybrané hovory podľacall_idsna testovacie konverzácie a ich najnáročnejšie momenty na príklady s kľúčmi správnych odpovedí. Ak vytvorenie príkladov zlyhalo pre niektoré importované konverzácie, spustiteimport_conversationssredo_failed: true, aby sa znova vytvorili príklady pre tieto konverzácie agenta bez importovania akýchkoľvek hovorov.generate_conversationsich vytvorí pre nového agenta vrátane náročných volajúcich zameraných na slabé miesta promptu (tie vždy patria do vývojovej množiny). Každá konverzácia patrí do vývojovej množiny na ladenie alebo do testovacej množiny na jednorazové meranie. Hovor, ktorého volajúci je v testovacej množine, je vyčlenený: pre kľúč API alebo token OAuth sa cez REST aj MCP vráti iba jeho identifikátor, čas začatia aheld_out: true, zápisy doň sú odmietnuté (held_out_call) a rovnako aj testovacie scenáre z neho povýšené; pri ladení ho vynechajte. - Vytvorte referenčný stav pomocou
run_replaysvo vývojovej množine. Pri Bolt v2 sa replika so zaznamenaným zvukom prehrá tak, ako by ju spracoval živý hovor. - Upravte návrh.
review_promptskontroluje prompt podľa štýlovej príručky a ponúkne úpravy typu nájsť a nahradiť;update_agentich použije na návrh pomocouprompt_edits; druhá kontrola sprevious_promptoverí, čo sa zmenilo.refactor_promptprepíše prompt, v ktorom sa nahromadilo príliš veľa opráv, a oznámi každé správanie, ktoré zmenil. Keď úprava pridá alebo odstráni správanie,refresh_conversationsaktualizuje testovacie konverzácie podľa nového promptu a obnoví staršie verzie tam, kde sa pravidlo vrátilo. - Overte pomocou
run_replaysoproti referenčnému stavu a posudzujte zlyhania tak, ako by ich počul volajúci.compare_configsskúša na rovnakých vývojových príkladoch inú úroveň rozpoznávania, hlas, určovanie konca prejavu alebo úroveň inteligencie; porovnania sú iba pre vývojové prostredie. - Merajte iba raz v testovacej množine. Testovací beh prehrá celú testovaciu
kohortu a jeho prvý výsledok ju spotrebuje, takže každý ďalší testovací beh pre ľubovoľný
prompt potrebuje nové testovacie údaje z importovaných hovorov alebo vygenerovaných
konverzácií. Modul každého príkladu sa pred behom nastaví podľa jeho
údajov (zaznamenaný zvuk sa prehráva presne, príklady iba s textom ako text).
Súhrny sa poskytujú podľa modulu a nič sa nevracia k textu: kohorta so
zaznamenaným zvukom pri konfigurácii inej než Bolt v2 sa odmietne
(
test_needs_exact_replay) a zostane nepoužitá, preto túto konfiguráciu merajte vo vývojovom prostredí. Programovacie agenty získajú iba súhrny spolu s porovnávacím zhrnutím v bežnom jazyku z vývojových behov, takže nemôžu ladiť v testovacej množine. - Vypočujte si nahrávku
run_simulationalebo otvorte odkaz na rozhovor a sami sa porozprávajte s návrhom. - Nasaďte ho, keď tak určíte.
Všetko, čo míňa kredity, najprv vyžaduje cenovú ponuku: na odhad odošlite dry_run: true, potom spustite operáciu s jej quote_id a max_cost_cents, pevným limitom. Jedna cenová ponuka pokrýva jedno spustenie: úlohy konverzácií, spustenia opätovného prehrávania a kontroly a refaktorizácie promptov, ktoré volajú model, ju pri spustení trvalo spotrebujú. Platené spustenia začaté vaším kľúčom API, aplikáciou OAuth alebo MCP sa tiež započítavajú do rovnakého limitu sady nástrojov, ktorý má vaša organizácia povolený,
a spustenie, ktoré je odmietnuté alebo najprv zlyhá, ju ponechá použiteľnú; po jej použití zopakujte neúspešné spustenie s novým skúšobným spustením. Každá požiadavka
pred odoslaním rezervuje svoje maximálne možné náklady a za spustenie sa účtuje
jeho skutočná cena, preto ponechajte rezervu z odhadu. Presné opätovné prehratie rezervuje
približne 85 centov až 1,25 USD na každé prebiehajúce opätovné prehratie pri typickej výmene
(bežná výmena plus jedno opätovné spustenie v produkcii), pričom skutočné náklady sú
niekoľko centov: pre spustenia opätovného prehrávania nastavte limit s rezervou. Výmena, ktorej
napriek tomu dôjde rozpočet, sa započíta oddelene a neminie žiadnu testovaciu kohortu. Agent
spúšťa naraz jednu úlohu konverzácie alebo jedno spustenie opätovného prehrávania. Pri OAuth nástroje
pre prompty vyžadujú rozsah agents:write. Keď sa vypne nahrávanie hovoru
alebo sa hovor odstráni, odstránia sa aj testovacie konverzácie a príklady z neho
prevzaté. Nástroje pre testovacie konverzácie,
opätovné prehrávanie a kontrolu promptov sú súčasťou sady nástrojov na iteráciu
agenta, ktorá sa počas beta verzie povoľuje pre každú organizáciu samostatne (odkazy na rozhovor
sú zapnuté pre každú organizáciu); požiadajte
o podporu o jej zapnutie.
Pre typované požiadavky REST použite Python alebo TypeScript SDK.
REST použite namiesto MCP, keď zostavenie vyžaduje deterministické dátové štruktúry, verzované
testovacie dáta, hromadnú orchestráciu alebo operáciu, ktorá sa nenachádza v aktuálnom zozname nástrojov MCP. API začína na https://api.thunderphone.com/v1; pozrite si
úvod k API a
príručku MCP.