ThunderPhone v3 je tu.Začnite sami, už od 2 ¢/min.Prečítať oznámenie

Getting Started

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 SkillsCielené 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.
MCPAutentifikované 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áciaAktuá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/mcp

Pre 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_KEY

Cursor 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

  1. Požiadajte programovacieho agenta, aby načítal create-agent, thunderphone-prompt-builder, build-tool-integration, add-knowledge a test-agent. Povedzte mu, aby najprv vytvoril plán a zatiaľ nevytváral žiadne zdroje.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. 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:

  1. 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.
  2. Vytvorte testovacie sady. import_conversations premení nedávne hovory alebo vybrané hovory podľa call_ids na 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, spustite import_conversations s redo_failed: true, aby sa znova vytvorili príklady pre tieto konverzácie agenta bez importovania akýchkoľvek hovorov. generate_conversations ich 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 a held_out: true, zápisy doň sú odmietnuté (held_out_call) a rovnako aj testovacie scenáre z neho povýšené; pri ladení ho vynechajte.
  3. Vytvorte referenčný stav pomocou run_replays vo vývojovej množine. Pri Bolt v2 sa replika so zaznamenaným zvukom prehrá tak, ako by ju spracoval živý hovor.
  4. Upravte návrh. review_prompt skontroluje prompt podľa štýlovej príručky a ponúkne úpravy typu nájsť a nahradiť; update_agent ich použije na návrh pomocou prompt_edits; druhá kontrola s previous_prompt overí, čo sa zmenilo. refactor_prompt prepíš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_conversations aktualizuje testovacie konverzácie podľa nového promptu a obnoví staršie verzie tam, kde sa pravidlo vrátilo.
  5. Overte pomocou run_replays oproti referenčnému stavu a posudzujte zlyhania tak, ako by ich počul volajúci. compare_configs skúš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.
  6. 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.
  7. Vypočujte si nahrávku run_simulation alebo otvorte odkaz na rozhovor a sami sa porozprávajte s návrhom.
  8. 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.