ThunderPhone v3 je zdaj na voljo.Začnite sami, že od 2 ¢/min.Preberite obvestilo

Connect tools & data

Uporabljajte ThunderPhone kot strežnik MCP

Gradite, preizkušajte, potrjujte in upravljajte glasovne agente ThunderPhone iz Claude, ChatGPT, Claude Code, Codex, Cursor, VS Code ali drugega odjemalca Streamable HTTP MCP.

ThunderPhone ponuja strežnik Streamable HTTP Model Context Protocol na naslovu:

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

To je nasprotna smer kot pri povezovanju oddaljenega strežnika MCP z glasovnim agentom:

SmerRezultat
Oddaljeni strežnik MCP → agent ThunderPhoneGlasovni agent lahko kliče orodja oddaljenega strežnika.
ThunderPhone → vaš odjemalec MCPVaš agent za programiranje lahko izdeluje, preizkuša in upravlja ThunderPhone.

Preverjanje pristnosti

Za odjemalce imenika privzeto uporabite OAuth: prijavite se, izberite organizacijo in odobrite zahtevana dovoljenja. Povezavo prekinite v Nastavitve → Varnost → Aplikacije, ki ste jih povezali. Povezavo prekliče tudi sprememba ali ponastavitev gesla oziroma sprememba e-poštnega naslova računa, zato odjemalca nato znova povežite.

Za odjemalce, konfigurirane s ključem API, ustvarite ključ sk_live_ v Integracije → Ključi API in ga odjemalcu MCP izpostavite kot THUNDERPHONE_API_KEY. Ključ je vezan na eno organizacijo; ID v lasti druge organizacije se obravnava, kot da ni bil najden.

Organizacije, ki obravnavajo PHI

Če klici vaše organizacije lahko vsebujejo zaščitene zdravstvene informacije (PHI), ker imate s ThunderPhone sklenjen BAA ali so vaši agenti določeni za obdelavo PHI, zgornji URL nikoli ne vrne vsebine klicev: prepisov, posnetkov, ocen, seznamov klicev, izvozov, rezultatov kampanj, analitike klicev in vpogledov, pogovorov, ustvarjenih iz resničnih klicev, ter rezultatov ponovitev. Ta orodja vrnejo napako s code: "phi_content_unavailable". Ustvarjanje, preizkušanje in konfiguriranje agentov deluje kot običajno.

Ta URL je naveden v javnih imenikih pomočnikov, ki morda ne smejo vsebovati PHI. Če ima vaša organizacija lasten BAA s ponudnikom pomočnika, ki pokriva delovni prostor, ki ga uporabljate:

  1. Skrbnik organizacije v ThunderPhone odpre Organizacija → Splošno → Dostop pomočnika z UI in potrdi to kritje.
  2. Pomočnika namesto tega povežite kot povezovalnik po meri s tem URL-jem:
https://api.thunderphone.com/v1/mcp/baa

Vsebina klicev je nato tam na voljo, vključno s klici, ki lahko vsebujejo PHI. Preklic potrditve jo ustavi ob naslednji zahtevi pomočnika. Klic, ki ga je vaša organizacija obravnavala kot klic brez PHI, je na voljo na obeh URL-jih.

Možnosti CLI in stdio

ThunderPhone CLI lahko zapiše konfiguracijo odjemalca, pri tem pa ohrani nepovezane strežnike:

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

Po globalni namestitvi paketa @thunderphone/mcp uporabite thunderphone-mcp setup z istimi možnostmi. Nastavitev podpira Claude Code, Codex, Cursor, VS Code, Gemini, Claude Desktop in Windsurf. Prednost ima neposredni HTTP; Desktop uporablja stdio.

Za vsak odjemalec, ki podpira stdio, konfigurirajte command: "npx" z args: ["-y", "@thunderphone/mcp"]. Ovojnica najprej uporabi THUNDERPHONE_API_KEY, nato poverilnice iz thunderphone login, pri čemer osveži potekle žetone, nato pa OAuth prek mcp-remote. Prijava z napravo in OAuth zahtevata ustrezno uvedbo OAuth API-ja. Pot s ključem API tega ne zahteva. Konfiguracije neposrednega HTTP ne berejo shrambe poverilnic CLI; za ponovno uporabo prijave z napravo uporabite ovojnico stdio.

To so alternative ročnim konfiguracijam odjemalca spodaj.

Konfiguracija odjemalca

Claude in ChatGPT se prijavita prek OAuth; ključ API ni potreben. Če še nimate računa ThunderPhone, na prijavni strani izberite Ustvarite račun; po potrditvi e-poštnega naslova se vrnete na zaslon za odobritev.

Claude (splet, namizje in mobilne naprave)

  1. Odprite Prilagoditev → Povezovalniki (v starejših različicah Nastavitve → Povezovalniki). Če se ThunderPhone prikaže v imeniku povezovalnikov, ga izberite. V nasprotnem primeru izberite Dodajte povezovalnik po meri, ga poimenujte ThunderPhone in vnesite https://api.thunderphone.com/v1/mcp.
  2. Izberite Poveži, prijavite se v ThunderPhone, izberite organizacijo in odobrite dovoljenja.
  3. V klepetu v meniju orodij omogočite ThunderPhone in zahtevajte, kar potrebujete, na primer »Prikaži seznam mojih agentov«.

Claude vas pred prvo uporabo vsakega orodja vpraša za potrditev. Če želite preskočiti večino teh pozivov, odprite Prilagoditev → Povezovalniki → ThunderPhone in nastavite Orodja samo za branje na vedno dovoli. Ta orodja samo poiščejo informacije: agente, klice, prepise, stanja dobroimetja in dokumentacijo. Če želite videti vsako spremembo, preden se izvede, pustite Orodja za pisanje/brisanje nastavljeno na odobritev.

Povezovalniki po meri zahtevajo plačljiv paket Claude. Pri paketih Team in Enterprise lastnik najprej doda povezovalnik v nastavitvah povezovalnikov organizacije, nato pa vsak član poveže svoj račun ThunderPhone.

Kaj je drugače v Claude

Claude (konektor in vtičnik Claude Code) ima ožji nabor orodij v skladu s pravilnikom imenika konektorjev Claude:

  • Vsak klic in sporočilo posebej potrdite. place_call in send_sms najprej vrneta predogled (agenta, izhodno in ciljno številko ter pri sporočilu besedilo) skupaj s confirmation_token; nič se ne izvede ali pošlje, dokler Claude po vaši potrditvi zahteve ne ponovi z žetonom.
  • Brez upravljanja kampanj. create_campaign, add_campaign_contacts in campaign_action niso na voljo; kampanje ustvarite, naložite in zaženite na nadzorni plošči. list_campaigns, get_campaign_stats in check_campaign še vedno delujejo.
  • Brez test_integration. Zahtevo integracije preizkusite na njeni strani na nadzorni plošči.
  • preview_voice predvaja fiksni vzorčni pozdrav v izbranem glasu in jeziku; ne izgovarja besedila po meri.
  • list_voices in list_agents vrneta povzetek; get_agent vsebuje celotno konfiguracijo agenta.

Razkritje uporabe umetne inteligence

Vsak klic, ki ga agent ThunderPhone opravi ali sprejme, se začne z zvočnim razkritjem uporabe umetne inteligence. Privzeto pove: »Ta klic poteka z asistentom umetne inteligence ter bo posnet in prepisan.« Izklop (consent_announcement_enabled nastavljen na false ali ai_live_processing_disclosure_override izklopljen) je zavrnjen, razen če je skrbnik organizacije predhodno na nadzorni plošči iz katerega koli odjemalca, vključno s Claude, zabeležil podpisano izjavo.

ChatGPT

  1. Če se ThunderPhone prikaže v imeniku aplikacij ChatGPT, ga izberite in povežite.
  2. V nasprotnem primeru odprite Nastavitve → Aplikacije in povezovalniki → Dodatne nastavitve, vklopite Način za razvijalce in ustvarite povezovalnik z URL-jem https://api.thunderphone.com/v1/mcp ter preverjanjem pristnosti OAuth.
  3. Prijavite se v ThunderPhone, izberite organizacijo in odobrite dovoljenja. ThunderPhone dodajte v klepet iz menija orodij.

Brisanje agenta ali telefonske številke, opuščanje osnutka, zagon kampanje in pošiljanje preskusne zahteve, ki lahko zapisuje v zunanji sistem, v obeh aplikacijah zahtevajo drugo potrditev; glejte Potrjevanje destruktivnih dejanj.

Claude Code

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

Codex

To dodajte v ~/.codex/config.toml:

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

Cursor

Ustvarite .cursor/mcp.json:

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

Claude Desktop

V konfiguracijo Claude Desktop dodajte most mcp-remote:

{
  "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

Ustvarite .vscode/mcp.json in vnesite ključ prek poziva za vnos v 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}"
      }
    }
  }
}

Orodja

Vsako orodje vključuje oznake MCP. V tabelah R pomeni samo za branje, D destruktivno, I idempotentno in O interakcijo z odprtim svetom/omrežjem. Pomišljaj pomeni, da ni nastavljena nobena oznaka.

Povezava

OrodjeGlavni argumentiOznakeKaj naredi
get_connection_identity—R, IPreveri poverilnico ter vrne organizacijo in varne metapodatke poverilnice.

Agenti

OrodjeGlavni argumentiOpombeKaj počne
list_agents—R, INavede agente.
get_agentagent_idR, IPridobi enega agenta.
create_agentkonfiguracija agenta—Ustvari agenta. Sprejme enake nastavitve kot update_agent, vključno z steps, handoffs, intro_clip in intro_ring_count.
update_agentagent_id, spremenjena polja, izbirna prompt_edits, expected_prompt_sha256DPolja shrani v osnutek agenta in nadomesti obstoječa polja osnutka. Zažene se brez koraka potrditve: objavljeni agent ostane nespremenjen do deploy_agent, discard_agent_draft pa povrne osnutek. Nastavite lahko tudi max_hold_seconds, system_tool_settings in words. Če želite spremeniti del poziva, pošljite prompt_edits (glejte Urejanje poziva na mestu).
deploy_agentagent_id, izbirni if_updated_atD, IObjavi osnutek v produkcijo.
discard_agent_draftagent_id, izbirni if_updated_at, confirmation_token pri drugi zahteviD, IZavrže pripravljene spremembe. Dvostopenjski postopek; glejte Potrjevanje destruktivnih dejanj.
duplicate_agentagent_id, izbirni name—Kopira agenta znotraj organizacije.
delete_agentagent_id, confirmation_token pri drugi zahteviD, ITrajno izbriše agenta. Dvostopenjski postopek.
list_agent_versionsagent_idR, INavede objavljene različice konfiguracije.
list_prompt_revisionsagent_id, izbirni source, limit, offsetR, INavede vsako spremembo besedila poziva agenta, vključno z osnutki, pri čemer vsaka vsebuje razliko glede na različico, ki jo je nadomestila. Na voljo, ko so vaši povezavi na voljo orodja za iteracije agenta (glejte spodaj).
review_promptagent_id, izbirni prompt, previous_prompt, quote_id, max_cost_cents—Pregleda osnutek poziva (ali besedilo, ki ga pošljete) glede na slogovni vodnik za pozive. Vsaka ugotovitev citira odlomek, navede smernico in ponudi urejanje z iskanjem in zamenjavo; rezultat navede tudi vedenja, ki jih poziv zahteva, s stabilnimi ID-ji, ali je potrebna preoblikovanje in, za lastni poziv agenta, ali je treba osvežiti njegove preizkusne pogovore. Na agentu ne spremeni ničesar; popis se shrani z različico njegovega poziva. Je plačljivo, zato ni označeno kot samo za branje: najprej pridobite ponudbo z dry_run, nato ga znova zaženite brez dry_run z vrnjenim quote_id in max_cost_cents. Ti plačljivi zagoni se zdaj vštevajo v isto organizacijsko kvoto orodij kot drugi zagoni orodij. Na voljo, ko so vaši povezavi na voljo orodja za iteracije agenta (glejte spodaj).
refactor_promptagent_id, izbirni prompt, inventory, instructions, quote_id, max_cost_cents—Prepiše poziv v obliko slogovnega vodnika in vsako vedenje označi kot ohranjeno, združeno, preoblikovano ali odstranjeno. Vrne novo besedilo in razliko ter ga privzeto znova prebere, da poroča o behavior_changes (dodanih, odstranjenih ali spremenjenih) in behavior_preserved; uporabite ga z update_agent. Plačljivo: pridobite ponudbo z dry_run, nato ga enkrat zaženite z vrnjenim quote_id in max_cost_cents. Na voljo, ko so vaši povezavi na voljo orodja za iteracije agenta (glejte spodaj).
list_reusable_instructions—R, INavede ponovno uporabna navodila: skupna pravila za pozive, povezana z mnogimi agenti prek reusable_instruction_ids v update_agent.
create_reusable_instructionname, content—Ustvari nepovezano ponovno uporabno navodilo. Samo za skrbnike.

Telefonske številke in ponudniki

OrodjeGlavni argumentiOpombeKaj naredi
list_phone_numbers—R, INavede številke organizacije in usmerjanje.
get_phone_number_limits—R, IPridobi uporabo in omejitve upravljanih številk.
provision_phone_numberizbirno area_code, city, state, idempotency_keyD, OKupi dohodno številko, ki jo upravlja ThunderPhone.
list_voip_connections—R, INavede povezane ponudnike stranke.
search_voip_numbersconnection_id, country, type, izbirno area_codeR, I, OPreišče zalogo številk ponudnika.
import_voip_numbersconnection_id, numbersD, OUvozi številke, ki so že v lasti pri ponudniku.
update_phone_numberphone_number_id, polja za usmerjanje/oznako/spletni kaveljDPosodobi usmerjanje številke, vključno z dodelitvijo agenta.
delete_phone_numberphone_number_id, confirm, izbirno release_at_provider, confirmation_token pri drugi zahteviD, I, OSprosti številko. Dvostopenjsko.
get_voip_setup_sessionizbirno session_idR, IPrebere vodeno nastavitev ponudnika (stanje, kontrolni seznam, vprašanje, na katerega čaka) ali navede odprte nastavitve. Nastavitev se začne na nadzorni plošči, ker potrebuje geslo ponudnika. Samo za skrbnike.
answer_voip_setup_questionsession_id, question_id, answerOPosreduje odgovor uporabnika nastavitvi. Na gesla, soglasje za testni klic, naslov strežnika, uporabniško ime in dovoljenje ThunderPhoneu za prijavo v račun ponudnika je mogoče odgovoriti samo v čarovniku za nastavitev; za te primere vrne povezavo do čarovnika in ne pošlje ničesar.
save_voip_setupsession_id, izbirno name, confirmation_token pri drugi zahteviD, I, OShrani povezan osnutek povezave, da ga je mogoče uporabljati. Dvostopenjsko.
check_phone_numberphone_number ali phone_number_idR, I, ODiagnostizira eno od lastnih številk organizacije na podlagi podatkov: usmerjanja, povezave, preverjanja, nedavnih klicev ponudnika in testnih klicev ter cilja, kamor jo ponudnik usmerja.

SMS

OrodjeGlavni argumentiOpombeKaj počne
send_smsfrom_number, to, body, idempotency_keyD, I, OPošlje eno navadno besedilno sporočilo SMS prek povezane številke Twilio ali Telnyx.

Klici

OrodjeGlavni argumentiOpombeKaj počne
list_callsizbirni filtri, limit, offsetR, INavede klice s filtri REST za zgodovino klicev, vključno z exclude_test_calls.
get_callcall_idR, IPridobi stanje klica in metapodatke.
get_call_transcriptcall_id, izbirni liveR, IPridobi prepis klica.
get_call_audio_urlcall_id, izbirni downloadR, I, OVrne podpisan URL zvočnega posnetka; zvoka nikoli ne pretaka prek MCP.
get_call_gradecall_idR, IPridobi najnovejšo oceno klica.
place_callagent_id, from_number, to_numberD, OIzvede en neidemponenten odhodni klic.
export_callsfiltri klicev, export_formatR, IIzvozi do omejitve končne točke REST v obliki JSON ali CSV.
get_call_analyticsizbirna since_days, agent_idR, IZdruži dejanske klice po stanju, smeri, izidu, oceni in težavi, pri čemer testne klice šteje ločeno.
get_call_insightscall_ids (do 10)R, IHkrati pridobi oceno, izid, povzetek in zaznane težave več klicev.

Testiranje in preverjanje

OrodjeGlavni argumentiOznakeKaj počne
list_test_scenariosagent_idR, INavede preskusne scenarije.
create_test_scenarioagent_id, title, scenario_prompt, izbirni pogoji—Ustvari scenarij.
generate_test_scenariosagent_id, izbirni count, include_edge_cases, localeOUstvari scenarije iz poziva agenta.
run_agent_testsagent_id, channel, consent_to_charge, izbirna izbira/matrikaD, OIzvede scenarije prek spleta ali telefonije.
get_test_runagent_id, batch_idR, IPridobi stanje paketa in rezultate posameznih scenarijev.
test_my_agentagent_id, consent_to_charge, izbirni scenario_ids, count, wait_secondsD, OPreskusi agenta z enim klicem: zažene njegove shranjene scenarije (nekaj jih ustvari, če jih nima) in na razsodbe čaka do ene minute ali vrne batch_id za get_test_run. Zaračuna se enako kot run_agent_tests.
test_in_textagent_id, callers (1 do 3 opisi), izbirna version, directionOBrezplačni besedilni preskus: simulirani klicatelji se prek dejanskega cevovoda v besedilu pogovarjajo z osnutkom agenta (ali aktivno različico), prepisi pa se vrnejo v približno eni minuti. Rezultati orodja so simulirani.
run_simulationagent_id, consent_to_charge, izbirni scenario_prompt, direction, languageD, OZačne en simuliran telefonski klic med klicateljem z UI in osnutkom agenta, da lahko oseba prisluhne spremembi. Izvajanje vrne v stanju in_progress. Posname se, kadar agent snema klice, in oceni po koncu. Zaračuna se kot preskusni klic, najprej iz brezplačnega preskusnega proračuna.
get_simulationsimulation_idR, IPridobi stanje simuliranega klica in po njegovem koncu, kaj je ustvaril: kratkotrajni URL posnetka in prepis, kadar agent snema klice, ter oceno po končanem ocenjevanju (pred tem null).
list_validation_runsagent_idR, INavede nedavna izvajanja preverjanja osnutka.
get_validation_statusagent_idR, IPridobi najnovejše stanje preverjanja in ujemanje osnutka.
list_conversationsagent_id, izbirna split, sourceR, INavede pogovore, na katerih se preskuša agent. Zahteva orodje za iteracije agenta.
get_conversationconversation_idR, IPridobi en preskusni pogovor z njegovimi trenutnimi potezami. Zahteva orodje za iteracije agenta.
get_conversation_revisionsconversation_id, izbirna limit, offsetR, INavede vse revizije preskusnega pogovora: kako in zakaj se je spremenil (osvežen zaradi spremembe poziva, obnovljen iz prejšnje revizije), dodana, odstranjena in spremenjena vedenja, premaknjene ali opuščene primere ter razliko med vrsticami. Zahteva orodje za iteracije agenta.
generate_conversationsagent_id, izbirna count, styleONapiše simulirane preskusne pogovore z osnutkom agenta in njihove najtežje trenutke spremeni v primere za preverjanje s ključi odgovorov. Najprej pridobite ponudbo z dry_run; dejansko izvajanje potrebuje svoj quote_id in max_cost_cents. Zahteva orodje za iteracije agenta.
import_conversationsagent_id, izbirna since_days, max_callsONedavne klice agenta spremeni v preskusne pogovore (največ dva na klicatelja, klici brez snemanja so preskočeni) in njihove najtežje trenutke v primere. Najprej pridobite ponudbo z dry_run; dejansko izvajanje potrebuje svoj quote_id in max_cost_cents. Zahteva orodje za iteracije agenta.
refresh_conversationsagent_id, izbirna conversation_ids, from_prompt_revision_idOPo dodajanju, odstranitvi ali spremembi vedenj uskladi preskusne pogovore agenta z njegovim trenutnim pozivom: ponovno jih usmeri, obnovi prejšnjo revizijo (vključno z dejanskim zvokom) ali prepiše zastarele poteze ter opusti primere, katerih poteze klicatelja ni več. Najprej pridobite ponudbo z dry_run; dejansko izvajanje potrebuje svoj quote_id in max_cost_cents. Zahteva orodje za iteracije agenta.
get_conversation_jobjob_idR, IPridobi opravilo ustvarjanja, uvoza ali osveževanja: stanje, dosedanji strošek glede na omejitev ter kaj je zapisalo ali osvežilo. Zahteva orodje za iteracije agenta.
run_replaysagent_id, izbirni overrides, split, engine, sample_size, sample_seed, max_cost_cents, quote_id, dry_runD, OPonovno predvaja vzorec primerov agenta z njegovim osnutkom ali s preglasitvami, kot so kandidatni poziv, glas ali nivo, ter vsak odgovor presodi glede na ključ odgovorov primera. Natančna ponovna predvajanja zaženejo posneti zvok poteze, kot bi ga aktivni klic; stopnje uspešnosti so navedene po pogonih. Ponovna predvajanja klicev PHI se izvajajo kot PHI, konfiguracija, ki jih ne more izvesti (glas ElevenLabs, eksperimentalni izdelek), pa je zavrnjena. dry_run vrne oceno, izbrani sample_seed in quote_id; dejansko izvajanje pošlje isto zahtevo s tem quote_id in sample_seed ter max_cost_cents, trdno omejitvijo: vsaka zahteva pred pošiljanjem rezervira svojo zgornjo mejo, izvajanje pa se ustavi, namesto da bi poslalo zahtevo, ki ne ustreza, zato za vsakega delavca pustite za oceno določen largest_reservation_cents rezerve. Natančno ponovno predvajanje rezervira najslabši primer, približno 85 centov do 1,25 $ na ponovno predvajanje v teku za običajno potezo (hkrati se izvajata dve), dejanski strošek pa znaša nekaj centov; izvajanje se zaračuna glede na dejanske stroške ponovnih predvajanj, zato pri max_cost_cents pustite rezervo. Natančno ponovno predvajanje se izvaja s proračunom za običajno potezo in eno ponovno izvedbo vrste, ki jo uporablja produkcija (ponovno tekmovanje odgovorov in ponovni poskus nadzornika); poteza, ki potrebuje več, se zabeleži kot napaka replay_budget_exhausted, ločeno se šteje kot budget_exhausted, ni vključena v stopnjo uspešnosti in pri preskusni razdelitvi ne porabi nobene kohorte. Pri preskusni razdelitvi je kohorta s posnetim zvokom klicatelja pri konfiguraciji, ki ni Bolt v2, zavrnjena (test_needs_exact_replay) in ostane neuporabljena: to konfiguracijo merite v razvojni razdelitvi. Zahteva orodje za iteracije agenta.
compare_configsagent_id, configs (2 do 4, prva je izhodiščna), izbirni sample_size, sample_seed, max_cost_cents, quote_id, dry_runOPonovno predvaja iste primere pri vsaki konfiguraciji in poroča o stopnji uspešnosti, primerih, popravljenih in pokvarjenih glede na izhodišče, zakasnitvi do prvega zvoka, kako pogosto je klicatelj čakal na potrditev, tiktakanje ali tišino ter strošku na potezo po pogonih. Pridobite ponudbo z dry_run kot pri run_replays. Samo razvojna razdelitev: pri preskusni razdelitvi je zavrnjeno (comparison_dev_only); primerjajte v razvojni razdelitvi, nato pa izbiro izmerite z run_replays. Zahteva orodje za iteracije agenta.
get_replay_runrun_id, izbirni include_traceR, IPridobi skupne vrednosti, spremembe in rezultate posameznih primerov izvajanja ponovnega predvajanja ter njegovo primerjalno skupino. Natančna ponovna predvajanja, ki so potrebovala več od svojega proračuna, se štejejo ločeno (budget_exhausted) in niso vključena v stopnjo uspešnosti. Zahteva orodje za iteracije agenta.
create_talk_linkagent_id, izbirni variant_id, language, expires_in_minutesOUstvari povezavo za enkratno uporabo, ki jo oseba odpre v brskalniku za pogovor s trenutnim osnutkom agenta, podobno kot gumb Pogovor na nadzorni plošči. Povezava privzeto poteče po 30 minutah (največ po 120); pogovor se zaračuna kot preskusni klic Pogovor. Glejte Povezave za pogovor.

Orodja, za katera je navedeno, da potrebujejo nabor orodij za iteracije agenta, so njegov del; nabor orodij je med beta različico omogočen za posamezno organizacijo, brez njega pa vrnejo feature_not_enabled z navodili za nadaljnje korake. Vsak pogovor agenta je v njegovi razvojni ali testni razdelitvi. Testna razdelitev je namenjena merjenju spremembe, ne njenemu prilagajanju, zato orodja za pogovore vrnejo pogovor iz testne razdelitve le z njegovim ID-jem, razdelitvijo, virom, stanjem in števci. Izvedba ponovitev v testni razdelitvi ponovno predvaja eno celotno testno kohorto (sample_size in sample_seed se prezreta), vsak primer na pogonu, ki ga dovoljujejo njegovi podatki, določenem pred izvedbo iz primera (natančno za posneti zvok klicatelja, besedilo za primer samo z besedilom; konfiguracija, ki ni Bolt v2, nima natančne poti, zato je kohorta s posnetim zvokom zanjo zavrnjena z test_needs_exact_replay in ostane neuporabljena; engine je izpuščen ali nastavljen na auto, saj sta exact in text zavrnjena z test_engine_per_example in nič ne preide na besedilo), ter vrne le skupne rezultate po pogonu: delež uspešnosti, neuspehe po resnosti in vrsti, zakasnitev ter strošek. Prvi rezultat, ki shrani ponovitev, porabi kohorto, zato naslednja testna izvedba za kateri koli poziv uporabi drugo; če jih ni več, je zavrnjena z no_test_cohort (uvoz klicev ali ustvarjanje pogovorov zapolni nove kohorte). Izvedba, ki se konča pred shranitvijo ponovitve (Core ne more natančno ponovno predvajati njenih zvočnih primerov, exact_replay_unavailable, njegova zmogljivost ponovitev je še vedno zasedena, core_busy, ali je vsakemu koraku zmanjkalo proračuna, replay_budget_exhausted), pusti kohorto neuporabljeno. V razvojni razdelitvi natančna ponovitev, ki je Core ne more izvesti, preide na besedilo, izvedba pa je označena kot degraded. Primerjave se izvajajo samo v razvojni razdelitvi. Vsako plačljivo orodje sprejme quote_id iz svoje suhe izvedbe, ki velja za eno izvedbo: ob začetku izvedbe se trajno porabi enkrat, začetek, ki je zavrnjen ali pred tem ne uspe, pa ga pusti uporabnega; izvedba, ki po začetku ne uspe, se ponovi z novo suho izvedbo za nov quote_id. Pri OAuth potrebujeta review_prompt in refactor_prompt obseg agents:write, vključno s suhimi izvedbami, orodja za pogovore in ponovitve pa za izvajanje potrebujejo testing:write. Osebe v nadzorni plošči vidijo celotno testno razdelitev. Klic, katerega klicatelj je v testni razdelitvi agenta, je izločen, ker je del testnega nabora. V organizaciji z naborom orodij list_calls, get_call, get_call_transcript, get_call_audio_url, get_call_grade in export_calls tak klic vrnejo natanko kot {"call_id", "start_time", "held_out": true} (v vrsticah izvoza je namesto start_time uporabljen started_at), brez prepisa, posnetka, zgodovine, ocene ali poročila; vsa druga polja klica so odsotna, zato zapis najprej prepoznajte po njegovem held_out, preden obdelate kar koli drugega. REST API enako velja za ključe API in žetone OAuth, njegovi pregledi več klicev (povzetki poročil, gruče težav, preiskave, poročila cevovoda) pa izločene klice izpustijo iz svojih števil, gruč in vzorcev ter zadržijo vsa besedila, ki jih je model ustvaril iz njih. Zapis v izločen klic (ocenjevanje, pretvorba v testni scenarij, ponovno ustvarjanje poteze) je zavrnjen z held_out_call. Testni scenarij, ki ga je nekdo pretvoril iz izločenega klica, se iz list_test_scenarios in v testnih izvedbah vrne natanko kot {"id", "held_out": true}, izvedba simulacije iz njega pa iz get_test_run in orodij za simulacije natanko kot {"id", "scenario_id", "held_out": true}; tudi njegovi simulirani klici so izločeni, testne izvedbe pa ga še vedno izvajajo. Razvojni pogovor, primer ali rezultat ponovitve, kopiran iz klica izločenega klicatelja (razdelitve so določene na agenta, zato je lahko ta klicatelj v testni razdelitvi drugega agenta), se obravnava kot tisti iz testne razdelitve. Osebe v nadzorni plošči izločene klice vidijo v celoti, skrbnik pa lahko enemu ključu API dovoli celoten ogled (include_held_out_calls, privzeto izklopljeno, nastavljivo samo v nadzorni plošči) za integracijo, ki potrebuje vsak klic; MCP tega nikoli ne uporablja. Spletne kljuke ostanejo nespremenjene. Organizacije brez nabora orodij ne vidijo polja held_out in nimajo nobenih sprememb.

generate_conversations, import_conversations in refresh_conversations porabljajo kredite za modele. Najprej jih pokličite z dry_run: true: odgovor je predračun stroškov po korakih z quote_id, pri čemer se ne izvede nič. Predračun upošteva vsako zahtevo, ki jo lahko izvajanje izvede pri običajnem obsegu. Dejanska izvedba potrebuje ta quote_id (poteče po 15 minutah in deluje samo z enakimi argumenti) ter max_cost_cents, trdo omejitev: pred vsako zahtevo opravilo rezervira največji možni strošek te zahteve in se ustavi, namesto da bi poslal zahtevo, ki ne ustreza omejitvi, pri tem pa ohrani, kar je zapisalo. Zaradi te rezervacije se lahko izvajanje ustavi z delom omejitve neporabljenim; largest_reservation_cents v predračunu pove, koliko rezerve pustite. Simulirani klicatelji so ustvarjeni na podlagi poziva agenta; style: "adversarial" ustvari zahtevne klicatelje, ki pritiskajo na šibke točke poziva, in ti pogovori vedno gredo v razvojni razdelek. target: "changed_behaviors" klicatelje usmeri na to, kar se je spremenilo pri zadnjem urejanju poziva. Vsak agent hkrati izvaja eno od teh opravil ali eno izvajanje ponovitev, zato osvežitev nikoli ne spremeni primerov, na katerih se izvajajo ponovitve; začetek med izvajanjem drugega vrne job_active, replay_run_active ali conversation_job_active skupaj s podatkom, na kaj je treba počakati.

Po urejanju poziva, ki doda, odstrani ali spremeni vedenje, review_prompt na osnutku agenta poroča, koliko testnih pogovorov je bilo ustvarjenih za poziv z drugimi vedenji (conversations.refresh_suggested). refresh_conversations jih nato uskladi z osnutkom, tako da razvojni in testni nabor merita novi poziv na zgodovinah, ki bi jih lahko ustvaril. Osvežitev nikoli ničesar ne izgubi: vsak pogovor ohrani vse prejšnje revizije, in ko se odstranjeno pravilo vrne, se obnovi revizija iz časa, ko je obstajalo, skupaj z dejanskim zvočnim posnetkom klicatelja. Osvežitev, ki jo zažene agent za programiranje, iz izbire, predračuna, napredka in stroškov izključi pogovore iz testnega razdelka ter pogovore, kopirane iz izločenih klicev; navedba katerega koli v conversation_ids vrne 403 test_conversation. Oseba jih osveži na nadzorni plošči, agentom za programiranje pa rezultati tega opravila prikažejo le njihove ID-je in števila. Primer active, katerega zgodovino, odgovor ali ključ odgovorov osvežitev znova napiše, se vrne v pending_review in je označen z refreshed_needs_review. Predračun osvežitve ovrednoti vsak pogovor, ki ga prebere, kot da bi bil znova napisan, vsak klic modela pa pri njegovi omejitvi izhoda, ter velja za poziv in pogovore, za katere je bil izdan: če se pred izvajanjem spremeni kar koli od tega, znova pridobite predračun; če se poziv spremeni med izvajanjem, se opravilo ustavi kot failed, pri tem pa ohrani, kar je osvežilo.

Znanje

OrodjeGlavni argumentiOznakeKaj naredi
list_knowledge_bases—R, INavede zbirke znanja.
create_knowledge_basename, izbirni description—Ustvari zbirko znanja.
add_knowledge_documentknowledge_base_id, name, content—Doda besedilo ali Markdown.
import_knowledge_urlurl, izbirni nameODoda javno stran v čakalno vrsto za varno zajemanje.
search_knowledgeknowledge_base_id, queryR, IPreišče produkcijsko pridobivanje podatkov.

Integracije, webhooki in oddaljeni strežniki MCP

OrodjeGlavni argumentiOznakeKaj počne
list_integrations—R, INavaja integracije funkcij HTTP.
create_integrationdisplay_name, specifikacija funkcije spec, izbirna polja končne točke—Ustvari orodje HTTP. Glave za preverjanje pristnosti dodajte na nadzorni plošči.
test_integrationurl, izbirni način/telo/časovna omejitev, integration_id z header_names, confirmation_token pri drugi zahteviD, OPošlje omejeno preskusno zahtevo, zaščiteno pred SSRF. Shranjene vrednosti glav se izpolnijo iz integracije in pošljejo samo njenemu lastnemu gostitelju. POST (privzeto), PUT, PATCH in DELETE potekajo v dveh korakih; GET se izvede takoj.
list_webhook_endpoints—R, INavaja podpisane končne točke spletnih kavljev.
list_webhook_deliveriesizbirni agent_id, izbirni endpoint_idR, INavaja nedavne rezultate dostave spletnih kavljev brez koristnega tovora.
create_webhook_endpointlabel, url, izbirni dogodki/stanjeOUstvari podpisano končno točko spletnega kavlja.
copy_webhook_endpointendpoint_id, target_agent_idIKopira spletni kavelj agenta, vključno s skrivnostjo za podpisovanje, na drugega agenta v strežniku. Samo za skrbnike.
test_webhook_endpointendpoint_idOPošlje sintetični dogodek prek običajne dostave.
list_mcp_servers—R, INavaja oddaljene strežnike, ki jih lahko kličejo glasovni agenti.
create_mcp_serverdisplay_name, urlORegistrira in sinhronizira oddaljeni strežnik. Strežniki, ki potrebujejo glave za preverjanje pristnosti, se dodajo na nadzorni plošči.
sync_mcp_server_toolsserver_idD, OOsveži katalog orodij oddaljenega strežnika.

Kampanje

OrodjeGlavni argumentiOpombeKaj naredi
list_campaigns—R, IPrikaže odhodne kampanje.
create_campaignpolja kampanje—Ustvari osnutek kampanje.
add_campaign_contactscampaign_id, contacts—Doda do 5.000 stikov JSON.
campaign_actioncampaign_id, action, izbirni consent_to_charge, confirmation_token pri drugi zahteviD, OIzvede start, pause, resume ali stop. start in resume sta dvostopenjska; pause in stop se izvedeta takoj.
get_campaign_statscampaign_idR, IPridobi števce in nedavne rezultate.
check_campaignizbirni campaign_id, contact_phone_number, contact_statusR, IPojasni, zakaj kampanja ne kliče: njeno okno klicanja v lastnem časovnem pasu, stike, ki so na vrsti zdaj, in kaj preprečuje izbiranje številk.

Nastavitve organizacije in blokirani klicatelji

OrodjeGlavni argumentiOpombeKaj naredi
get_org_settings—R, IPrebere časovni pas, delovni čas, preskusne številke, oznake izidov klicev, imena stanj in izklopljena opozorila skupaj z updated_at.
update_org_settingsspremenjene nastavitve, if_updated_at, confirmation_token, ko je zahtevanD, ISpremeni jih (samo skrbniki). Seznami in objekti zamenjajo shranjeno vrednost. Izklop opozorila ali dodajanje preskusne številke poteka v dveh korakih. Rezultat vsebuje stare vrednosti za razveljavitev.
get_account_limits—R, IPridobi omejitve platforme z vrednostmi, ki veljajo za to organizacijo.
list_blocked_callersizbirna number, searchR, INavede blokirane številke klicateljev.
block_callersnumbers, izbirna note, confirmation_token pri drugi zahteviD, IZavrne klice s teh številk, preden odgovori kateri koli agent. Dvokoračno, samo skrbniki.
unblock_callersnumbers, confirmation_token pri drugi zahteviD, IOdstrani številke s seznama blokiranih. Dvokoračno, samo skrbniki.

get_org_settings, update_org_settings in get_account_limits potrebujejo obseg OAuth org:read ali org:write OAuth scope; pri povezavi, vzpostavljeni pred njihovim obstojem, bo ob prvi uporabi zahtevana odobritev.

Zmožnosti, pomoč in uvozi

OrodjeGlavni argumentiOpombeKaj naredi
get_supported_languages—R, INavede jezike, ki jih govorijo agenti, skupaj s kodami.
get_agent_capabilities—R, IPove, kaj lahko agent naredi med klicem ter katere nastavitve in integracije obstajajo.
escalate_to_humansummaryOZaprosi ekipo ThunderPhone za pomoč. Odgovorijo v ThunderPhone. Za organizacije, ki lahko obravnavajo PHI, ThunderPhone zapusti le nevtralno obvestilo.
request_featuretitle, request, detailsOEkipo ThunderPhone obvesti o zahtevi za funkcionalnost. Največ tri na organizacijo na dan.
start_agent_importplatformR, IVrne povezavo do nadzorne plošče, kjer vnesete ključ za Vapi, Retell, ElevenLabs ali Bland in izberete agente. Nobeno orodje ne prevzame ključa.
get_agent_importizbirni import_idR, INavede nedavne uvoze ali stanje posameznega uvoza in preslikane agente.
commit_agent_importimport_id, izbirni item_idsOUstvari agente iz pripravljenega uvoza v ozadju. Samo skrbniki.

Glasovi, obračunavanje in dokumentacija

OrodjeGlavni argumentiOpombeKaj naredi
list_voices—R, INavaja glasove in podprte jezike.
preview_voicevoice, language, textOUstvari vzorec in vrne podpisani URL.
list_voice_clones—R, INavaja prilagojene klone glasov.
get_billing_summary—R, IPridobi stanje in uradne cene paketov; spremembe plačil niso izpostavljene.
search_docsquery, izbirni limitR, I, OPreišče javni indeks dokumentacije.
get_doc_pagepathR, I, OPridobi eno javno stran dokumentacije v Markdownu.

Rezultati o agentu, klicu, številki, kampanji ali nastavitvi vsebujejo web_url, ustrezno stran nadzorne plošče, zato jo lahko odprete v ThunderPhone ali tam nadaljujete z Zeusom.

Vsa produktna orodja uporabljajo iste kodne poti REST kot javni API. Preverjanje REST, omejevanje na organizacijo, vloge, odobritev obračunavanja, kvote, potrditev TCPA, varnost ponudnikov in revizijsko vedenje zato veljajo nespremenjeno.

Urejanje poziva na mestu

update_agent lahko spremeni del osnutka poziva, ne da bi bilo treba znova poslati celotno besedilo. prompt_edits je urejen seznam parov za iskanje in zamenjavo v enaki obliki, kot jo vrneta review_prompt in 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."
    }
  ]
}

Strežnik urejanja uporabi po vrstnem redu v trenutnem osnutku poziva agenta (v objavljenem pozivu, če osnutek ne obstaja) in rezultat zapiše v osnutek po isti poti kot pri update_agent za celoten poziv. Vsak find se mora v pozivu pojaviti natanko enkrat, kakršen je v trenutku, ko pride na vrsto to urejanje. Če se ne, se ne zapiše nič, napaka pa navede urejanje:

KodaPomenKaj storiti
prompt_edit_not_foundBesedilo find ni v trenutnem osnutku poziva. edit_index pove, za katero urejanje gre.Znova pridobite agenta in odlomek kopirajte natančno.
prompt_edit_ambiguousBesedilo find se pojavi več kot enkrat. occurrences pove, kolikokrat se pojavi.Vključite več okoliškega besedila.
stale_promptexpected_prompt_sha256 ni SHA-256 trenutnega osnutka poziva: po tem, ko ste ga prebrali, se je spremenil.Znova pridobite agenta, spremembo prilagodite trenutnemu besedilu in pošljite njegov SHA-256.
conflictMed branjem osnutka na strežniku in njegovim zapisovanjem je prišlo do drugega zapisa.Poskusite znova; ta klic osnutka ni spremenil.

expected_prompt_sha256 ni obvezen in varuje tudi zapis celotnega poziva. Uporabite prompt_sha256 iz review_prompt ali source_prompt_sha256 iz refactor_prompt. Vsak klic, ki spremeni poziv, vrne prompt_sha256 za novo besedilo, previous_prompt_sha256, kadar je strežnik najprej prebral osnutek, in next_step, ki predlaga review_prompt z previous_prompt, nastavljenim na besedilo pred spremembo. REST API sprejme samo celoten poziv: PATCH /v1/agents/{agent_id} s prompt in if_updated_at.

Potrjevanje destruktivnih dejanj

Orodja, označena z D, nekaj spremenijo ali odstranijo oziroma začnejo klicati resnične osebe. Za dejanja, ki jih ni mogoče razveljaviti, sta potrebni dve zahtevi. Prva zahteva ne spremeni ničesar in vrne:

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

Pomočnik uporabniku pokaže, na kaj to vpliva, in zahteva potrditev. Nato zahtevo ponovi z enakimi argumenti ter dodatnim confirmation_token. Žeton velja 10 minut, uporabi se lahko enkrat (tudi če ta klic ne uspe) in velja za eno organizacijo, eno osebo, eno orodje ter en natančen nabor argumentov, zato so za izbris treh agentov potrebne tri potrditve. campaign_action s pause ali stop ta korak preskoči, da je mogoče izvajajočo se kampanjo vedno takoj ustaviti; enako velja za test_integration z GET. Nekatera orodja D se izvedejo z eno zahtevo, ker D označuje njihov učinek, ne pa potrditve na strežniški strani: update_agent nadomesti vsebino osnutka (discard_agent_draft jo povrne), deploy_agent nadomesti aktivno konfiguracijo, update_phone_number preusmeri aktivne klice, sync_mcp_server_tools nadomesti katalog orodij oddaljenega strežnika, import_voip_numbers usmeri številke k vašemu operaterju, run_agent_tests in run_simulation lahko porabita dobroimetje, send_sms in place_call dosežeta resnično osebo (place_call ohrani lastno potrditev privolitve), provision_phone_number pa kupi številko. test_my_agent porabi dobroimetje za preizkuse in zahteva consent_to_charge. Tudi run_replays porabi denar; njegova ocena dry_run in omejitev max_cost_cents nadomestita potrditev. Vaš odjemalec MCP vas lahko še vedno pozove, da jih odobrite.

Nekatere spremembe, ki jih je mogoče razveljaviti, vseeno zahtevajo potrditev: block_callers, unblock_callers in save_voip_setup vedno, update_org_settings, kadar izklopi opozorilo ali doda testno številko, ter update_agent, kadar njegovi attention_reasons izklopijo eno od opozoril agenta. Njihov next_step vas prosi, da potrdite natančno spremembo, namesto da bi opozarjal, da je ni mogoče razveljaviti.

Začetni pozivi

prompts/list ponuja dvanajst ponovno uporabljivih potekov dela:

  • 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

Uporabite prompts/get z navedenim imenom poziva in njegovimi deklariranimi argumenti, da prejmete uporabniško sporočilo, pripravljeno za zagon.

Viri

resources/list izpostavlja javne, predpomnjene reference:

URIVsebina
thunderphone://docs/llms.txtJavni kazalo dokumentacije.
thunderphone://docs/quickstartMarkdown za hitri začetek.
thunderphone://pricingTrenutni javni Markdown s cenami.
thunderphone://guides/prompt-styleSmernice za slog poziva glasovnega agenta, glede na katere preverja review_prompt. Identifikatorji smernic (P1, W2 in podobno) so tisti, ki jih navajajo ugotovitve.
thunderphone://guides/working-with-thunderphoneKako naj pomočnik uporablja ta orodja: kratke ponovitve pri osnutku, preverjanje pred vsako uvedbo, uporabnikova potrditev za vse, kar je v živo ali zaračunljivo, in nikoli ne zahteva skrivnosti.

Posamezen vir preberite z resources/read. Javne pridobitve uporabljajo kratek časovni limit, omejitev 2 MiB in desetminutni predpomnilnik v procesu.

Protokol in napake

Strežnik podpira različici protokola 2025-06-18 in 2025-03-26; vrne podprto različico odjemalca, sicer pa izbere 2025-06-18. Izvaja initialize, ping, orodja, pozive, vire in obvestila. Obvestila vrnejo 202 Accepted. Ta strežnik brez stanja ne izpostavlja poslušalnika SSE ali brisanja sej, zato GET in DELETE vrneta 405 Method Not Allowed z Allow: POST.

Napake orodij ostanejo uspešni odzivi JSON-RPC z isError: true. Njihovo besedilo vsebuje kratek stavek, ki mu sledi 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."
}

Posebna predpona outbound_tcpa_confirmation_required: se ohrani za place_call. Neznane metode JSON-RPC vrnejo -32601 v odgovoru HTTP 200. Paketi JSON-RPC v MCP 2025-06-18 niso podprti in vrnejo čisto napako neveljavne zahteve -32600.