Open in
Koristite ThunderPhone kao MCP poslužitelj
Izradite, testirajte, provjerite i upravljajte glasovnim agentima ThunderPhonea iz Claudea, ChatGPT-a, Claude Codea, Codexa, Cursora, VS Codea ili drugog Streamable HTTP MCP klijenta.
ThunderPhone izlaže Streamable HTTP poslužitelj Model Context Protocola na adresi:
https://api.thunderphone.com/v1/mcpOvo je suprotan smjer od povezivanja udaljenog MCP poslužitelja s glasovnim agentom:
| Smjer | Rezultat |
|---|---|
| Udaljeni MCP poslužitelj → ThunderPhone agent | Glasovni agent može pozivati alate udaljenog poslužitelja. |
| ThunderPhone → Vaš MCP klijent | Vaš agent za programiranje može izraditi, testirati i upravljati ThunderPhoneom. |
Autentifikacija
Prema zadanim postavkama koristite OAuth za klijente direktorija: prijavite se, odaberite organizaciju i odobrite zatražene dozvole. Vezu prekinite u odjeljku Postavke → Sigurnost → Aplikacije koje ste povezali. Promjena ili ponovno postavljanje lozinke ili promjena e-adrese računa također opoziva vezu, stoga nakon toga ponovno povežite klijent.
Za klijente konfigurirane s API ključem izradite ključ sk_live_ u odjeljku Integracije → API ključevi i izložite ga MCP klijentu kao THUNDERPHONE_API_KEY. Ključ je povezan s jednom organizacijom; ID u vlasništvu druge organizacije ponaša se kao da nije pronađen.
Organizacije koje obrađuju PHI
Ako pozivi vaše organizacije mogu sadržavati zaštićene zdravstvene informacije (PHI),
zato što imate BAA s ThunderPhoneom ili su vaši agenti određeni za
obradu PHI-ja, gornji URL nikada ne vraća sadržaj poziva: prijepise,
snimke, ocjene, popise poziva, izvoze, ishode kampanja, analitiku poziva i
uvide, razgovore sastavljene na temelju stvarnih poziva i rezultate reprodukcije. Ti alati vraćaju pogrešku s
code: "phi_content_unavailable". Izrada, testiranje i konfiguriranje agenata
funkcioniraju kao i obično.
Taj je URL naveden u javnim direktorijima pomoćnika koji možda ne mogu prenositi PHI. Ako vaša organizacija ima vlastiti BAA s pružateljem pomoćnika koji pokriva radni prostor koji upotrebljavate:
- Administrator organizacije otvara Organizacija → Općenito → Pristup AI pomoćniku u ThunderPhoneu i potvrđuje taj obuhvat.
- Umjesto toga povežite pomoćnika kao prilagođeni poveznik s ovim URL-om:
https://api.thunderphone.com/v1/mcp/baaSadržaj poziva tada je ondje dostupan, uključujući pozive koji mogu sadržavati PHI. Povlačenjem potvrde to se zaustavlja pri sljedećem zahtjevu pomoćnika. Poziv koji je vaša organizacija obradila kao poziv koji ne sadrži PHI dostupan je na oba URL-a.
CLI i stdio alternative
ThunderPhone CLI može zapisati konfiguraciju klijenta uz očuvanje nepovezanih poslužitelja:
npx -y @thunderphone/mcp setup --client cursor --api-key-env THUNDERPHONE_API_KEY
npx thunderphone mcp setup --client claude-desktop --scope userNakon globalne instalacije paketa @thunderphone/mcp, upotrijebite thunderphone-mcp setup s
istim opcijama. Postavljanje podržava Claude Code, Codex, Cursor, VS Code, Gemini, Claude
Desktop i Windsurf. Prednost ima izravni HTTP; Desktop koristi stdio.
Za svaki klijent koji podržava stdio konfigurirajte command: "npx" s
args: ["-y", "@thunderphone/mcp"]. Omotač najprije koristi THUNDERPHONE_API_KEY,
zatim vjerodajnice iz thunderphone login, osvježava istekle tokene, a zatim koristi
OAuth putem mcp-remote. Prijava uređajem i OAuth zahtijevaju odgovarajuće uvođenje API
OAuth-a. Put s API ključem to ne zahtijeva. Izravne HTTP konfiguracije ne čitaju
spremište CLI vjerodajnica; upotrijebite stdio omotač za ponovnu upotrebu prijave uređajem.
Ovo su alternative ručnim konfiguracijama klijenta u nastavku.
Konfiguracija klijenta
Claude i ChatGPT prijavljuju se putem OAutha; API ključ nije potreban. Ako još nemate ThunderPhone račun, na stranici za prijavu odaberite Izradite račun i nakon potvrde e-pošte vratit ćete se na zaslon za odobrenje.
Claude (web, stolno računalo i mobilni uređaji)
- Otvorite Prilagodba → Poveznici (Postavke → Poveznici u starijim verzijama). Ako se ThunderPhone prikazuje u direktoriju poveznika, odaberite ga. U suprotnom odaberite Dodajte prilagođeni poveznik, nazovite ga
ThunderPhonei unesitehttps://api.thunderphone.com/v1/mcp. - Odaberite Povežite, prijavite se u ThunderPhone, odaberite organizaciju i odobrite dozvole.
- U chatu omogućite ThunderPhone iz izbornika alata i zatražite što vam je potrebno, na primjer „Prikaži moje agente”.
Claude traži potvrdu prije prve upotrebe svakog alata. Kako biste preskočili većinu tih upita, otvorite Prilagodba → Poveznici → ThunderPhone i postavite Alati samo za čitanje na uvijek dopušteno. Ti alati samo dohvaćaju podatke: agente, pozive, prijepise, stanja računa i dokumentaciju. Ostavite Alati za pisanje/brisanje na potvrdi ako želite vidjeti svaku promjenu prije nego što se izvrši.
Prilagođeni poveznici zahtijevaju plaćeni Claude paket. U paketima Team i Enterprise vlasnik najprije dodaje poveznik u postavkama poveznika organizacije, a zatim svaki član povezuje vlastiti ThunderPhone račun.
Što je drugačije u Claudeu
Claude (poveznik i dodatak Claude Code) dobiva uži skup alata, u skladu s pravilima direktorija poveznika za Claude:
- Svaki poziv i poruka potvrđuju se zasebno.
place_callisend_smsnajprije vraćaju pregled (agenta, brojeve s kojih se poziva i na koje se poziva te, za poruku, sadržaj poruke) uzconfirmation_token; ništa se ne poziva niti šalje dok Claude nakon Vaše potvrde ne ponovi zahtjev s tokenom. - Nema upravljanja kampanjama.
create_campaign,add_campaign_contactsicampaign_actionnisu dostupni; izradite, učitajte i pokrenite kampanje na nadzornoj ploči.list_campaigns,get_campaign_statsicheck_campaigni dalje rade. - Nema
test_integration. Testirajte zahtjev integracije na njezinoj stranici na nadzornoj ploči. preview_voicereproducira fiksnu oglednu pozdravnu poruku glasom i na jeziku koji odaberete; ne izgovara prilagođeni tekst.list_voicesilist_agentsvraćaju sažetak;get_agentsadrži potpunu konfiguraciju agenta.
Obavijest o umjetnoj inteligenciji
Svaki poziv koji ThunderPhone agent upućuje ili na koji odgovara počinje izgovorenom obavijesti o umjetnoj inteligenciji. Prema zadanim postavkama kaže: "Ovaj je poziv s pomoćnikom umjetne inteligencije te će biti snimljen i transkribiran." Isključivanje te obavijesti (consent_announcement_enabled postavljeno na false ili ai_live_processing_disclosure_override isključen) odbija se osim ako administrator organizacije prethodno nije zabilježio potpisanu potvrdu na nadzornoj ploči, iz bilo kojeg klijenta, uključujući Claude.
ChatGPT
- Ako se ThunderPhone prikazuje u direktoriju aplikacija za ChatGPT, odaberite ga i povežite.
- U suprotnom otvorite Postavke → Aplikacije i poveznici → Napredne postavke, uključite Način za razvojne programere i izradite poveznik s URL-om
https://api.thunderphone.com/v1/mcpi OAuth provjerom autentičnosti. - Prijavite se u ThunderPhone, odaberite organizaciju i odobrite dozvole. Dodajte ThunderPhone u chat iz izbornika alata.
Brisanje agenta ili telefonskog broja, odbacivanje skice, pokretanje kampanje i slanje testnog zahtjeva koji može upisivati podatke u vanjski sustav zahtijevaju drugu potvrdu u bilo kojoj aplikaciji; pogledajte Potvrđivanje destruktivnih radnji.
Claude Code
claude mcp add --transport http thunderphone https://api.thunderphone.com/v1/mcp \
--header "Authorization: Bearer $THUNDERPHONE_API_KEY"Codex
Dodajte ovo u ~/.codex/config.toml:
[mcp_servers.thunderphone]
url = "https://api.thunderphone.com/v1/mcp"
bearer_token_env_var = "THUNDERPHONE_API_KEY"Cursor
Izradite .cursor/mcp.json:
{
"mcpServers": {
"thunderphone": {
"url": "https://api.thunderphone.com/v1/mcp",
"headers": {
"Authorization": "Bearer ${env:THUNDERPHONE_API_KEY}"
}
}
}
}Claude Desktop
Dodajte most mcp-remote u konfiguraciju aplikacije 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
Izradite .vscode/mcp.json i unesite ključ putem upita za unos u VS Codeu:
{
"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}"
}
}
}
}Alati
Svaki alat sadrži MCP napomene. U tablicama R znači samo za čitanje, D destruktivno, I idempotentno, a O interakciju s otvorenim svijetom/mrežom. Crtica znači da nije postavljena nikakva napomena.
Veza
| Alat | Glavni argumenti | Napomene | Što radi |
|---|---|---|---|
get_connection_identity | — | R, I | Provjerava vjerodajnicu i vraća njezinu organizaciju i sigurne metapodatke vjerodajnice. |
Agenti
| Alat | Glavni argumenti | Napomene | Što radi |
|---|---|---|---|
list_agents | — | R, I | Prikazuje agente. |
get_agent | agent_id | R, I | Dohvaća jednog agenta. |
create_agent | konfiguracija agenta | — | Stvara agenta. Prima iste postavke kao update_agent, uključujući steps, handoffs, intro_clip i intro_ring_count. |
update_agent | agent_id, promijenjena polja, neobavezni prompt_edits, expected_prompt_sha256 | D | Priprema polja u skici agenta i zamjenjuje ono što je skica sadržavala. Izvršava se bez koraka potvrde: implementirani agent ostaje nepromijenjen dok ne pokrenete deploy_agent, a discard_agent_draft vraća skicu. Možete postaviti i max_hold_seconds, system_tool_settings i words. Da biste promijenili dio prompta, pošaljite prompt_edits (pogledajte Uređivanje prompta na mjestu). |
deploy_agent | agent_id, neobavezni if_updated_at | D, I | Promiče skicu u produkciju. |
discard_agent_draft | agent_id, neobavezni if_updated_at, confirmation_token pri drugom zahtjevu | D, I | Odbacuje pripremljene promjene. U dva koraka, pogledajte Potvrđivanje destruktivnih radnji. |
duplicate_agent | agent_id, neobavezni name | — | Kopira agenta unutar organizacije. |
delete_agent | agent_id, confirmation_token pri drugom zahtjevu | D, I | Trajno briše agenta. U dva koraka. |
list_agent_versions | agent_id | R, I | Prikazuje implementirane verzije konfiguracije. |
list_prompt_revisions | agent_id, neobavezni source, limit, offset | R, I | Prikazuje svaku promjenu teksta prompta agenta, uključujući skice, svaku s razlikom u odnosu na reviziju koju je zamijenila. Dostupno kada je komplet alata za iteraciju agenta dostupan vašoj vezi (pogledajte u nastavku). |
review_prompt | agent_id, neobavezni prompt, previous_prompt, quote_id, max_cost_cents | — | Pregledava skicu prompta (ili tekst koji pošaljete) prema vodiču za stil promptova. Svaki nalaz citira odlomak, navodi smjernicu i nudi izmjenu za pronalaženje i zamjenu; rezultat također navodi ponašanja koja prompt zahtijeva, sa stabilnim ID-ovima, je li potrebno preoblikovanje te, za vlastiti prompt agenta, trebaju li se osvježiti njegovi testni razgovori. Ne mijenja ništa na agentu; popis se sprema uz reviziju njegova prompta. Alat se naplaćuje, pa nije označen kao samo za čitanje: najprije zatražite ponudu pomoću dry_run, zatim ga ponovno pokrenite bez dry_run, s vraćenim quote_id i max_cost_cents. Ova plaćena pokretanja sada se računaju u isto ograničenje kompleta alata organizacije kao i druga pokretanja kompleta alata. Dostupno kada je komplet alata za iteraciju agenta dostupan vašoj vezi (pogledajte u nastavku). |
refactor_prompt | agent_id, neobavezni prompt, inventory, instructions, quote_id, max_cost_cents | — | Preoblikuje prompt u strukturu vodiča za stil i svako ponašanje označava kao zadržano, spojeno, preformulirano ili uklonjeno. Vraća novi tekst i razliku te ga prema zadanim postavkama ponovno čita kako bi prijavio behavior_changes (dodano, uklonjeno ili promijenjeno) i behavior_preserved; primijenite ga pomoću update_agent. Alat se naplaćuje: zatražite ponudu pomoću dry_run, zatim ga jednom pokrenite s vraćenim quote_id i max_cost_cents. Dostupno kada je komplet alata za iteraciju agenta dostupan vašoj vezi (pogledajte u nastavku). |
list_reusable_instructions | — | R, I | Prikazuje višekratno upotrebljive upute: zajednička pravila prompta povezana s mnogim agentima putem reusable_instruction_ids alata update_agent. |
create_reusable_instruction | name, content | — | Stvara nepovezanu višekratno upotrebljivu uputu. Samo administratori. |
Telefonski brojevi i pružatelji usluga
| Alat | Glavni argumenti | Oznake | Što radi |
|---|---|---|---|
list_phone_numbers | — | R, I | Navodi brojeve organizacije i usmjeravanje. |
get_phone_number_limits | — | R, I | Dohvaća upotrebu i ograničenja upravljanih brojeva. |
provision_phone_number | neobavezni area_code, city, state, idempotency_key | D, O | Kupuje dolazni broj kojim upravlja ThunderPhone. |
list_voip_connections | — | R, I | Navodi povezane operatere korisnika. |
search_voip_numbers | connection_id, country, type, neobavezni area_code | R, I, O | Pretražuje inventar operatera. |
import_voip_numbers | connection_id, numbers | D, O | Uvozi brojeve koji su već u vlasništvu kod operatera. |
update_phone_number | phone_number_id, polja za usmjeravanje/oznaku/webhook | D | Ažurira usmjeravanje broja, uključujući dodjelu agenta. |
delete_phone_number | phone_number_id, confirm, neobavezni release_at_provider, confirmation_token u drugom zahtjevu | D, I, O | Oslobađa broj. U dva koraka. |
get_voip_setup_session | neobavezni session_id | R, I | Dohvaća vođeno postavljanje operatera (status, kontrolni popis, pitanje na koje čeka odgovor) ili navodi otvorena postavljanja. Postavljanje se pokreće na nadzornoj ploči jer je potrebna lozinka operatera. Samo za administratore. |
answer_voip_setup_question | session_id, question_id, answer | O | Prosljeđuje korisnikov odgovor postavljanju. Na lozinke, pristanak za testni poziv, adresu poslužitelja, korisničko ime i dopuštenje ThunderPhoneu za prijavu na račun pružatelja odgovara se samo u čarobnjaku za postavljanje; za njih vraća poveznicu na čarobnjak i ne šalje ništa. |
save_voip_setup | session_id, neobavezni name, confirmation_token u drugom zahtjevu | D, I, O | Sprema povezanu skicu veze kako bi se mogla upotrebljavati. U dva koraka. |
check_phone_number | phone_number ili phone_number_id | R, I, O | Dijagnosticira jedan od vlastitih brojeva organizacije na temelju dokaza: usmjeravanja, veze, provjere, nedavnih poziva operatera i testnih poziva te odredišta na koje ga operater šalje. |
SMS
| Alat | Glavni argumenti | Napomene | Što radi |
|---|---|---|---|
send_sms | from_number, to, body, idempotency_key | D, I, O | Šalje jednu SMS poruku s običnim tekstom putem povezanog Twilio ili Telnyx broja. |
Pozivi
| Alat | Glavni argumenti | Napomene | Opis |
|---|---|---|---|
list_calls | neobavezni filtri, limit, offset | R, I | Navodi pozive uz filtre REST povijesti poziva, uključujući exclude_test_calls. |
get_call | call_id | R, I | Dohvaća status i metapodatke poziva. |
get_call_transcript | call_id, neobavezni live | R, I | Dohvaća transkript poziva. |
get_call_audio_url | call_id, neobavezni download | R, I, O | Vraća potpisani URL za zvuk; zvuk se nikada ne strujno prenosi putem MCP-a. |
get_call_grade | call_id | R, I | Dohvaća najnoviju ocjenu poziva. |
place_call | agent_id, from_number, to_number | D, O | Upućuje jedan neidemponentni odlazni poziv. |
export_calls | filtri poziva, export_format | R, I | Izvozi do ograničenja REST krajnje točke kao JSON ili CSV. |
get_call_analytics | neobavezni since_days, agent_id | R, I | Agregira stvarne pozive prema statusu, smjeru, ishodu, ocjeni i problemu, pri čemu se testni pozivi broje zasebno. |
get_call_insights | call_ids (do 10) | R, I | Odjednom dohvaća ocjenu, ishod, sažetak i otkrivene probleme za više poziva. |
Testiranje i provjera
| Alat | Glavni argumenti | Oznake | Što radi |
|---|---|---|---|
list_test_scenarios | agent_id | R, I | Navodi testne scenarije. |
create_test_scenario | agent_id, title, scenario_prompt, neobavezni uvjeti | — | Stvara scenarij. |
generate_test_scenarios | agent_id, neobavezni count, include_edge_cases, locale | O | Generira scenarije iz upita agenta. |
run_agent_tests | agent_id, channel, consent_to_charge, neobavezan odabir/matrica | D, O | Izvršava scenarije putem weba ili telefonije. |
get_test_run | agent_id, batch_id | R, I | Dohvaća status skupine i rezultate po scenariju. |
test_my_agent | agent_id, consent_to_charge, neobavezni scenario_ids, count, wait_seconds | D, O | Testira agenta u jednom pozivu: pokreće njegove spremljene scenarije (generirajući neke ako ih nema) i čeka do jedne minute na ocjene ili vraća batch_id za get_test_run. Naplaćuje se kao run_agent_tests. |
test_in_text | agent_id, callers (1 do 3 opisa), neobavezni version, direction | O | Besplatni tekstni test: simulirani pozivatelji tekstom razgovaraju s nacrtom agenta (ili aktivnom verzijom) kroz stvarni kanal, a prijepisi se vraćaju za otprilike minutu. Rezultati alata su simulirani. |
run_simulation | agent_id, consent_to_charge, neobavezni scenario_prompt, direction, language | D, O | Pokreće jedan simulirani telefonski poziv između AI pozivatelja i nacrta agenta kako bi osoba mogla poslušati promjenu. Vraća pokretanje u stanju in_progress. Snima se kada agent snima pozive, a ocjenjuje nakon završetka. Naplaćuje se kao testni poziv, najprije iz besplatnog proračuna za testiranje. |
get_simulation | simulation_id | R, I | Dohvaća status simuliranog poziva i, nakon njegova završetka, ono što je proizveo: kratkotrajni URL snimke i prijepis kada agent snima pozive te ocjenu nakon završetka ocjenjivanja (null prije toga). |
list_validation_runs | agent_id | R, I | Navodi nedavna pokretanja provjere nacrta. |
get_validation_status | agent_id | R, I | Dohvaća najnovije stanje provjere i podudaranje nacrta. |
list_conversations | agent_id, neobavezni split, source | R, I | Navodi razgovore na kojima se agent testira. Zahtijeva alatni komplet za iteraciju agenta. |
get_conversation | conversation_id | R, I | Dohvaća jedan testni razgovor s njegovim trenutačnim replikama. Zahtijeva alatni komplet za iteraciju agenta. |
get_conversation_revisions | conversation_id, neobavezni limit, offset | R, I | Navodi svaku reviziju testnog razgovora: kako se i zašto promijenio (osvježen zbog promjene upita, vraćen iz ranije revizije), dodana, uklonjena i promijenjena ponašanja, premještene ili povučene primjere te razliku redaka. Zahtijeva alatni komplet za iteraciju agenta. |
generate_conversations | agent_id, neobavezni count, style | O | Piše simulirane testne razgovore prema nacrtu agenta i njihove najteže trenutke pretvara u primjere za provjeru s ključevima odgovora. Najprije zatražite ponudu pomoću dry_run; stvarno pokretanje zahtijeva njegov quote_id i max_cost_cents. Zahtijeva alatni komplet za iteraciju agenta. |
import_conversations | agent_id, neobavezni since_days, max_calls | O | Pretvara nedavne pozive agenta u testne razgovore (najviše dva po pozivatelju, pozivi bez snimanja se preskaču) i njihove najteže trenutke u primjere. Najprije zatražite ponudu pomoću dry_run; stvarno pokretanje zahtijeva njegov quote_id i max_cost_cents. Zahtijeva alatni komplet za iteraciju agenta. |
refresh_conversations | agent_id, neobavezni conversation_ids, from_prompt_revision_id | O | Ažurira testne razgovore agenta prema njegovu trenutačnom upitu nakon dodavanja, uklanjanja ili promjene ponašanja: ponovno ih usmjerava, vraća raniju reviziju (uključujući stvarni zvuk) ili ponovno piše zastarjele replike te povlači primjere čija je rečenica pozivatelja nestala. Najprije zatražite ponudu pomoću dry_run; stvarno pokretanje zahtijeva njegov quote_id i max_cost_cents. Zahtijeva alatni komplet za iteraciju agenta. |
get_conversation_job | job_id | R, I | Dohvaća zadatak generiranja, uvoza ili osvježavanja: status, dosadašnji trošak u odnosu na ograničenje i ono što je napisao ili osvježio. Zahtijeva alatni komplet za iteraciju agenta. |
run_replays | agent_id, neobavezni overrides, split, engine, sample_size, sample_seed, max_cost_cents, quote_id, dry_run | D, O | Ponovno reproducira uzorak primjera agenta prema njegovu nacrtu ili prema zamjenama kao što su kandidatni upit, glas ili razina te procjenjuje svaki odgovor prema ključu odgovora primjera. Točne reprodukcije pokreću snimljeni zvuk replike kao što bi to učinio aktivni poziv; stope prolaznosti prijavljuju se po mehanizmu. Reprodukcije PHI poziva izvode se kao PHI, a konfiguracija na kojoj se ne mogu izvršiti (glas ElevenLabs, eksperimentalni proizvod) odbija se. dry_run vraća procjenu, odabrani sample_seed i quote_id; stvarno pokretanje šalje isti zahtjev s tim quote_id i sample_seed te max_cost_cents, strogim ograničenjem: svaki zahtjev rezervira svoju gornju granicu prije slanja, a pokretanje se zaustavlja umjesto da pošalje zahtjev koji ne stane, stoga ostavite procijenjeni largest_reservation_cents slobodnog prostora po radniku. Točna reprodukcija rezervira najgori slučaj, otprilike od 85 centi do $1.25 po aktivnoj reprodukciji za tipičnu repliku (istodobno se izvode dvije), nasuprot stvarnom trošku od nekoliko centi; pokretanje se naplaćuje prema stvarnom trošku reprodukcija, stoga postavite max_cost_cents s rezervom. Točna reprodukcija izvodi se unutar proračuna za uobičajenu repliku plus jedno ponovno izvršavanje kakvo provodi produkcija (ponovno nadmetanje odgovora i ponovni pokušaj nadzornika); replika kojoj treba više bilježi se kao pogreška replay_budget_exhausted, zasebno se broji kao budget_exhausted, ne uključuje se u stopu prolaznosti i na testnom skupu ne troši kohortu. Na testnom skupu kohorta sa snimljenim zvukom pozivatelja u konfiguraciji koja nije Bolt v2 odbija se (test_needs_exact_replay) i ostaje neiskorištena: tu konfiguraciju mjerite na razvojnom skupu. Zahtijeva alatni komplet za iteraciju agenta. |
compare_configs | agent_id, configs (2 do 4, prva je osnovna vrijednost), neobavezni sample_size, sample_seed, max_cost_cents, quote_id, dry_run | O | Ponovno reproducira iste primjere u svakoj konfiguraciji i prijavljuje stopu prolaznosti, primjere ispravljene i pokvarene u odnosu na osnovnu vrijednost, latenciju do prvog zvuka, koliko je često pozivatelj čekao na potvrdu, otkucaje ili tišinu te trošak po replici, po mehanizmu. Zatražite ponudu pomoću dry_run kao za run_replays. Samo razvojni skup: na testnom skupu zahtjev se odbija (comparison_dev_only); usporedite na razvojnom skupu, a zatim odabranu konfiguraciju izmjerite pomoću run_replays. Zahtijeva alatni komplet za iteraciju agenta. |
get_replay_run | run_id, neobavezni include_trace | R, I | Dohvaća ukupne vrijednosti pokretanja reprodukcije, promjene ishoda i rezultate po primjeru te njegovu skupinu za usporedbu. Točne reprodukcije kojima je trebalo više od proračuna broje se zasebno (budget_exhausted), izvan stope prolaznosti. Zahtijeva alatni komplet za iteraciju agenta. |
create_talk_link | agent_id, neobavezni variant_id, language, expires_in_minutes | O | Stvara jednokratnu poveznicu koju osoba otvara u pregledniku da bi razgovarala s trenutačnim nacrtom agenta, kao gumb Razgovor na nadzornoj ploči. Poveznica prema zadanim postavkama istječe nakon 30 minuta (najviše 120); razgovor se naplaćuje kao testni poziv za Razgovor. Pogledajte Poveznice za razgovor. |
Alati označeni kao oni kojima je potreban komplet alata za iteraciju agenta dio su tog kompleta; komplet alata omogućuje se po organizaciji dok je u beta fazi, a bez njega vraćaju feature_not_enabled s uputama za sljedeće korake. Svaki razgovor agenta nalazi se u njegovoj razvojnoj ili testnoj podjeli. Testna podjela služi za mjerenje promjene, a ne za njezino podešavanje, pa alati za razgovore vraćaju razgovor iz testne podjele samo kao njegov id, podjelu, izvor, status i brojanja. Pokretanje reprodukcije u testnoj podjeli reproducira jednu cijelu testnu kohortu (sample_size i sample_seed se zanemaruju), svaki primjer na mehanizmu koji njegovi podaci dopuštaju, određenom iz primjera prije pokretanja (točno za snimljeni zvuk pozivatelja, tekstualno za primjer koji sadrži samo tekst; konfiguracija koja nije Bolt v2 nema točnu putanju, pa se kohorta sa snimljenim zvukom za nju odbija s test_needs_exact_replay i ostaje neiskorištena; engine se izostavlja ili je auto, jer se exact ili text odbija s test_engine_per_example i ništa se ne vraća na tekst), te vraća samo ukupne rezultate po mehanizmu: stopu prolaznosti, neuspjehe prema ozbiljnosti i vrsti, latenciju i trošak. Njegov prvi rezultat koji pohrani reprodukciju troši kohortu, pa sljedeće testno pokretanje, za bilo koji prompt, uzima drugu, a ako nijedna ne preostane odbija se s no_test_cohort (uvoz poziva ili generiranje razgovora popunjava nove kohorte); pokretanje koje završi prije pohranjivanja reprodukcije (Core ne može točno reproducirati njegove zvučne primjere, exact_replay_unavailable, njegov kapacitet za reprodukciju ostaje zauzet, core_busy, ili je svakom potezu ponestalo proračuna, replay_budget_exhausted) ostavlja kohortu neiskorištenom. U razvojnoj podjeli točna reprodukcija koju Core ne može pokrenuti vraća se na tekst, a pokretanje se označava kao degraded. Usporedbe se pokreću samo u razvojnoj podjeli. Svaki alat koji se naplaćuje prihvaća quote_id svojeg probnog pokretanja, valjan za jedno pokretanje: trajno se potroši jednom, kada pokretanje započne, a početak koji je odbijen ili prije toga ne uspije ostavlja ga upotrebljivim; pokretanje koje ne uspije nakon toga to navodi te se ponavlja s novim probnim pokretanjem za novi quote_id. Uz OAuth, review_prompt i refactor_prompt trebaju opseg agents:write, uključujući probna pokretanja, a alati za razgovore i reprodukciju trebaju testing:write za pokretanje. Osobe na nadzornoj ploči vide cijelu testnu podjelu. Poziv čiji se pozivatelj nalazi u testnoj podjeli agenta izdvaja se jer je dio testnog skupa. U organizaciji s kompletom alata, list_calls, get_call, get_call_transcript, get_call_audio_url, get_call_grade i export_calls vraćaju ga točno kao {"call_id", "start_time", "held_out": true} (started_at umjesto start_time u recima izvoza), bez njegova prijepisa, snimke, povijesti, ocjene ili izvješća; svako drugo polje poziva izostaje, zato izdvojeni red najprije pročitajte prema njegovu held_out. REST API čini isto za API ključeve i OAuth tokene, a njegovi prikazi za mnogo poziva (sažeci izvješća, klasteri problema, istrage, izvješća cjevovoda) izostavljaju izdvojene pozive iz svojih brojanja, klastera i uzoraka te zadržavaju svaki tekst koji je model napisao iz njih. Upis u izdvojeni poziv (ocjenjivanje, promicanje u testni scenarij, ponovno generiranje poteza) odbija se s held_out_call. Testni scenarij koji je netko unaprijedio iz izdvojenog poziva vraća se iz list_test_scenarios i u testnim pokretanjima točno kao {"id", "held_out": true}, a pokretanje simulacije iz njega, iz get_test_run i alata za simulaciju, točno kao {"id", "scenario_id", "held_out": true}; njegovi simulirani pozivi također su izdvojeni, a testna pokretanja ga i dalje pokreću. Razvojni razgovor, primjer ili rezultat reprodukcije kopiran iz poziva izdvojenog pozivatelja (podjele su po agentu, pa taj pozivatelj može biti u testnoj podjeli drugog agenta) čita se kao onaj iz testne podjele. Osobe na nadzornoj ploči vide izdvojene pozive u cijelosti, a administrator može jednom API ključu omogućiti njihov potpuni prikaz (include_held_out_calls, prema zadanim postavkama isključen, postavlja se samo na nadzornoj ploči), za integraciju kojoj je potreban svaki poziv; MCP ga nikada ne koristi. Webhookovi ostaju nepromijenjeni. Organizacije bez kompleta alata ne vide polje held_out ni ikakvu promjenu.
generate_conversations, import_conversations i refresh_conversations troše modele kredite. Najprije ih pozovite s dry_run: true: odgovor je procjena troška, korak po korak, s quote_id, i ništa se ne izvršava. Procjena obuhvaća svaki zahtjev koji izvršavanje može uputiti pri uobičajenoj veličini. Stvarno izvršavanje zahtijeva taj quote_id (ističe nakon 15 minuta i radi samo s istim argumentima) i max_cost_cents, čvrsto ograničenje: prije svakog zahtjeva posao rezervira najviše koliko taj zahtjev može stajati te se zaustavlja umjesto da pošalje zahtjev koji ne stane u ograničenje, zadržavajući ono što je napisao. Zbog te rezervacije izvršavanje se može zaustaviti s dijelom ograničenja koji nije potrošen; largest_reservation_cents u procjeni navodi koliku rezervu treba ostaviti. Simulirani pozivatelji izmišljaju se na temelju upute agenta; style: "adversarial" stvara zahtjevne pozivatelje koji ciljaju slabe točke upute, a ti razgovori uvijek idu u razvojni skup. target: "changed_behaviors" usmjerava pozivatelje na ono što se promijenilo u posljednjoj izmjeni upute. Svaki agent istodobno pokreće jedan od tih poslova ili jedno izvršavanje ponavljanja, tako da osvježavanje nikada ne mijenja primjere na kojima se izvršava ponavljanje; pokretanje dok se drugo izvršava vraća job_active, replay_run_active ili conversation_job_active s informacijom o tome što treba pričekati.
Nakon izmjene upute koja dodaje, uklanja ili mijenja ponašanje, review_prompt na nacrtu agenta izvješćuje o broju testnih razgovora izrađenih za uputu s drugim ponašanjima (conversations.refresh_suggested). refresh_conversations ih zatim usklađuje s nacrtom, tako da razvojni i testni skup mjere novu uputu na povijestima koje je mogla proizvesti. Osvježavanje nikada ništa ne gubi: svaki razgovor zadržava svaku raniju reviziju, a kada se uklonjeno pravilo vrati, vraća se revizija iz vremena kada je postojalo sa stvarnim zvukom pozivatelja. Osvježavanje koje pokrene agent za kodiranje izostavlja razgovore testnog skupa i razgovore kopirane iz izdvojenih poziva iz odabira, procjene, napretka i troška; navođenje jednog u conversation_ids vraća 403 test_conversation. Osoba ih osvježava iz nadzorne ploče, a agentima za kodiranje rezultati tog posla prikazuju ih samo kao identifikatore i brojeve. active primjer čiju povijest, odgovor ili ključ odgovora osvježavanje prepiše vraća se u pending_review, s oznakom refreshed_needs_review. Procjena za osvježavanje obračunava svaki razgovor koji pročita kao da je prepisan, svaki poziv modela po njegovu izlaznom ograničenju te vrijedi za uputu i razgovore za koje je izrađena: kada se bilo koji promijeni prije izvršavanja, ponovno izradite procjenu; kada se uputa promijeni tijekom izvršavanja, posao se zaustavlja kao failed, zadržavajući ono što je osvježio.
Znanje
| Alat | Glavni argumenti | Napomene | Što radi |
|---|---|---|---|
list_knowledge_bases | — | R, I | Prikazuje baze znanja. |
create_knowledge_base | name, neobavezno description | — | Stvara bazu znanja. |
add_knowledge_document | knowledge_base_id, name, content | — | Dodaje tekst ili Markdown. |
import_knowledge_url | url, neobavezno name | O | Stavlja javnu stranicu u red za siguran unos. |
search_knowledge | knowledge_base_id, query | R, I | Pretražuje produkcijsko dohvaćanje. |
Integracije, webhookovi i udaljeni MCP poslužitelji
| Alat | Glavni argumenti | Napomene | Što radi |
|---|---|---|---|
list_integrations | — | R, I | Navodi integracije HTTP funkcija. |
create_integration | display_name, specifikacija funkcije spec, neobavezna polja krajnje točke | — | Stvara HTTP alat. Dodajte zaglavlja za autentifikaciju u nadzornoj ploči. |
test_integration | url, neobavezni metoda/tijelo/vremensko ograničenje, integration_id s header_names, confirmation_token pri drugom zahtjevu | D, O | Šalje ograničeni testni zahtjev zaštićen od SSRF-a. Spremljene vrijednosti zaglavlja popunjavaju se iz integracije i šalju samo njezinu vlastitom hostu. POST (zadano), PUT, PATCH i DELETE odvijaju se u dva koraka; GET se izvršava odmah. |
list_webhook_endpoints | — | R, I | Navodi potpisane krajnje točke webhooka. |
list_webhook_deliveries | neobavezni agent_id, neobavezni endpoint_id | R, I | Navodi nedavne ishode isporuke webhooka bez korisnog tereta. |
create_webhook_endpoint | label, url, neobavezni događaji/status | O | Stvara potpisanu krajnju točku webhooka. |
copy_webhook_endpoint | endpoint_id, target_agent_id | I | Kopira webhook agenta, uključujući tajnu za potpisivanje, na drugog agenta na poslužitelju. Samo za administratore. |
test_webhook_endpoint | endpoint_id | O | Šalje sintetički događaj uobičajenim postupkom isporuke. |
list_mcp_servers | — | R, I | Navodi udaljene poslužitelje koje mogu pozivati glasovni agenti. |
create_mcp_server | display_name, url | O | Registrira i sinkronizira udaljeni poslužitelj. Poslužitelji kojima su potrebna zaglavlja za autentifikaciju dodaju se u nadzornoj ploči. |
sync_mcp_server_tools | server_id | D, O | Osvježava katalog alata udaljenog poslužitelja. |
Kampanje
| Alat | Glavni argumenti | Oznake | Što radi |
|---|---|---|---|
list_campaigns | — | R, I | Prikazuje odlazne kampanje. |
create_campaign | polja kampanje | — | Stvara nacrt kampanje. |
add_campaign_contacts | campaign_id, contacts | — | Dodaje do 5.000 JSON kontakata. |
campaign_action | campaign_id, action, neobavezni consent_to_charge, confirmation_token pri drugom zahtjevu | D, O | Pokreće start, pause, resume ili stop. start i resume izvode se u dva koraka; pause i stop izvode se odmah. |
get_campaign_stats | campaign_id | R, I | Dohvaća brojače i nedavne ishode. |
check_campaign | neobavezni campaign_id, contact_phone_number, contact_status | R, I | Objašnjava zašto kampanja ne poziva: njezin vremenski prozor za pozivanje u vlastitoj vremenskoj zoni, kontakte koji su sada na redu i što sprječava biranje. |
Postavke organizacije i blokirani pozivatelji
| Alat | Glavni argumenti | Napomene | Što radi |
|---|---|---|---|
get_org_settings | — | R, I | Čita vremensku zonu, radno vrijeme, testne brojeve, oznake ishoda poziva, nazive statusa i koja su upozorenja isključena, uz updated_at. |
update_org_settings | promijenjene postavke, if_updated_at, confirmation_token kada se zatraži | D, I | Mijenja ih (samo administratori). Popisi i objekti zamjenjuju pohranjenu vrijednost. Isključivanje upozorenja ili dodavanje testnog broja postupak je u dva koraka. Rezultat sadrži stare vrijednosti za poništavanje. |
get_account_limits | — | R, I | Dohvaća ograničenja platforme s vlastitim vrijednostima ove organizacije. |
list_blocked_callers | neobavezni number, search | R, I | Navodi brojeve blokiranih pozivatelja. |
block_callers | numbers, neobavezni note, confirmation_token pri drugom zahtjevu | D, I | Odbija pozive s tih brojeva prije nego što se javi bilo koji agent. Postupak u dva koraka, samo administratori. |
unblock_callers | numbers, confirmation_token pri drugom zahtjevu | D, I | Uklanja brojeve s popisa blokiranih brojeva. Postupak u dva koraka, samo administratori. |
get_org_settings, update_org_settings i get_account_limits zahtijevaju org:read ili org:write OAuth opseg; od veze uspostavljene prije nego što su bili dostupni zatražit će se odobrenje pri prvoj upotrebi.
Mogućnosti, pomoć i uvozi
| Alat | Glavni argumenti | Napomene | Što radi |
|---|---|---|---|
get_supported_languages | — | R, I | Navodi jezike kojima agenti govore, s kodovima. |
get_agent_capabilities | — | R, I | Navodi što agent može učiniti tijekom poziva te koje su postavke i integracije dostupne. |
escalate_to_human | summary | O | Traži pomoć od tima ThunderPhone. Odgovaraju u ThunderPhoneu. Za organizacije koje mogu obrađivati PHI iz ThunderPhonea odlazi samo neutralna napomena. |
request_feature | title, request, details | O | Podnosi zahtjev za značajku timu ThunderPhone. Najviše tri po organizaciji dnevno. |
start_agent_import | platform | R, I | Vraća poveznicu na nadzornu ploču na kojoj unosite svoj ključ za Vapi, Retell, ElevenLabs ili Bland i odabirete agente. Nijedan alat ne prima ključ. |
get_agent_import | neobavezni import_id | R, I | Navodi nedavne uvoze ili status jednog uvoza i preslikane agente. |
commit_agent_import | import_id, neobavezni item_ids | O | Stvara agente iz spremnog uvoza u pozadini. Samo administratori. |
Glasovi, naplata i dokumentacija
| Alat | Glavni argumenti | Napomene | Što radi |
|---|---|---|---|
list_voices | — | R, I | Navodi glasove i podržane jezike. |
preview_voice | voice, language, text | O | Generira uzorak i vraća potpisani URL. |
list_voice_clones | — | R, I | Navodi prilagođene klonove glasova. |
get_billing_summary | — | R, I | Dohvaća stanje računa i mjerodavne cijene razina; nisu dostupne izmjene plaćanja. |
search_docs | query, neobavezno limit | R, I, O | Pretražuje indeks javne dokumentacije. |
get_doc_page | path | R, I, O | Dohvaća jednu javnu Markdown stranicu dokumentacije. |
Rezultati o agentu, pozivu, broju, kampanji ili postavci sadrže web_url, odgovarajuću stranicu nadzorne ploče, pa je možete otvoriti u ThunderPhoneu ili ondje nastaviti sa Zeusom.
Svi alati proizvoda koriste iste REST putanje koda kao javni API. Stoga se REST provjera, opseg organizacije, uloge, odobrenje naplate, kvote, TCPA potvrda, sigurnost pružatelja usluga i ponašanje revizije primjenjuju nepromijenjeno.
Uređivanje prompta na mjestu
update_agent može izmijeniti dio nacrta prompta bez ponovnog slanja cijelog teksta. prompt_edits je uređeni popis parova za pronalaženje i zamjenu, u istom formatu koji vraćaju review_prompt i 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."
}
]
}Poslužitelj primjenjuje izmjene redom na trenutačni nacrt prompta agenta (na objavljeni prompt ako nema nacrta) i zapisuje rezultat u nacrt istim putem kao i update_agent za cijeli prompt. Svaki find mora se pojaviti točno jednom u promptu u stanju u kojem se nalazi kada dođe red na tu izmjenu. Ako se ne pojavi, ništa se ne zapisuje, a pogreška navodi izmjenu:
| Kôd | Značenje | Što učiniti |
|---|---|---|
prompt_edit_not_found | Tekst find nije u trenutačnom nacrtu prompta. edit_index navodi o kojoj se izmjeni radi. | Ponovno pročitajte agenta i točno kopirajte odlomak. |
prompt_edit_ambiguous | Tekst find pojavljuje se više puta. occurrences navodi koliko puta. | Uključite više okolnog teksta. |
stale_prompt | expected_prompt_sha256 nije SHA-256 trenutačnog nacrta prompta: promijenio se nakon što ste ga pročitali. | Ponovno pročitajte agenta, preoblikujte izmjenu prema trenutačnom tekstu i pošaljite njegov SHA-256. |
conflict | Drugo je zapisivanje izvršeno između čitanja nacrta na poslužitelju i njegova zapisivanja. | Pokušajte ponovno; ovaj poziv nije promijenio nacrt. |
expected_prompt_sha256 nije obavezan i također štiti zapisivanje cijelog prompta. Upotrijebite prompt_sha256 iz review_prompt ili source_prompt_sha256 iz refactor_prompt. Svaki poziv koji mijenja prompt vraća prompt_sha256 za novi tekst, previous_prompt_sha256 kada je poslužitelj prvo pročitao nacrt te next_step koji predlaže review_prompt s postavljenim previous_prompt na tekst prije izmjene. REST API prihvaća samo cijeli prompt: PATCH /v1/agents/{agent_id} s prompt i if_updated_at.
Potvrđivanje destruktivnih radnji
Alati označeni slovom D mijenjaju ili uklanjaju nešto ili započinju pozivanje stvarnih osoba. Za one čije se radnje ne mogu poništiti potrebna su dva zahtjeva. Prvi zahtjev ne mijenja ništa i vraća:
{
"status": "confirmation_required",
"action": "Delete agent",
"target": { "id": 195, "name": "Front Desk Receptionist" },
"confirmation_token": "…",
"expires_in_seconds": 600,
"next_step": "…"
}Pomoćnik korisniku prikazuje na što to utječe i traži potvrdu. Zatim ponavlja zahtjev s istim argumentima i dodatnim confirmation_token. Token vrijedi 10 minuta, funkcionira jednom (čak i ako taj poziv ne uspije) te se odnosi na jednu organizaciju, jednu osobu, jedan alat i jedan točan skup argumenata, pa su za brisanje triju glasovnih agenata potrebne tri potvrde. campaign_action s pause ili stop preskače ovaj korak kako bi se pokrenuta kampanja uvijek mogla odmah zaustaviti, kao i test_integration s GET. Neki alati s oznakom D izvršavaju se jednim zahtjevom jer D označava njihov učinak, a ne potvrdu na strani poslužitelja: update_agent zamjenjuje ono što je sadržavala skica (discard_agent_draft to poništava), deploy_agent zamjenjuje aktivnu konfiguraciju, update_phone_number preusmjerava aktivne pozive, sync_mcp_server_tools zamjenjuje katalog alata udaljenog poslužitelja, import_voip_numbers preusmjerava brojeve na vašeg pružatelja telekomunikacijskih usluga, run_agent_tests i run_simulation mogu potrošiti kredit, send_sms i place_call kontaktiraju stvarnu osobu (place_call zadržava vlastitu potvrdu pristanka), a provision_phone_number kupuje broj. test_my_agent troši kredit za testiranje i zahtijeva consent_to_charge. run_replays također troši novac; njegova procjena za dry_run i ograničenje max_cost_cents služe kao zamjena za potvrdu. Vaš MCP klijent i dalje može zatražiti da ih odobrite.
Neke promjene koje se mogu poništiti i dalje čekaju potvrdu: block_callers, unblock_callers i save_voip_setup uvijek, update_org_settings kada isključuje upozorenje ili dodaje testni broj te update_agent kada njegovi attention_reasons isključuju jedno od upozorenja agenta. Njihov next_step traži da potvrdite točnu promjenu umjesto da upozorava kako se ona ne može poništiti.
Početni upiti
prompts/list oglašava dvanaest ponovno upotrebljivih tijekova rada:
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
Upotrijebite prompts/get s navedenim nazivom upita i njegovim deklariranim argumentima da biste primili korisničku poruku spremnu za pokretanje.
Resursi
resources/list izlaže javne, predmemorirane reference:
| URI | Sadržaj |
|---|---|
thunderphone://docs/llms.txt | Javni indeks dokumentacije. |
thunderphone://docs/quickstart | Markdown za brzi početak. |
thunderphone://pricing | Trenutačni javni Markdown s cijenama. |
thunderphone://guides/prompt-style | Vodič za stil upita glasovnog agenta prema kojem provjerava review_prompt. ID-jevi smjernica (P1, W2 i slično) oni su na koje se nalazi pozivaju. |
thunderphone://guides/working-with-thunderphone | Kako asistent treba raditi s ovim alatima: kratki krugovi rada na nacrtu, provjera prije svakog postavljanja, korisnikova potvrda za sve što je aktivno ili se naplaćuje te nikada ne tražiti tajne. |
Pročitajte pojedini resurs pomoću resources/read. Javna dohvaćanja koriste kratko vremensko ograničenje, ograničenje od 2 MiB i desetominutnu predmemoriju unutar procesa.
Protokol i pogreške
Poslužitelj podržava verzije protokola 2025-06-18 i 2025-03-26; vraća podržanu verziju klijenta, a u suprotnom odabire 2025-06-18. Implementira initialize, ping, alate, upite, resurse i obavijesti. Obavijesti vraćaju 202 Accepted. Ovaj poslužitelj bez stanja ne izlaže SSE slušatelj ni brisanje sesije, stoga GET i DELETE vraćaju 405 Method Not Allowed uz Allow: POST.
Neuspjesi alata ostaju uspješni JSON-RPC odgovori s isError: true. Njihov tekst sadržava kratku rečenicu nakon koje slijedi JSON blok:
{
"code": "insufficient_balance",
"detail": "There is not enough prepaid balance.",
"next_step": "Call get_billing_summary, add funds in Organization > Billing, then retry."
}Zasebni prefiks outbound_tcpa_confirmation_required: zadržava se za place_call. Nepoznate JSON-RPC metode vraćaju -32601 u HTTP odgovoru 200. MCP 2025-06-18 ne podržava JSON-RPC skupove zahtjeva te vraćaju jasnu pogrešku neispravnog zahtjeva -32600.