ThunderPhone 2.0 je tady.Spustíte sami, od 2 ¢/min.Přečíst oznámení

Getting Started

Vyvíjejte s Claude Code, Codex nebo Cursor

Nainstalujte dovednosti agenta ThunderPhone, připojte server ThunderPhone MCP a poskytněte programovacímu agentovi aktuální produktovou dokumentaci.

ThunderPhone poskytuje pro programovací agenty tři vrstvy:

VrstvaCo poskytuje agentovi
Dovednosti agentůZaměřené postupy pro agenty, prompty, čísla, hovory, nástroje, webhooky, znalosti, testování, zlepšování agenta v uzavřené smyčce, kampaně, widgety, realtime frameworky a migrace.
MCPOvěřené nástroje zahrnují agenty, čísla, hovory, testování, znalosti, nástroje/webhooky, kampaně, hlasy, importy a dokumentaci podle toho, jak jsou zpřístupňovány; aktuální katalog získáte voláním tools/list.
Surová dokumentaceAktuální zdroje v Markdownu pro chování produktu a podrobnosti API.

Dovednosti vysvětlují, jak práci provést. MCP umožňuje programovacímu agentovi kontrolovat vaši organizaci a provádět v ní akce. Surová dokumentace poskytuje zdrojový materiál pro otázky mimo načtenou dovednost.

Instalace do projektu

Tento blok nainstaluje dovednosti, zpřístupní klíč aktuálnímu shellu a přidá MCP server s rozsahem projektu do Claude Code. Zástupný text nahraďte načtením skutečné hodnoty ze správce tajemství; nevkládejte klíč do repozitáře 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

Pro Codex nahraďte poslední příkaz tímto:

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

Cursor načítá konfiguraci projektu z .cursor/mcp.json:

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

VS Code používá stejný server pod klíčem servers v souboru .vscode/mcp.json:

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

Ukázková relace: dvojjazyčný zubní recepční

  1. Požádejte programovacího agenta, aby načetl create-agent, thunderphone-prompt-builder, build-tool-integration, add-knowledge a test-agent. Řekněte mu, aby nejprve vytvořil plán a zatím nevytvářel žádné prostředky.
  2. Poskytněte mu ověřené údaje o ordinaci, podporované úkoly, pravidla eskalace a dvě požadované národní verze. Nechte ho ověřit aktuální katalog hlasů a podporované jazyky namísto vymýšlení hlasu nebo národní verze.
  3. Požádejte o jeden produkční prompt vytvořený na základě obecných principů a faktů. Agent by měl přepnout do podporovaného jazyka volajícího, mluvit stručně, pokládat vždy jednu otázku a vyhnout se scénářům odpovědí volajícího.
  4. Nechte ho definovat úzce zaměřený nástroj pro plánování a připojit pouze znalosti, které recepční potřebuje. Před nasazením otestujte úspěšné použití nástroje, nedostupnost termínů, neplatný vstup, časový limit a předání člověku.
  5. Vygenerujte scénáře pro oba jazyky, přerušení, opravy, chybějící informace, znalostní dotazy, selhání plánování a eskalaci. Spusťte je, zkontrolujte přepisy a důkazy z nástrojů, opravte nejmenší obecné pravidlo a znovu spusťte stejnou sadu.
  6. Zkontrolujte přesný návrh a důkazy z testů, poté výslovně autorizujte nasazení a připojení čísla. Před převedením skutečného provozu uskutečněte kontrolovaný zvukový hovor v každém jazyce.

Vylepšujte agenta v uzavřeném cyklu

Jakmile agent vyřizuje hovory, požádejte programovacího agenta, aby načetl iterate-on-agent. Tato dovednost spouští stejný cyklus, který ThunderPhone používá pro své vlastní agenty, takže se každá změna před nasazením změří:

  1. Přečtěte si agenta, jeho revize promptu a průvodce stylem promptů. Revize promptů jsou dostupné přes REST a MCP, takže programovací agent může přímo zkontrolovat nedávné změny promptu.
  2. Vytvořte testovací sady. import_conversations převede nedávné hovory na testovací konverzace a jejich nejtěžší okamžiky na příklady s klíči odpovědí; generate_conversations je vytvoří pro nového agenta, včetně náročných volajících zaměřených na slabá místa promptu (ti vždy patří do vývojové části). Každá konverzace patří buď do vývojové části pro ladění, nebo do testovací části pro jednorázové měření. Hovor, jehož volající je v testovací části, je vyřazen: pro klíč API i token OAuth, stejně přes REST i MCP, vrací pouze své ID, čas zahájení a held_out: true, zápisy do něj jsou odmítnuty (held_out_call) a stejně tak testovací scénáře z něj povýšené; při ladění jej vynechejte.
  3. Vytvořte výchozí stav pomocí run_replays ve vývojové části. S Bolt v2 se tah s nahraným audiem přehraje tak, jak by jej zpracoval živý hovor.
  4. Upravte návrh. review_prompt zkontroluje prompt podle průvodce stylem a nabídne úpravy typu najít a nahradit; update_agent je použije na návrh pomocí prompt_edits; druhá kontrola s previous_prompt ověří, co se změnilo. refactor_prompt přepíše prompt, který nasbíral příliš mnoho záplat, a oznámí každé chování, které změnil. Když úprava přidá nebo odebere chování, refresh_conversations aktualizuje testovací konverzace podle nového promptu a obnoví dřívější verze tam, kde se pravidlo vrátilo.
  5. Ověřte pomocí run_replays vůči výchozímu stavu a posuzujte selhání tak, jak by je slyšel volající. compare_configs vyzkouší jinou úroveň audia, hlas, detekci konce promluvy nebo úroveň inteligence na stejných vývojových příkladech; porovnání jsou pouze pro vývoj.
  6. Změřte jednou v testovací části. Testovací běh přehraje jednu celou testovací kohortu a jeho první výsledek ji vyčerpá, takže každý další testovací běh pro libovolný prompt vyžaduje čerstvá testovací data z importovaných hovorů nebo vygenerovaných konverzací. Modul každého příkladu se před během nastaví podle jeho dat (nahrané audio se přehrává přesně, příklady pouze s textem jako text). Souhrny jsou k dispozici podle modulu a nic se nepřepíná na text: kohorta s nahraným audiem v konfiguraci jiné než Bolt v2 je odmítnuta (test_needs_exact_replay) a zůstává nepoužitá, proto tuto konfiguraci měřte ve vývojové části. Programovací agenti získají pouze její souhrny, takže podle ní nemohou ladit.
  7. Poslechněte si nahrávku run_simulation nebo otevřete odkaz pro hovor a promluvte si s návrhem sami.
  8. Nasaďte ho, až to určíte.

Vše, co spotřebovává kredity, nejprve vytvoří cenovou nabídku: pro odhad odešlete dry_run: true a poté spusťte akci s jejími quote_id a max_cost_cents, což je pevný limit. Jedna cenová nabídka zaplatí jedno spuštění: úlohy konverzací, spuštění přehrání i kontroly a refaktorizace promptů, které volají model, ji při spuštění trvale spotřebují; spuštění, které je odmítnuto nebo nejprve selže, ji ponechá použitelnou. Po jejím použití zopakujte neúspěšné spuštění s novým dry runem. Každý požadavek před odesláním rezervuje maximální možnou cenu a spuštění je účtováno podle skutečné ceny, proto ponechte rezervu z odhadu. Přesné přehrání rezervuje pro typický tah přibližně 85 centů až 1,25 $ za každé probíhající přehrání (běžný tah plus jedno opětovné spuštění v produkci), zatímco skutečná cena činí několik centů: pro spuštění přehrání nastavte limit s rezervou. Tah, kterému i přesto dojde rozpočet, se započítává samostatně a nespotřebuje žádnou testovací kohortu. Agent spouští vždy pouze jednu úlohu konverzace nebo jedno spuštění přehrání. Při použití OAuth nástroje pro prompty vyžadují oprávnění agents:write. Když je nahrávání hovoru vypnuto nebo je hovor odstraněn, odstraní se také testovací konverzace a příklady z něj vytvořené. Nástroje pro testovací konverzace, přehrání, kontrolu promptů a odkazy pro hovory jsou součástí sady nástrojů pro iteraci agenta, která se během betaverze povoluje pro každou organizaci zvlášť; požádejte podporu o její zapnutí.

Pro typované požadavky REST použijte Python nebo TypeScript SDK.

Pokud sestavení vyžaduje deterministické datové části, verzované testovací sady, hromadnou orchestraci nebo operaci, která není v aktuálním seznamu nástrojů MCP, použijte místo MCP REST. Rozhraní API začíná na https://api.thunderphone.com/v1; viz úvod k API a průvodce MCP.