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

Connect tools & data

Používajte ThunderPhone ako server MCP

Vytvárajte, testujte, overujte a prevádzkujte hlasových agentov ThunderPhone z Claude, ChatGPT, Claude Code, Codex, Cursor, VS Code alebo iného klienta Streamable HTTP MCP.

ThunderPhone poskytuje server Streamable HTTP Model Context Protocol na adrese:

https://api.thunderphone.com/v1/mcp

Ide o opačný smer než pri pripojení vzdialeného servera MCP k hlasovému agentovi:

SmerVýsledok
Vzdialený server MCP → agent ThunderPhoneHlasový agent môže volať nástroje vzdialeného servera.
ThunderPhone → váš klient MCPVáš programovací agent môže vytvárať, testovať a prevádzkovať ThunderPhone.

Overenie

Pre klientov adresára štandardne používajte OAuth: prihláste sa, vyberte organizáciu a schváľte požadované oprávnenia. Odpojte ho v časti Nastavenia → Zabezpečenie → Aplikácie, ktoré ste pripojili. Zmena alebo obnovenie hesla či zmena e-mailu účtu tiež zruší pripojenie, preto klienta následne znova pripojte.

Pre klientov nakonfigurovaných s kľúčom API vytvorte kľúč sk_live_ v časti Integrácie → Kľúče API a sprístupnite ho klientovi MCP ako THUNDERPHONE_API_KEY. Kľúč je viazaný na jednu organizáciu; identifikátor vlastnený inou organizáciou sa správa, akoby nebol nájdený.

Organizácie, ktoré pracujú s PHI

Ak hovory vašej organizácie môžu obsahovať chránené zdravotné informácie (PHI), pretože máte s ThunderPhone uzatvorenú dohodu BAA alebo sú vaši agenti určení na spracovanie PHI, uvedená adresa URL nikdy nevracia obsah hovorov: prepisy, nahrávky, hodnotenia, zoznamy hovorov, exporty, výsledky kampaní, analýzy hovorov a prehľady, konverzácie vytvorené zo skutočných hovorov a výsledky prehrávania. Tieto nástroje vrátia chybu s code: "phi_content_unavailable". Vytváranie, testovanie a konfigurácia agentov fungujú ako zvyčajne.

Táto adresa URL je uvedená vo verejných adresároch asistentov, ktoré nemusia obsahovať PHI. Ak má vaša organizácia vlastnú dohodu BAA s poskytovateľom asistenta, ktorá pokrýva pracovný priestor, ktorý používate:

  1. Správca organizácie otvorí v ThunderPhone Organizácia → Všeobecné → Prístup asistenta AI a potvrdí toto krytie.
  2. Namiesto toho pripojte asistenta ako vlastný konektor pomocou tejto adresy URL:
https://api.thunderphone.com/v1/mcp/baa

Obsah hovorov je potom dostupný tam vrátane hovorov, ktoré môžu obsahovať PHI. Zrušením potvrdenia sa prístup zastaví pri ďalšej požiadavke asistenta. Hovor, ktorý vaša organizácia spracovala ako hovor neobsahujúci PHI, je dostupný na oboch adresách URL.

Alternatívy CLI a stdio

CLI ThunderPhone môže zapísať konfiguráciu klienta so zachovaním nesúvisiacich serverov:

npx -y @thunderphone/mcp setup --client cursor --api-key-env THUNDERPHONE_API_KEY
npx thunderphone mcp setup --client claude-desktop --scope user

Po globálnej inštalácii @thunderphone/mcp použite thunderphone-mcp setup s rovnakými možnosťami. Nastavenie podporuje Claude Code, Codex, Cursor, VS Code, Gemini, Claude Desktop a Windsurf. Uprednostňuje sa priame HTTP; Desktop používa stdio.

Pre každého klienta podporujúceho stdio nakonfigurujte command: "npx" s args: ["-y", "@thunderphone/mcp"]. Obal najprv používa THUNDERPHONE_API_KEY, potom prihlasovacie údaje z príkazu thunderphone login, pričom obnovuje expirované tokeny, a následne OAuth prostredníctvom mcp-remote. Prihlásenie zariadenia a OAuth vyžadujú príslušné zavedenie OAuth API. Cesta s kľúčom API ho nevyžaduje. Priame konfigurácie HTTP nečítajú úložisko prihlasovacích údajov CLI; na opätovné použitie prihlásenia zariadenia použite obal stdio.

Ide o alternatívy k manuálnym konfiguráciám klienta uvedeným nižšie.

Konfigurácia klienta

Claude a ChatGPT sa prihlasujú cez OAuth; nepoužíva sa žiadny kľúč API. Ak ešte nemáte účet ThunderPhone, na prihlasovacej stránke vyberte Vytvoriť účet a po overení e-mailu sa vrátite na obrazovku schválenia.

Claude (web, počítač a mobil)

  1. Otvorte Prispôsobiť → Konektory (v starších verziách Nastavenia → Konektory). Ak sa ThunderPhone zobrazuje v adresári konektorov, vyberte ho. V opačnom prípade vyberte Pridať vlastný konektor, pomenujte ho ThunderPhone a zadajte https://api.thunderphone.com/v1/mcp.
  2. Vyberte Pripojiť, prihláste sa do ThunderPhone, vyberte organizáciu a schváľte povolenia.
  3. V chate zapnite ThunderPhone v ponuke nástrojov a požiadajte o to, čo potrebujete, napríklad „Zobraziť zoznam mojich agentov“.

Claude sa pred prvým použitím každého nástroja opýta na potvrdenie. Ak chcete väčšinu týchto výziev preskočiť, otvorte Prispôsobiť → Konektory → ThunderPhone a nastavte Nástroje len na čítanie na vždy povoliť. Tieto nástroje iba vyhľadávajú informácie: agentov, hovory, prepisy, zostatky, dokumentáciu. Ak chcete vidieť každú zmenu pred jej vykonaním, ponechajte pri Nástrojoch na zápis/odstránenie možnosť schválenia.

Vlastné konektory vyžadujú platený plán Claude. Pri plánoch Team a Enterprise vlastník najprv pridá konektor v nastaveniach konektorov organizácie a potom si každý člen pripojí vlastný účet ThunderPhone.

Čo je v Claude iné

Claude (konektor a doplnok Claude Code) má užšiu sadu nástrojov podľa pravidiel adresára konektorov Claude:

  • Každý hovor a textovú správu potvrdzujete samostatne. place_call a send_sms najprv vrátia náhľad (agent, čísla odosielateľa a príjemcu a pri textovej správe aj správu) spolu s confirmation_token; nič sa neuskutoční ani neodošle, kým Claude po vašom potvrdení nezopakuje požiadavku s tokenom.
  • Žiadna správa kampaní. create_campaign, add_campaign_contacts a campaign_action nie sú k dispozícii; kampane vytvárajte, načítavajte a spúšťajte na ovládacom paneli. list_campaigns, get_campaign_stats a check_campaign naďalej fungujú.
  • Žiadne test_integration. Požiadavku integrácie otestujte na jej stránke na ovládacom paneli.
  • preview_voice prehrá pevnú ukážkovú uvítaciu správu vo vami vybranom hlase a jazyku; nevyslovuje vlastný text.
  • list_voices a list_agents vracajú súhrn; get_agent obsahuje úplnú konfiguráciu agenta.

Oznámenie o AI

Každý hovor, ktorý agent ThunderPhone uskutoční alebo prijme, sa začína hovoreným oznámením o AI. Predvolene znie: „Tento hovor prebieha s asistentom AI a bude nahrávaný a prepísaný.“ Vypnutie tejto funkcie (consent_announcement_enabled nastavené na false alebo ai_live_processing_disclosure_override vypnuté) je odmietnuté, pokiaľ správca organizácie predtým na ovládacom paneli nezaznamenal podpísané potvrdenie, z ľubovoľného klienta vrátane Claude.

ChatGPT

  1. Ak sa ThunderPhone zobrazuje v adresári aplikácií ChatGPT, vyberte ho a pripojte sa.
  2. V opačnom prípade otvorte Nastavenia → Aplikácie a konektory → Rozšírené nastavenia, zapnite Režim vývojára a vytvorte konektor s adresou URL https://api.thunderphone.com/v1/mcp a autentifikáciou OAuth.
  3. Prihláste sa do ThunderPhone, vyberte organizáciu a schváľte povolenia. Pridajte ThunderPhone do chatu z ponuky nástrojov.

Odstránenie agenta alebo telefónneho čísla, zahodenie konceptu, spustenie kampane a odoslanie testovacej požiadavky, ktorá môže zapisovať do externého systému, vyžadujú v oboch aplikáciách druhé potvrdenie; pozrite si časť Potvrdzovanie deštruktívnych akcií.

Claude Code

claude mcp add --transport http thunderphone https://api.thunderphone.com/v1/mcp \
  --header "Authorization: Bearer $THUNDERPHONE_API_KEY"

Codex

Pridajte toto do ~/.codex/config.toml:

[mcp_servers.thunderphone]
url = "https://api.thunderphone.com/v1/mcp"
bearer_token_env_var = "THUNDERPHONE_API_KEY"

Cursor

Vytvorte .cursor/mcp.json:

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

Claude Desktop

Pridajte most mcp-remote do konfigurácie Claude Desktop:

{
  "mcpServers": {
    "thunderphone": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.thunderphone.com/v1/mcp",
        "--header",
        "Authorization: Bearer ${THUNDERPHONE_API_KEY}"
      ],
      "env": {
        "THUNDERPHONE_API_KEY": "sk_live_YOUR_API_KEY"
      }
    }
  }
}

VS Code

Vytvorte .vscode/mcp.json a zadajte kľúč prostredníctvom výzvy na zadanie vo VS Code:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "thunderphone-api-key",
      "description": "ThunderPhone organization API key",
      "password": true
    }
  ],
  "servers": {
    "thunderphone": {
      "type": "http",
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${input:thunderphone-api-key}"
      }
    }
  }
}

Nástroje

Každý nástroj obsahuje anotácie MCP. V tabuľkách R znamená iba na čítanie, D deštruktívny, I idempotentný a O interakciu s otvoreným svetom alebo sieťou. Pomlčka znamená, že nie je nastavená žiadna nápoveda.

Pripojenie

NástrojHlavné argumentyAnotácieČo robí
get_connection_identity—R, IOverí poverenie a vráti jeho organizáciu a bezpečné metadáta poverenia.

Agenti

NástrojHlavné argumentyAnotácieČo robí
list_agents—R, IZobrazí zoznam agentov.
get_agentagent_idR, IZíska jedného agenta.
create_agentkonfigurácia agenta—Vytvorí agenta. Prijíma rovnaké nastavenia ako update_agent vrátane steps, handoffs, intro_clip a intro_ring_count.
update_agentagent_id, zmenené polia, voliteľné prompt_edits, expected_prompt_sha256DPripraví polia v koncepte agenta a nahradí nimi obsah konceptu. Spustí sa bez kroku potvrdenia: nasadený agent zostane nezmenený až do deploy_agent a discard_agent_draft vráti koncept späť. Môžete tiež nastaviť max_hold_seconds, system_tool_settings a words. Ak chcete zmeniť časť výzvy, odošlite prompt_edits (pozrite si Úprava výzvy na mieste).
deploy_agentagent_id, voliteľné if_updated_atD, IPovýši koncept do produkcie.
discard_agent_draftagent_id, voliteľné if_updated_at, confirmation_token pri druhej požiadavkeD, IZahodí pripravené zmeny. Dvojkrokový proces, pozrite si Potvrdzovanie deštruktívnych akcií.
duplicate_agentagent_id, voliteľné name—Skopíruje agenta v rámci organizácie.
delete_agentagent_id, confirmation_token pri druhej požiadavkeD, INatrvalo odstráni agenta. Dvojkrokový proces.
list_agent_versionsagent_idR, IZobrazí zoznam nasadených verzií konfigurácie.
list_prompt_revisionsagent_id, voliteľné source, limit, offsetR, IZobrazí zoznam každej zmeny textu výzvy agenta vrátane konceptov, pričom každá obsahuje rozdiel oproti revízii, ktorú nahradila. K dispozícii, keď je súprava nástrojov na iteráciu agenta dostupná pre vaše pripojenie (pozrite nižšie).
review_promptagent_id, voliteľné prompt, previous_prompt, quote_id, max_cost_cents—Skontroluje koncept výzvy (alebo text, ktorý odošlete) podľa príručky štýlu výziev. Každé zistenie cituje príslušnú pasáž, uvedie pravidlo a ponúkne úpravu nájsť a nahradiť; výsledok tiež uvádza správania, ktoré výzva vyžaduje, so stabilnými identifikátormi, informáciu, či je potrebná refaktorizácia, a pri vlastnej výzve agenta aj to, či jeho testovacie konverzácie potrebujú obnovu. Na agentovi nič nemení; inventár sa uloží s revíziou jeho výzvy. Ide o platenú operáciu, preto nie je označená ako iba na čítanie: najprv si vyžiadajte cenovú ponuku pomocou dry_run, potom ju znova spustite bez dry_run s vráteným quote_id a max_cost_cents. Tieto platené spustenia sa teraz započítavajú do rovnakého limitu súpravy nástrojov organizácie ako ostatné spustenia súpravy nástrojov. K dispozícii, keď je súprava nástrojov na iteráciu agenta dostupná pre vaše pripojenie (pozrite nižšie).
refactor_promptagent_id, voliteľné prompt, inventory, instructions, quote_id, max_cost_cents—Prepíše výzvu do podoby podľa príručky štýlu a namapuje každé správanie ako zachované, zlúčené, preformulované alebo odstránené. Vráti nový text a rozdiel a predvolene ho znova prečíta, aby oznámil behavior_changes (pridané, odstránené alebo zmenené) a behavior_preserved; použite ho pomocou update_agent. Platené: vyžiadajte si cenovú ponuku pomocou dry_run, potom ho raz spustite s vráteným quote_id a max_cost_cents. K dispozícii, keď je súprava nástrojov na iteráciu agenta dostupná pre vaše pripojenie (pozrite nižšie).
list_reusable_instructions—R, IZobrazí zoznam opakovane použiteľných pokynov: zdieľané pravidlá výziev pripojené k viacerým agentom prostredníctvom reusable_instruction_ids v update_agent.
create_reusable_instructionname, content—Vytvorí nepripojený opakovane použiteľný pokyn. Iba pre správcov.

Telefónne čísla a operátori

NástrojHlavné argumentyAnotácieČo robí
list_phone_numbers—R, IVypíše čísla organizácie a smerovanie.
get_phone_number_limits—R, IZíska využitie a limity spravovaných čísel.
provision_phone_numbervoliteľné area_code, city, state, idempotency_keyD, OZakúpi prichádzajúce číslo spravované ThunderPhone.
list_voip_connections—R, IVypíše pripojených telekomunikačných operátorov zákazníka.
search_voip_numbersconnection_id, country, type, voliteľné area_codeR, I, OVyhľadá v inventári operátora.
import_voip_numbersconnection_id, numbersD, OImportuje čísla, ktoré už vlastníte u operátora.
update_phone_numberphone_number_id, polia smerovania/označenia/webhookuDAktualizuje smerovanie čísla vrátane priradenia hlasového agenta.
delete_phone_numberphone_number_id, confirm, voliteľné release_at_provider, confirmation_token pri druhej požiadavkeD, I, OUvoľní číslo. Dvojkrokové.
get_voip_setup_sessionvoliteľné session_idR, INačíta riadené nastavenie operátora (stav, kontrolný zoznam, otázku, na ktorú čaká) alebo vypíše otvorené nastavenia. Nastavenie sa spúšťa v paneli, pretože vyžaduje heslo operátora. Len pre administrátorov.
answer_voip_setup_questionsession_id, question_id, answerOOdovzdá odpoveď používateľa do nastavenia. Heslá, súhlas s testovacím volaním, adresa servera, používateľské meno a povolenie ThunderPhone prihlásiť sa do účtu poskytovateľa sa zadávajú len v sprievodcovi nastavením; pri nich vráti odkaz na sprievodcu a nič neodošle.
save_voip_setupsession_id, voliteľné name, confirmation_token pri druhej požiadavkeD, I, OUloží pripojený koncept pripojenia, aby ho bolo možné používať. Dvojkrokové.
check_phone_numberphone_number alebo phone_number_idR, I, ODiagnostikuje jedno z vlastných čísel organizácie na základe dôkazov: smerovania, pripojenia, overenia, nedávnych volaní operátora a testovacích volaní a miesta, kam ho operátor smeruje.

SMS

NástrojHlavné argumentyAnotácieČo robí
send_smsfrom_number, to, body, idempotency_keyD, I, OOdošle jednu SMS v čistom texte cez pripojené číslo Twilio alebo Telnyx.

Hovory

NástrojHlavné argumentyAnotácieFunkcia
list_callsvoliteľné filtre, limit, offsetR, IZobrazí hovory s filtrami histórie hovorov REST vrátane exclude_test_calls.
get_callcall_idR, IZíska stav hovoru a metadáta.
get_call_transcriptcall_id, voliteľné liveR, IZíska prepis hovoru.
get_call_audio_urlcall_id, voliteľné downloadR, I, OVráti podpísanú adresu URL zvuku; zvuk nikdy neprenáša cez MCP.
get_call_gradecall_idR, IZíska najnovšie hodnotenie hovoru.
place_callagent_id, from_number, to_numberD, OUskutoční jeden neidempotentný odchádzajúci hovor.
export_callsfiltre hovorov, export_formatR, IExportuje až do limitu koncového bodu REST vo formáte JSON alebo CSV.
get_call_analyticsvoliteľné since_days, agent_idR, IAgreguje skutočné hovory podľa stavu, smeru, výsledku, hodnotenia a problému, pričom testovacie hovory počíta samostatne.
get_call_insightscall_ids (až 10)R, INaraz získa hodnotenie, výsledok, zhrnutie a zistené problémy viacerých hovorov.

Testovanie a overovanie

NástrojHlavné argumentyAnotácieČo robí
list_test_scenariosagent_idR, IVypíše testovacie scenáre.
create_test_scenarioagent_id, title, scenario_prompt, voliteľné podmienky—Vytvorí scenár.
generate_test_scenariosagent_id, voliteľné count, include_edge_cases, localeOGeneruje scenáre z výzvy agenta.
run_agent_testsagent_id, channel, consent_to_charge, voliteľný výber/maticaD, OSpustí scenáre cez web alebo telefóniu.
get_test_runagent_id, batch_idR, IZíska stav dávky a výsledky jednotlivých scenárov.
test_my_agentagent_id, consent_to_charge, voliteľné scenario_ids, count, wait_secondsD, OOtestuje agenta jedným volaním: spustí jeho uložené scenáre (ak žiadne nemá, niektoré vygeneruje) a až minútu čaká na verdikty, alebo vráti batch_id pre get_test_run. Účtuje sa rovnako ako run_agent_tests.
test_in_textagent_id, callers (1 až 3 opisy), voliteľné version, directionOBezplatný textový test: simulovaní volajúci sa prostredníctvom reálneho procesu textovo rozprávajú s návrhom agenta (alebo so živou verziou) a prepisy sa vrátia približne do minúty. Výsledky nástroja sú simulované.
run_simulationagent_id, consent_to_charge, voliteľné scenario_prompt, direction, languageD, OSpustí jeden simulovaný telefonický hovor medzi volajúcim s AI a návrhom agenta, aby si človek mohol vypočuť zmenu. Vráti beh v stave in_progress. Ak agent nahráva hovory, hovor sa nahráva a po skončení sa vyhodnotí. Účtuje sa ako testovací hovor, najprv z bezplatného testovacieho rozpočtu.
get_simulationsimulation_idR, IZíska stav simulovaného hovoru a po jeho skončení aj výstup: krátkodobú URL nahrávky a prepis, keď agent nahráva hovory, a známku po dokončení hodnotenia (predtým null).
list_validation_runsagent_idR, IVypíše nedávne behy validácie návrhu.
get_validation_statusagent_idR, IZíska najnovší stav validácie a zhodu návrhu.
list_conversationsagent_id, voliteľné split, sourceR, IVypíše konverzácie, na ktorých sa agent testuje. Vyžaduje súpravu nástrojov na iteráciu agenta.
get_conversationconversation_idR, IZíska jednu testovaciu konverzáciu s jej aktuálnymi ťahmi. Vyžaduje súpravu nástrojov na iteráciu agenta.
get_conversation_revisionsconversation_id, voliteľné limit, offsetR, IVypíše každú revíziu testovacej konverzácie: ako a prečo sa zmenila (obnovená kvôli zmene výzvy, vrátená zo staršej revízie), pridané, odstránené a zmenené správania, presunuté alebo vyradené príklady a rozdiel riadkov. Vyžaduje súpravu nástrojov na iteráciu agenta.
generate_conversationsagent_id, voliteľné count, styleOVytvorí simulované testovacie konverzácie s návrhom agenta a ich najnáročnejšie momenty premení na validačné príklady s kľúčmi odpovedí. Najprv získajte cenovú ponuku pomocou dry_run; skutočný beh vyžaduje jeho quote_id a max_cost_cents. Vyžaduje súpravu nástrojov na iteráciu agenta.
import_conversationsagent_id, voliteľné since_days, max_callsOPremení nedávne hovory agenta na testovacie konverzácie (najviac dve na volajúceho, hovory bez nahrávania sa preskočia) a ich najnáročnejšie momenty na príklady. Najprv získajte cenovú ponuku pomocou dry_run; skutočný beh vyžaduje jeho quote_id a max_cost_cents. Vyžaduje súpravu nástrojov na iteráciu agenta.
refresh_conversationsagent_id, voliteľné conversation_ids, from_prompt_revision_idOAktualizuje testovacie konverzácie agenta podľa jeho aktuálnej výzvy po pridaní, odstránení alebo zmene správaní: znovu ich priradí, obnoví staršiu revíziu (vrátane skutočného zvuku) alebo prepíše neaktuálne ťahy a vyradí príklady, ktorých ťah volajúceho už neexistuje. Najprv získajte cenovú ponuku pomocou dry_run; skutočný beh vyžaduje jeho quote_id a max_cost_cents. Vyžaduje súpravu nástrojov na iteráciu agenta.
get_conversation_jobjob_idR, IZíska úlohu generovania, importu alebo obnovenia: stav, doterajšie náklady vzhľadom na jej limit a to, čo vytvorila alebo obnovila. Vyžaduje súpravu nástrojov na iteráciu agenta.
run_replaysagent_id, voliteľné overrides, split, engine, sample_size, sample_seed, max_cost_cents, quote_id, dry_runD, OPrehrá vzorku príkladov agenta s jeho návrhom alebo s prepísaniami, ako je kandidátska výzva, hlas alebo úroveň, a každú odpoveď posúdi podľa kľúča odpovedí príkladu. Presné prehratia spúšťajú zaznamenaný zvuk ťahu tak, ako by ho spustil živý hovor; miera úspešnosti sa uvádza pre každý engine. Prehratia hovorov PHI sa spúšťajú ako PHI a konfigurácia, ktorú nedokážu spustiť (hlas ElevenLabs, experimentálny produkt), sa odmietne. dry_run vráti odhad, vyžrebované sample_seed a quote_id; skutočný beh odošle rovnakú požiadavku s týmto quote_id a sample_seed a s max_cost_cents, pevným limitom: každá požiadavka si pred odoslaním rezervuje svoju hornú hranicu a beh sa zastaví namiesto odoslania takej, ktorá sa nezmestí, preto ponechajte podľa odhadu rezervu largest_reservation_cents na každý pracovný proces. Presné prehratie si rezervuje najhorší prípad, približne 85 centov až 1,25 $ za každé prebiehajúce prehratie typického ťahu (súčasne bežia dve), oproti skutočnej cene niekoľkých centov; behu sa účtuje skutočná cena prehratí, preto nastavte max_cost_cents s rezervou. Presné prehratie beží s rozpočtom pre bežný ťah plus jedno opätovné spustenie, aké vykonáva produkcia (ďalší súboj odpovedí a opakovanie cez watchdog); ťah, ktorý potrebuje viac, sa zaznamená ako chyba replay_budget_exhausted, započíta sa samostatne ako budget_exhausted, nezahrnie sa do miery úspešnosti a v testovacej množine nespotrebuje žiadnu kohortu. V testovacej množine sa kohorta so zaznamenaným zvukom volajúceho pri konfigurácii inej než Bolt v2 odmietne (test_needs_exact_replay) a zostane nepoužitá: túto konfiguráciu merajte vo vývojovej množine. Vyžaduje súpravu nástrojov na iteráciu agenta.
compare_configsagent_id, configs (2 až 4, prvá je základná), voliteľné sample_size, sample_seed, max_cost_cents, quote_id, dry_runOPrehrá rovnaké príklady v každej konfigurácii a uvedie mieru úspešnosti, príklady opravené a pokazené oproti základnej konfigurácii, latenciu po prvý zvuk, ako často volajúci čakal na potvrdenie, tiknutia alebo ticho a náklady na ťah podľa enginu. Získajte cenovú ponuku pomocou dry_run rovnako ako pri run_replays. Iba vývojová množina: v testovacej množine sa odmietne (comparison_dev_only); porovnajte vo vývojovej množine a potom vybranú možnosť zmerajte pomocou run_replays. Vyžaduje súpravu nástrojov na iteráciu agenta.
get_replay_runrun_id, voliteľné include_traceR, IZíska súhrny behu prehratí, zmeny a výsledky jednotlivých príkladov aj jeho porovnávaciu skupinu. Presné prehratia, ktoré potrebovali viac než ich rozpočet, sa počítajú samostatne (budget_exhausted) mimo miery úspešnosti. Vyžaduje súpravu nástrojov na iteráciu agenta.
create_talk_linkagent_id, voliteľné variant_id, language, expires_in_minutesOVytvorí jednorazový odkaz, ktorý človek otvorí v prehliadači, aby sa rozprával s aktuálnym návrhom agenta, podobne ako tlačidlo Hovoriť na paneli. Odkaz predvolene vyprší po 30 minútach (najviac po 120); konverzácia sa účtuje ako testovací hovor Hovoriť. Pozrite si odkazy Hovoriť.

Nástroje označené ako nástroje vyžadujúce súpravu nástrojov na iteráciu agenta sú jej súčasťou; súprava nástrojov je počas beta verzie povolená pre každú organizáciu zvlášť a bez nej vracajú feature_not_enabled s informáciami o ďalšom postupe. Každá konverzácia agenta patrí do jeho vývojového alebo testovacieho rozdelenia. Testovacie rozdelenie slúži na meranie zmeny, nie na jej ladenie, preto nástroje konverzácií vracajú konverzáciu z testovacieho rozdelenia iba s jej identifikátorom, rozdelením, zdrojom, stavom a počtami. Spustenie prehrania v testovacom rozdelení prehrá jednu celú testovaciu kohortu (sample_size a sample_seed sa ignorujú), každý príklad na engini, ktorý umožňujú jeho údaje, nastavenom pred spustením podľa príkladu (presný pre zaznamenaný zvuk volajúceho, textový pre príklad iba s textom; konfigurácia iná než Bolt v2 nemá presnú cestu, takže kohorta so zaznamenaným zvukom sa pre ňu odmietne s test_needs_exact_replay a zostane nevyužitá; engine sa vynechá alebo nastaví na auto, pretože exact alebo text sa odmietne s test_engine_per_example a nič neprejde na textový režim) a vracia iba súhrny pre každý engine: mieru úspešnosti, zlyhania podľa závažnosti a typu, latenciu a náklady. Prvý jeho výsledok, ktorý uloží prehranie, spotrebuje kohortu, takže nasledujúce testovacie spustenie pre akýkoľvek prompt vezme ďalšiu, a ak už žiadna nezostala, odmietne sa s no_test_cohort (importovanie hovorov alebo generovanie konverzácií naplní nové kohorty); spustenie, ktoré sa skončí pred uložením prehrania (Core nemôže presne prehrať jeho zvukové príklady, exact_replay_unavailable, jeho kapacita prehrávania je stále zaneprázdnená, core_busy, alebo každému ťahu došiel rozpočet, replay_budget_exhausted), ponechá kohortu nevyužitú. Vo vývojovom rozdelení presné prehranie, ktoré Core nemôže vykonať, prejde na text a spustenie sa označí ako degraded. Porovnania sa spúšťajú iba vo vývojovom rozdelení. Každý platený nástroj prijíma quote_id zo svojho skúšobného spustenia, platný pre jedno spustenie: pri začatí spustenia sa raz natrvalo spotrebuje a začatie, ktoré sa odmietne alebo zlyhá predtým, ho ponechá použiteľný; spustenie, ktoré zlyhá potom, to oznámi a zopakuje sa s novým skúšobným spustením pre nový quote_id. Pri OAuth vyžadujú review_prompt a refactor_prompt rozsah agents:write, vrátane skúšobných spustení, a nástroje konverzácií a prehrávania vyžadujú na spustenie testing:write. Ľudia vidia celé testovacie rozdelenie na paneli. Hovor, ktorého volajúci je v testovacom rozdelení agenta, je vyčlenený, pretože je súčasťou testovacej množiny. V organizácii so súpravou nástrojov vracajú list_calls, get_call, get_call_transcript, get_call_audio_url, get_call_grade a export_calls presne {"call_id", "start_time", "held_out": true} (started_at namiesto start_time v riadkoch exportu), bez jeho prepisu, záznamu, histórie, hodnotenia alebo reportu; všetky ostatné polia hovoru chýbajú, preto najprv identifikujte vyčlenený riadok podľa jeho held_out. REST API robí to isté pre API kľúče a tokeny OAuth a jeho zobrazenia naprieč mnohými hovormi (súhrny reportov, zoskupenia problémov, vyšetrovania, reporty procesu) vynechávajú vyčlenené hovory z počtov, zoskupení a vzoriek a nezverejňujú žiadny text, ktorý z nich vytvoril model. Zápis do vyčleneného hovoru (hodnotenie, povýšenie na testovací scenár, opätovné vygenerovanie ťahu) sa odmietne s held_out_call. Testovací scenár, ktorý niekto povýšil z vyčleneného hovoru, sa z list_test_scenarios a v testovacích spusteniach vracia presne ako {"id", "held_out": true} a spustenie simulácie z neho sa z get_test_run a nástrojov simulácie vracia presne ako {"id", "scenario_id", "held_out": true}; vyčlenené sú aj jeho simulované hovory a testovacie spustenia ho naďalej spúšťajú. Vývojová konverzácia, príklad alebo výsledok prehrania skopírovaný z hovoru vyčleneného volajúceho (rozdelenia sú pre každého agenta, takže daný volajúci môže byť v testovacom rozdelení iného agenta) sa číta rovnako ako položka z testovacieho rozdelenia. Ľudia vidia vyčlenené hovory na paneli v plnom rozsahu a administrátor môže jednému API kľúču povoliť ich úplné zobrazenie (include_held_out_calls, predvolene vypnuté, nastavuje sa iba na paneli) pre integráciu, ktorá potrebuje každý hovor; MCP ho nikdy nepoužíva. Webhooky sa nemenia. Organizácie bez súpravy nástrojov nevidia pole held_out ani žiadnu zmenu.

generate_conversations, import_conversations a refresh_conversations spotrebúvajú modelové kredity. Najprv ich zavolajte s dry_run: true: odpoveďou je postupná cenová ponuka s quote_id a nič sa nespustí. Ponuka zohľadňuje každú požiadavku, ktorú môže beh vykonať pri typickej veľkosti. Skutočný beh vyžaduje dané quote_id (platnosť vyprší po 15 minútach a funguje iba s rovnakými argumentmi) a max_cost_cents, pevný limit: pred každou požiadavkou úloha rezervuje maximum, ktoré môže táto požiadavka stáť, a zastaví sa namiesto odoslania požiadavky, ktorá sa do limitu nezmestí, pričom zachová to, čo vytvorila. V dôsledku tejto rezervácie sa beh môže zastaviť s nevyužitou časťou limitu; largest_reservation_cents v ponuke uvádza, akú rezervu treba ponechať. Simulovaní volajúci sú vytvorení z promptu hlasového agenta; style: "adversarial" vytvára náročných volajúcich, ktorí skúšajú slabé miesta promptu, a tieto konverzácie vždy prechádzajú do vývojovej množiny. target: "changed_behaviors" zameriava volajúcich na zmeny vykonané pri poslednej úprave promptu. Každý hlasový agent môže naraz spúšťať jednu z týchto úloh alebo jeden beh opakovaného prehrania, takže obnovenie nikdy nemení príklady, na ktorých prebieha opakované prehranie; spustenie počas behu druhej úlohy vráti job_active, replay_run_active alebo conversation_job_active spolu s informáciou, na čo treba počkať.

Po úprave promptu, ktorá pridáva, odstraňuje alebo mení správanie, review_prompt pri návrhu hlasového agenta oznámi, koľko testovacích konverzácií bolo vytvorených pre prompt s inými správaniami (conversations.refresh_suggested). refresh_conversations ich potom aktualizuje na návrh, aby vývojová a testovacia množina merali nový prompt na históriách, ktoré mohol vytvoriť. Obnovenie nikdy nič nestratí: každá konverzácia si zachováva všetky predchádzajúce revízie a keď sa odstránené pravidlo vráti, obnoví sa revízia z obdobia, keď pravidlo existovalo, so skutočným zvukom volajúceho. Obnovenie spustené programovacím agentom vynecháva konverzácie z testovacej množiny a konverzácie skopírované z vyčlenených hovorov zo svojho výberu, ponuky, priebehu a nákladov; uvedenie jednej z nich v conversation_ids vráti 403 test_conversation. Tieto konverzácie obnovuje človek z ovládacieho panela a programovacím agentom výsledky tejto úlohy zobrazujú iba ich ID a počty. Príklad v stave active, ktorého históriu, odpoveď alebo kľúč správnych odpovedí obnovenie prepíše, sa vráti do stavu pending_review s označením refreshed_needs_review. Ponuka na obnovenie oceňuje každú konverzáciu, ktorú číta, akoby bola prepísaná, každé modelové volanie pri jeho maximálnom výstupnom limite a platí pre prompt aj konverzácie, pre ktoré bola vytvorená: ak sa pred spustením zmení niektorá z nich, vytvorte novú ponuku; ak sa prompt zmení počas behu, úloha sa zastaví v stave failed a zachová to, čo obnovila.

Znalosti

NástrojHlavné argumentyAnotácieČo robí
list_knowledge_bases—R, IZobrazí zoznam znalostných báz.
create_knowledge_basename, voliteľné description—Vytvorí znalostnú bázu.
add_knowledge_documentknowledge_base_id, name, content—Pridá text alebo Markdown.
import_knowledge_urlurl, voliteľné nameOZaradí verejnú stránku do frontu na bezpečné načítanie.
search_knowledgeknowledge_base_id, queryR, IVyhľadáva prostredníctvom produkčného vyhľadávania.

Integrácie, webhooky a vzdialené servery MCP

NástrojHlavné argumentyAnotácieČo robí
list_integrations—R, IVypíše integrácie funkcií HTTP.
create_integrationdisplay_name, funkcia spec, voliteľné polia koncového bodu—Vytvorí nástroj HTTP. Hlavičky autentifikácie pridajte na paneli.
test_integrationurl, voliteľná metóda/telo/časový limit, integration_id s header_names, confirmation_token pri druhej požiadavkeD, OOdošle obmedzenú testovaciu požiadavku chránenú pred SSRF. Uložené hodnoty hlavičiek sa doplnia z integrácie a odošlú sa iba na jej vlastného hostiteľa. POST (predvolené), PUT, PATCH a DELETE prebiehajú v dvoch krokoch; GET sa spustí okamžite.
list_webhook_endpoints—R, IVypíše podpísané koncové body webhookov.
list_webhook_deliveriesvoliteľné agent_id, voliteľné endpoint_idR, IVypíše nedávne výsledky doručenia webhookov bez obsahu.
create_webhook_endpointlabel, url, voliteľné udalosti/stavOVytvorí podpísaný koncový bod webhooku.
copy_webhook_endpointendpoint_id, target_agent_idISkopíruje webhook agenta vrátane podpisového tajomstva na iného agenta na serveri. Iba pre administrátorov.
test_webhook_endpointendpoint_idOOdošle syntetickú udalosť prostredníctvom bežného doručovania.
list_mcp_servers—R, IVypíše vzdialené servery, ktoré môžu používať hlasoví agenti.
create_mcp_serverdisplay_name, urlOZaregistruje a synchronizuje vzdialený server. Servery vyžadujúce hlavičky autentifikácie pridajte na paneli.
sync_mcp_server_toolsserver_idD, OObnoví katalóg nástrojov vzdialeného servera.

Kampane

NástrojHlavné argumentyAnotácieČo robí
list_campaigns—R, IZobrazí odchádzajúce kampane.
create_campaignpolia kampane—Vytvorí koncept kampane.
add_campaign_contactscampaign_id, contacts—Pridá až 5 000 kontaktov JSON.
campaign_actioncampaign_id, action, voliteľné consent_to_charge, confirmation_token pri druhej požiadavkeD, OSpustí akciu start, pause, resume alebo stop. Akcie start a resume majú dva kroky; pause a stop sa vykonajú okamžite.
get_campaign_statscampaign_idR, IZíska počítadlá a nedávne výsledky.
check_campaignvoliteľné campaign_id, contact_phone_number, contact_statusR, IVysvetlí, prečo kampaň nevolá: jej okno volania vo vlastnom časovom pásme, kontakty, ktorým treba zavolať teraz, a čo bráni vytáčaniu.

Nastavenia organizácie a blokovaní volajúci

NástrojHlavné argumentyAnotácieČo robí
get_org_settings—R, INačíta časové pásmo, pracovné hodiny, testovacie čísla, označenia výsledkov hovorov, názvy stavov a informáciu o tom, ktoré upozornenia sú vypnuté, spolu s updated_at.
update_org_settingszmenené nastavenia, if_updated_at, confirmation_token na vyžiadanieD, IZmení ich (len správcovia). Zoznamy a objekty nahradia uloženú hodnotu. Vypnutie upozornenia alebo pridanie testovacieho čísla prebieha v dvoch krokoch. Výsledok obsahuje pôvodné hodnoty na vrátenie zmien.
get_account_limits—R, IZíska limity platformy s vlastnými hodnotami tejto organizácie.
list_blocked_callersvoliteľné number, searchR, IVypíše blokované čísla volajúcich.
block_callersnumbers, voliteľné note, confirmation_token pri druhej požiadavkeD, IOdmietne hovory z týchto čísel skôr, než odpovie ktorýkoľvek agent. Dvojkrokové, len pre správcov.
unblock_callersnumbers, confirmation_token pri druhej požiadavkeD, IOdstráni čísla zo zoznamu blokovaných. Dvojkrokové, len pre správcov.

get_org_settings, update_org_settings a get_account_limits vyžadujú rozsah OAuth org:read alebo org:write; pri pripojení vytvorenom pred ich zavedením budete pri prvom použití požiadaní o jeho schválenie.

Možnosti, pomoc a importy

NástrojHlavné argumentyAnotácieČo robí
get_supported_languages—R, IVypíše jazyky, ktorými agenti hovoria, spolu s kódmi.
get_agent_capabilities—R, IUvedie, čo môže agent vykonať počas hovoru a ktoré nastavenia a integrácie existujú.
escalate_to_humansummaryOPožiada tím ThunderPhone o pomoc. Odpovie vám v ThunderPhone. Pre organizácie, ktoré môžu pracovať s PHI, opustí ThunderPhone iba neutrálna poznámka.
request_featuretitle, request, detailsOOdošle tímu ThunderPhone žiadosť o funkciu. Najviac tri na organizáciu za deň.
start_agent_importplatformR, IVráti odkaz na ovládací panel, kde zadáte svoj kľúč Vapi, Retell, ElevenLabs alebo Bland a vyberiete agentov. Žiadny nástroj tento kľúč nepreberá.
get_agent_importvoliteľné import_idR, IVypíše nedávne importy alebo stav jedného importu a namapovaných agentov.
commit_agent_importimport_id, voliteľné item_idsOVytvorí agentov z pripraveného importu na pozadí. Len pre správcov.

Hlasy, fakturácia a dokumentácia

NástrojHlavné argumentyAnotácieČo robí
list_voices—R, IZobrazí zoznam hlasov a podporovaných jazykov.
preview_voicevoice, language, textOVygeneruje ukážku a vráti podpísanú adresu URL.
list_voice_clones—R, IZobrazí zoznam vlastných klonov hlasov.
get_billing_summary—R, IZíska zostatok a záväzné ceny úrovní; nie sú k dispozícii žiadne zmeny platieb.
search_docsquery, voliteľné limitR, I, OPrehľadá index verejnej dokumentácie.
get_doc_pagepathR, I, ONačíta jednu verejnú stránku dokumentácie vo formáte Markdown.

Výsledky týkajúce sa agenta, hovoru, čísla, kampane alebo nastavenia obsahujú web_url, zodpovedajúcu stránku na ovládacom paneli, takže ju môžete otvoriť v ThunderPhone alebo tam pokračovať so Zeusom.

Všetky produktové nástroje používajú rovnaké kódové cesty REST ako verejné API. Overovanie REST, rozsah organizácie, roly, schvaľovanie fakturácie, kvóty, potvrdenie TCPA, bezpečnosť poskytovateľov a správanie auditu sa preto uplatňujú bez zmeny.

Úprava promptu na mieste

update_agent môže zmeniť časť konceptu promptu bez odoslania celého textu späť. prompt_edits je zoradený zoznam dvojíc na vyhľadanie a nahradenie v rovnakom formáte, aký vracajú review_prompt a refactor_prompt:

{
  "agent_id": 123,
  "expected_prompt_sha256": "9c1f…",
  "prompt_edits": [
    {
      "find": "Ask for their name and their phone number, then tell them we will call back.",
      "replace": "Tell them we will call back, then ask for their name. Once they answer, ask for their phone number."
    }
  ]
}

Server použije úpravy v danom poradí na aktuálny koncept promptu agenta (nasadený prompt, ak neexistuje koncept) a výsledok zapíše do konceptu rovnakou cestou ako pri update_agent s celým promptom. Každý reťazec find sa musí v prompte nachádzať presne raz v stave, v akom sa nachádza, keď príde rad na danú úpravu. Ak to neplatí, nič sa nezapíše a chyba uvedie úpravu:

KódVýznamČo urobiť
prompt_edit_not_foundText find sa nenachádza v aktuálnom koncepte promptu. edit_index uvádza, o ktorú úpravu ide.Znova načítajte agenta a presne skopírujte danú pasáž.
prompt_edit_ambiguousText find sa nachádza viac než raz. occurrences uvádza počet výskytov.Zahrňte viac okolitého textu.
stale_promptexpected_prompt_sha256 nie je SHA-256 aktuálneho konceptu promptu: po načítaní sa zmenil.Znova načítajte agenta, prepíšte zmenu podľa aktuálneho textu a odošlite jeho SHA-256.
conflictMedzi načítaním konceptu serverom a jeho zápisom prebehol iný zápis.Skúste to znova; tento požiadavok koncept nezmenil.

expected_prompt_sha256 je voliteľný a chráni aj zápis celého promptu. Použite prompt_sha256 z review_prompt alebo source_prompt_sha256 z refactor_prompt. Každé volanie, ktoré zmení prompt, vráti prompt_sha256 pre nový text, previous_prompt_sha256, ak server najprv načítal koncept, a next_step navrhujúci review_prompt s hodnotou previous_prompt nastavenou na text pred zmenou. REST API prijíma iba celý prompt: PATCH /v1/agents/{agent_id} s parametrami prompt a if_updated_at.

Potvrdzovanie deštruktívnych akcií

Nástroje označené D niečo menia alebo odstraňujú, prípadne začínajú vytáčať skutočných ľudí. Tie, ktoré nemožno vrátiť späť, vyžadujú dve požiadavky. Prvá požiadavka nič nezmení a vráti:

{
  "status": "confirmation_required",
  "action": "Delete agent",
  "target": { "id": 195, "name": "Front Desk Receptionist" },
  "confirmation_token": "…",
  "expires_in_seconds": 600,
  "next_step": "…"
}

Asistent používateľovi zobrazí, čo bude ovplyvnené, a požiada o potvrdenie. Potom požiadavku zopakuje s rovnakými argumentmi a s confirmation_token. Token je platný 10 minút, funguje iba raz (aj keď dané volanie zlyhá) a vzťahuje sa na jednu organizáciu, jednu osobu, jeden nástroj a jednu presnú sadu argumentov, takže odstránenie troch agentov vyžaduje tri potvrdenia. campaign_action s pause alebo stop tento krok preskočí, aby bolo možné spustenú kampaň vždy okamžite zastaviť, rovnako ako test_integration s GET. Niektoré nástroje D sa vykonajú v jednej požiadavke, pretože D označuje ich účinok, nie potvrdenie na strane servera: update_agent nahrádza obsah konceptu (discard_agent_draft ho vráti späť), deploy_agent nahrádza aktívnu konfiguráciu, update_phone_number presmeruje aktívne hovory, sync_mcp_server_tools nahrádza katalóg nástrojov vzdialeného servera, import_voip_numbers presmeruje čísla na vášho operátora, run_agent_tests a run_simulation môžu minúť kredit, send_sms a place_call kontaktujú skutočnú osobu (place_call si ponecháva vlastné potvrdenie súhlasu) a provision_phone_number zakúpi číslo. test_my_agent míňa testovací kredit a vyžaduje consent_to_charge. run_replays tiež míňa peniaze; jeho odhad dry_run a limit max_cost_cents nahrádzajú potvrdenie. Klient MCP vás môže aj tak požiadať o ich schválenie.

Niektoré zmeny, ktoré možno vrátiť späť, tiež vyžadujú potvrdenie: vždy block_callers, unblock_callers a save_voip_setup, update_org_settings, keď vypne upozornenie alebo pridá testovacie číslo, a update_agent, keď jeho attention_reasons vypnú jedno z upozornení agenta. Ich next_step vás požiada o potvrdenie presnej zmeny namiesto upozornenia, že ju nemožno vrátiť späť.

Úvodné prompty

prompts/list ponúka dvanásť opakovane použiteľných pracovných postupov:

  • create_inbound_receptionist
  • run_agent_tests
  • buy_and_attach_number
  • review_low_grade_calls
  • add_url_to_agent_knowledge
  • improve_agent_from_calls
  • check_change_before_deploy
  • test_my_agent
  • diagnose_phone_number
  • why_campaign_not_calling
  • call_report
  • import_agents

Pomocou prompts/get s uvedeným názvom promptu a jeho deklarovanými argumentmi získate správu používateľa pripravenú na spustenie.

Zdroje

resources/list sprístupňuje verejné referencie uložené vo vyrovnávacej pamäti:

URIObsah
thunderphone://docs/llms.txtVerejný index dokumentácie.
thunderphone://docs/quickstartMarkdown rýchleho začiatku.
thunderphone://pricingAktuálny verejný Markdown s cenami.
thunderphone://guides/prompt-styleSprievodca štýlom výziev pre hlasového agenta, podľa ktorého sa kontroluje review_prompt. Jeho identifikátory pokynov (P1, W2 a podobne) sa uvádzajú v zisteniach.
thunderphone://guides/working-with-thunderphoneAko má asistent pracovať s týmito nástrojmi: malé kolá práce na návrhu, kontrola pred každým nasadením, súhlas používateľa so všetkým živým alebo spoplatneným a nikdy nežiadať o tajné údaje.

Jeden zdroj načítate pomocou resources/read. Verejné načítania používajú krátky časový limit, limit 2 MiB a desaťminútovú vyrovnávaciu pamäť v procese.

Protokol a chyby

Server podporuje verzie protokolu 2025-06-18 a 2025-03-26; zopakuje podporovanú verziu klienta a v opačnom prípade vyberie 2025-06-18. Implementuje initialize, ping, nástroje, prompty, zdroje a notifikácie. Notifikácie vracajú 202 Accepted. Tento bezstavový server neposkytuje SSE listener ani odstránenie relácie, preto GET a DELETE vracajú 405 Method Not Allowed s Allow: POST.

Zlyhania nástrojov zostávajú úspešnými odpoveďami JSON-RPC s isError: true. Ich text obsahuje krátku vetu, po ktorej nasleduje blok JSON:

{
  "code": "insufficient_balance",
  "detail": "There is not enough prepaid balance.",
  "next_step": "Call get_billing_summary, add funds in Organization > Billing, then retry."
}

Pre place_call zostáva zachovaná odlišná predpona outbound_tcpa_confirmation_required:. Neznáme metódy JSON-RPC vracajú -32601 v odpovedi HTTP 200. Dávky JSON-RPC nie sú podporované v MCP 2025-06-18 a vracajú jasnú chybu neplatnej požiadavky -32600.