Open in
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/mcpTo je nasprotna smer kot pri povezovanju oddaljenega strežnika MCP z glasovnim agentom:
| Smer | Rezultat |
|---|---|
| Oddaljeni strežnik MCP → agent ThunderPhone | Glasovni agent lahko kliče orodja oddaljenega strežnika. |
| ThunderPhone → vaš odjemalec MCP | Vaš 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:
- Skrbnik organizacije v ThunderPhone odpre Organizacija → Splošno → Dostop pomočnika z UI in potrdi to kritje.
- Pomočnika namesto tega povežite kot povezovalnik po meri s tem URL-jem:
https://api.thunderphone.com/v1/mcp/baaVsebina 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 userPo 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)
- 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
ThunderPhonein vnesitehttps://api.thunderphone.com/v1/mcp. - Izberite Poveži, prijavite se v ThunderPhone, izberite organizacijo in odobrite dovoljenja.
- 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_callinsend_smsnajprej vrneta predogled (agenta, izhodno in ciljno številko ter pri sporočilu besedilo) skupaj sconfirmation_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_contactsincampaign_actionniso na voljo; kampanje ustvarite, naložite in zaženite na nadzorni plošči.list_campaigns,get_campaign_statsincheck_campaignše vedno delujejo. - Brez
test_integration. Zahtevo integracije preizkusite na njeni strani na nadzorni plošči. preview_voicepredvaja fiksni vzorčni pozdrav v izbranem glasu in jeziku; ne izgovarja besedila po meri.list_voicesinlist_agentsvrneta povzetek;get_agentvsebuje 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
- Če se ThunderPhone prikaže v imeniku aplikacij ChatGPT, ga izberite in povežite.
- 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/mcpter preverjanjem pristnosti OAuth. - 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
| Orodje | Glavni argumenti | Oznake | Kaj naredi |
|---|---|---|---|
get_connection_identity | — | R, I | Preveri poverilnico ter vrne organizacijo in varne metapodatke poverilnice. |
Agenti
| Orodje | Glavni argumenti | Opombe | Kaj počne |
|---|---|---|---|
list_agents | — | R, I | Navede agente. |
get_agent | agent_id | R, I | Pridobi enega agenta. |
create_agent | konfiguracija agenta | — | Ustvari agenta. Sprejme enake nastavitve kot update_agent, vključno z steps, handoffs, intro_clip in intro_ring_count. |
update_agent | agent_id, spremenjena polja, izbirna prompt_edits, expected_prompt_sha256 | D | Polja 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_agent | agent_id, izbirni if_updated_at | D, I | Objavi osnutek v produkcijo. |
discard_agent_draft | agent_id, izbirni if_updated_at, confirmation_token pri drugi zahtevi | D, I | Zavrže pripravljene spremembe. Dvostopenjski postopek; glejte Potrjevanje destruktivnih dejanj. |
duplicate_agent | agent_id, izbirni name | — | Kopira agenta znotraj organizacije. |
delete_agent | agent_id, confirmation_token pri drugi zahtevi | D, I | Trajno izbriše agenta. Dvostopenjski postopek. |
list_agent_versions | agent_id | R, I | Navede objavljene različice konfiguracije. |
list_prompt_revisions | agent_id, izbirni source, limit, offset | R, I | Navede 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_prompt | agent_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_prompt | agent_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, I | Navede ponovno uporabna navodila: skupna pravila za pozive, povezana z mnogimi agenti prek reusable_instruction_ids v update_agent. |
create_reusable_instruction | name, content | — | Ustvari nepovezano ponovno uporabno navodilo. Samo za skrbnike. |
Telefonske številke in ponudniki
| Orodje | Glavni argumenti | Opombe | Kaj naredi |
|---|---|---|---|
list_phone_numbers | — | R, I | Navede številke organizacije in usmerjanje. |
get_phone_number_limits | — | R, I | Pridobi uporabo in omejitve upravljanih številk. |
provision_phone_number | izbirno area_code, city, state, idempotency_key | D, O | Kupi dohodno številko, ki jo upravlja ThunderPhone. |
list_voip_connections | — | R, I | Navede povezane ponudnike stranke. |
search_voip_numbers | connection_id, country, type, izbirno area_code | R, I, O | Preišče zalogo številk ponudnika. |
import_voip_numbers | connection_id, numbers | D, O | Uvozi številke, ki so že v lasti pri ponudniku. |
update_phone_number | phone_number_id, polja za usmerjanje/oznako/spletni kavelj | D | Posodobi usmerjanje številke, vključno z dodelitvijo agenta. |
delete_phone_number | phone_number_id, confirm, izbirno release_at_provider, confirmation_token pri drugi zahtevi | D, I, O | Sprosti številko. Dvostopenjsko. |
get_voip_setup_session | izbirno session_id | R, I | Prebere 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_question | session_id, question_id, answer | O | Posreduje 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_setup | session_id, izbirno name, confirmation_token pri drugi zahtevi | D, I, O | Shrani povezan osnutek povezave, da ga je mogoče uporabljati. Dvostopenjsko. |
check_phone_number | phone_number ali phone_number_id | R, I, O | Diagnostizira eno od lastnih številk organizacije na podlagi podatkov: usmerjanja, povezave, preverjanja, nedavnih klicev ponudnika in testnih klicev ter cilja, kamor jo ponudnik usmerja. |
SMS
| Orodje | Glavni argumenti | Opombe | Kaj počne |
|---|---|---|---|
send_sms | from_number, to, body, idempotency_key | D, I, O | Pošlje eno navadno besedilno sporočilo SMS prek povezane številke Twilio ali Telnyx. |
Klici
| Orodje | Glavni argumenti | Opombe | Kaj počne |
|---|---|---|---|
list_calls | izbirni filtri, limit, offset | R, I | Navede klice s filtri REST za zgodovino klicev, vključno z exclude_test_calls. |
get_call | call_id | R, I | Pridobi stanje klica in metapodatke. |
get_call_transcript | call_id, izbirni live | R, I | Pridobi prepis klica. |
get_call_audio_url | call_id, izbirni download | R, I, O | Vrne podpisan URL zvočnega posnetka; zvoka nikoli ne pretaka prek MCP. |
get_call_grade | call_id | R, I | Pridobi najnovejšo oceno klica. |
place_call | agent_id, from_number, to_number | D, O | Izvede en neidemponenten odhodni klic. |
export_calls | filtri klicev, export_format | R, I | Izvozi do omejitve končne točke REST v obliki JSON ali CSV. |
get_call_analytics | izbirna since_days, agent_id | R, I | Združi dejanske klice po stanju, smeri, izidu, oceni in težavi, pri čemer testne klice šteje ločeno. |
get_call_insights | call_ids (do 10) | R, I | Hkrati pridobi oceno, izid, povzetek in zaznane težave več klicev. |
Testiranje in preverjanje
| Orodje | Glavni argumenti | Oznake | Kaj počne |
|---|---|---|---|
list_test_scenarios | agent_id | R, I | Navede preskusne scenarije. |
create_test_scenario | agent_id, title, scenario_prompt, izbirni pogoji | — | Ustvari scenarij. |
generate_test_scenarios | agent_id, izbirni count, include_edge_cases, locale | O | Ustvari scenarije iz poziva agenta. |
run_agent_tests | agent_id, channel, consent_to_charge, izbirna izbira/matrika | D, O | Izvede scenarije prek spleta ali telefonije. |
get_test_run | agent_id, batch_id | R, I | Pridobi stanje paketa in rezultate posameznih scenarijev. |
test_my_agent | agent_id, consent_to_charge, izbirni scenario_ids, count, wait_seconds | D, O | Preskusi 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_text | agent_id, callers (1 do 3 opisi), izbirna version, direction | O | Brezplač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_simulation | agent_id, consent_to_charge, izbirni scenario_prompt, direction, language | D, O | Zač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_simulation | simulation_id | R, I | Pridobi 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_runs | agent_id | R, I | Navede nedavna izvajanja preverjanja osnutka. |
get_validation_status | agent_id | R, I | Pridobi najnovejše stanje preverjanja in ujemanje osnutka. |
list_conversations | agent_id, izbirna split, source | R, I | Navede pogovore, na katerih se preskuša agent. Zahteva orodje za iteracije agenta. |
get_conversation | conversation_id | R, I | Pridobi en preskusni pogovor z njegovimi trenutnimi potezami. Zahteva orodje za iteracije agenta. |
get_conversation_revisions | conversation_id, izbirna limit, offset | R, I | Navede 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_conversations | agent_id, izbirna count, style | O | Napiš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_conversations | agent_id, izbirna since_days, max_calls | O | Nedavne 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_conversations | agent_id, izbirna conversation_ids, from_prompt_revision_id | O | Po 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_job | job_id | R, I | Pridobi 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_replays | agent_id, izbirni overrides, split, engine, sample_size, sample_seed, max_cost_cents, quote_id, dry_run | D, O | Ponovno 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_configs | agent_id, configs (2 do 4, prva je izhodiščna), izbirni sample_size, sample_seed, max_cost_cents, quote_id, dry_run | O | Ponovno 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_run | run_id, izbirni include_trace | R, I | Pridobi 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_link | agent_id, izbirni variant_id, language, expires_in_minutes | O | Ustvari 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
| Orodje | Glavni argumenti | Oznake | Kaj naredi |
|---|---|---|---|
list_knowledge_bases | — | R, I | Navede zbirke znanja. |
create_knowledge_base | name, izbirni description | — | Ustvari zbirko znanja. |
add_knowledge_document | knowledge_base_id, name, content | — | Doda besedilo ali Markdown. |
import_knowledge_url | url, izbirni name | O | Doda javno stran v čakalno vrsto za varno zajemanje. |
search_knowledge | knowledge_base_id, query | R, I | Preišče produkcijsko pridobivanje podatkov. |
Integracije, webhooki in oddaljeni strežniki MCP
| Orodje | Glavni argumenti | Oznake | Kaj počne |
|---|---|---|---|
list_integrations | — | R, I | Navaja integracije funkcij HTTP. |
create_integration | display_name, specifikacija funkcije spec, izbirna polja končne točke | — | Ustvari orodje HTTP. Glave za preverjanje pristnosti dodajte na nadzorni plošči. |
test_integration | url, izbirni način/telo/časovna omejitev, integration_id z header_names, confirmation_token pri drugi zahtevi | D, O | Poš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, I | Navaja podpisane končne točke spletnih kavljev. |
list_webhook_deliveries | izbirni agent_id, izbirni endpoint_id | R, I | Navaja nedavne rezultate dostave spletnih kavljev brez koristnega tovora. |
create_webhook_endpoint | label, url, izbirni dogodki/stanje | O | Ustvari podpisano končno točko spletnega kavlja. |
copy_webhook_endpoint | endpoint_id, target_agent_id | I | Kopira spletni kavelj agenta, vključno s skrivnostjo za podpisovanje, na drugega agenta v strežniku. Samo za skrbnike. |
test_webhook_endpoint | endpoint_id | O | Pošlje sintetični dogodek prek običajne dostave. |
list_mcp_servers | — | R, I | Navaja oddaljene strežnike, ki jih lahko kličejo glasovni agenti. |
create_mcp_server | display_name, url | O | Registrira in sinhronizira oddaljeni strežnik. Strežniki, ki potrebujejo glave za preverjanje pristnosti, se dodajo na nadzorni plošči. |
sync_mcp_server_tools | server_id | D, O | Osveži katalog orodij oddaljenega strežnika. |
Kampanje
| Orodje | Glavni argumenti | Opombe | Kaj naredi |
|---|---|---|---|
list_campaigns | — | R, I | Prikaže odhodne kampanje. |
create_campaign | polja kampanje | — | Ustvari osnutek kampanje. |
add_campaign_contacts | campaign_id, contacts | — | Doda do 5.000 stikov JSON. |
campaign_action | campaign_id, action, izbirni consent_to_charge, confirmation_token pri drugi zahtevi | D, O | Izvede start, pause, resume ali stop. start in resume sta dvostopenjska; pause in stop se izvedeta takoj. |
get_campaign_stats | campaign_id | R, I | Pridobi števce in nedavne rezultate. |
check_campaign | izbirni campaign_id, contact_phone_number, contact_status | R, I | Pojasni, 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
| Orodje | Glavni argumenti | Opombe | Kaj naredi |
|---|---|---|---|
get_org_settings | — | R, I | Prebere časovni pas, delovni čas, preskusne številke, oznake izidov klicev, imena stanj in izklopljena opozorila skupaj z updated_at. |
update_org_settings | spremenjene nastavitve, if_updated_at, confirmation_token, ko je zahtevan | D, I | Spremeni 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, I | Pridobi omejitve platforme z vrednostmi, ki veljajo za to organizacijo. |
list_blocked_callers | izbirna number, search | R, I | Navede blokirane številke klicateljev. |
block_callers | numbers, izbirna note, confirmation_token pri drugi zahtevi | D, I | Zavrne klice s teh številk, preden odgovori kateri koli agent. Dvokoračno, samo skrbniki. |
unblock_callers | numbers, confirmation_token pri drugi zahtevi | D, I | Odstrani š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
| Orodje | Glavni argumenti | Opombe | Kaj naredi |
|---|---|---|---|
get_supported_languages | — | R, I | Navede jezike, ki jih govorijo agenti, skupaj s kodami. |
get_agent_capabilities | — | R, I | Pove, kaj lahko agent naredi med klicem ter katere nastavitve in integracije obstajajo. |
escalate_to_human | summary | O | Zaprosi ekipo ThunderPhone za pomoč. Odgovorijo v ThunderPhone. Za organizacije, ki lahko obravnavajo PHI, ThunderPhone zapusti le nevtralno obvestilo. |
request_feature | title, request, details | O | Ekipo ThunderPhone obvesti o zahtevi za funkcionalnost. Največ tri na organizacijo na dan. |
start_agent_import | platform | R, I | Vrne 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_import | izbirni import_id | R, I | Navede nedavne uvoze ali stanje posameznega uvoza in preslikane agente. |
commit_agent_import | import_id, izbirni item_ids | O | Ustvari agente iz pripravljenega uvoza v ozadju. Samo skrbniki. |
Glasovi, obračunavanje in dokumentacija
| Orodje | Glavni argumenti | Opombe | Kaj naredi |
|---|---|---|---|
list_voices | — | R, I | Navaja glasove in podprte jezike. |
preview_voice | voice, language, text | O | Ustvari vzorec in vrne podpisani URL. |
list_voice_clones | — | R, I | Navaja prilagojene klone glasov. |
get_billing_summary | — | R, I | Pridobi stanje in uradne cene paketov; spremembe plačil niso izpostavljene. |
search_docs | query, izbirni limit | R, I, O | Preišče javni indeks dokumentacije. |
get_doc_page | path | R, I, O | Pridobi 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:
| Koda | Pomen | Kaj storiti |
|---|---|---|
prompt_edit_not_found | Besedilo find ni v trenutnem osnutku poziva. edit_index pove, za katero urejanje gre. | Znova pridobite agenta in odlomek kopirajte natančno. |
prompt_edit_ambiguous | Besedilo find se pojavi več kot enkrat. occurrences pove, kolikokrat se pojavi. | Vključite več okoliškega besedila. |
stale_prompt | expected_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. |
conflict | Med 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_receptionistrun_agent_testsbuy_and_attach_numberreview_low_grade_callsadd_url_to_agent_knowledgeimprove_agent_from_callscheck_change_before_deploytest_my_agentdiagnose_phone_numberwhy_campaign_not_callingcall_reportimport_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:
| URI | Vsebina |
|---|---|
thunderphone://docs/llms.txt | Javni kazalo dokumentacije. |
thunderphone://docs/quickstart | Markdown za hitri začetek. |
thunderphone://pricing | Trenutni javni Markdown s cenami. |
thunderphone://guides/prompt-style | Smernice 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-thunderphone | Kako 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.