Open in
Naudokite ThunderPhone kaip MCP serverį
Kurkite, testuokite, tikrinkite ir valdykite ThunderPhone balso agentus naudodami Claude, ChatGPT, Claude Code, Codex, Cursor, VS Code arba kitą Streamable HTTP MCP klientą.
ThunderPhone pateikia Streamable HTTP Model Context Protocol serverį adresu:
https://api.thunderphone.com/v1/mcpTai yra priešinga kryptis nei nuotolinio MCP serverio prijungimas prie balso agento:
| Kryptis | Rezultatas |
|---|---|
| Nuotolinis MCP serveris → ThunderPhone agentas | Balso agentas gali iškviesti nuotolinio serverio įrankius. |
| ThunderPhone → jūsų MCP klientas | Jūsų programavimo agentas gali kurti, testuoti ir valdyti ThunderPhone. |
Autentifikavimas
Pagal numatytuosius nustatymus katalogo klientams naudokite OAuth: prisijunkite, pasirinkite organizaciją ir patvirtinkite prašomas teises. Atjunkite ją skiltyje Nustatymai → Sauga → Programos, kurias prijungėte. Pakeitus arba iš naujo nustačius slaptažodį ar pakeitus paskyros el. pašto adresą, ryšys taip pat panaikinamas, todėl vėliau iš naujo prijunkite klientą.
Klientams, sukonfigūruotiems naudojant API raktą, sukurkite sk_live_ raktą skiltyje Integracijos → API raktai ir pateikite jį MCP klientui kaip THUNDERPHONE_API_KEY. Raktas susietas su viena organizacija; kitai organizacijai priklausantis ID laikomas nerastu.
Organizacijos, tvarkančios PHI
Jei jūsų organizacijos skambučiuose gali būti saugomos sveikatos informacijos (PHI),
nes turite BAA su ThunderPhone arba jūsų agentai yra nurodyti kaip
tvarkantys PHI, pirmiau pateiktas URL niekada negrąžina skambučių turinio:
nuorašų, įrašų, įvertinimų, skambučių sąrašų, eksportų, kampanijų rezultatų, skambučių analizės ir
įžvalgų, iš tikrų skambučių sukurtų pokalbių ir atkūrimo rezultatų. Šie įrankiai grąžina klaidą su
code: "phi_content_unavailable". Agentų kūrimas, testavimas ir konfigūravimas
veikia kaip įprastai.
Šis URL yra nurodytas viešuose padėjėjų kataloguose, kuriuose negali būti PHI. Jei jūsų organizacija turi savo BAA su padėjėjo teikėju, taikomą jūsų naudojamai darbo sričiai:
- Organizacijos administratorius ThunderPhone atidaro Organizacija → Bendrieji → AI padėjėjo prieiga ir patvirtina, kad susitarimas taikomas.
- Vietoje to prijunkite padėjėją kaip pasirinktinę jungtį naudodami šį URL:
https://api.thunderphone.com/v1/mcp/baaTuomet ten pasiekiamas skambučių turinys, įskaitant skambučius, kuriuose gali būti PHI. Atšaukus patvirtinimą, prieiga sustabdoma per kitą padėjėjo užklausą. Skambutis, kurį jūsų organizacija priskyrė kaip neturintį PHI, pasiekiamas abiem URL.
CLI ir stdio alternatyvos
ThunderPhone CLI gali įrašyti kliento konfigūraciją, išsaugodama nesusijusius serverius:
npx -y @thunderphone/mcp setup --client cursor --api-key-env THUNDERPHONE_API_KEY
npx thunderphone mcp setup --client claude-desktop --scope userVisuotinai įdiegę @thunderphone/mcp, naudokite thunderphone-mcp setup su
tomis pačiomis parinktimis. Sąranka palaiko Claude Code, Codex, Cursor, VS Code, Gemini, Claude
Desktop ir Windsurf. Pirmenybė teikiama tiesioginiam HTTP; Claude Desktop naudoja stdio.
Bet kuriam stdio palaikančiam klientui sukonfigūruokite command: "npx" su
args: ["-y", "@thunderphone/mcp"]. Paketas pirmiausia naudoja THUNDERPHONE_API_KEY,
tada kredencialus iš thunderphone login, atnaujindamas nebegaliojančius prieigos raktus, o po to
OAuth per mcp-remote. Įrenginio prisijungimui ir OAuth reikia atitinkamo API
OAuth įdiegimo. Naudojant API raktą jo nereikia. Tiesioginės HTTP konfigūracijos neskaito
CLI kredencialų saugyklos; norėdami pakartotinai naudoti įrenginio prisijungimą, naudokite stdio paketą.
Tai yra alternatyvos toliau pateikiamoms rankinėms klientų konfigūracijoms.
Kliento konfigūracija
Claude ir ChatGPT prisijungia naudodami OAuth; API rakto nereikia. Jei dar neturite ThunderPhone paskyros, prisijungimo puslapyje pasirinkite Sukurti paskyrą ir, patvirtinę el. paštą, grįšite į patvirtinimo ekraną.
Claude (žiniatinklis, kompiuteris ir mobilieji įrenginiai)
- Atidarykite Tinkinti → Jungtys (senesnėse versijose – Nustatymai → Jungtys). Jei ThunderPhone rodomas jungčių kataloge, pasirinkite jį. Kitu atveju pasirinkite Pridėti pasirinktinę jungtį, suteikite jai pavadinimą
ThunderPhoneir įveskitehttps://api.thunderphone.com/v1/mcp. - Pasirinkite Prisijungti, prisijunkite prie ThunderPhone, pasirinkite organizaciją ir patvirtinkite leidimus.
- Pokalbyje įrankių meniu įjunkite ThunderPhone ir paprašykite, ko jums reikia, pavyzdžiui, „Išvardyk mano agentus“.
Claude prieš pirmą kartą naudodamas kiekvieną įrankį paprašo patvirtinimo. Norėdami praleisti daugumą šių užklausų, atidarykite Tinkinti → Jungtys → ThunderPhone ir nustatykite, kad Tik skaitymo įrankiai visada būtų leidžiami. Šie įrankiai tik peržiūri informaciją: agentus, skambučius, transkripcijas, balansus, dokumentaciją. Jei prieš kiekvieną pakeitimą norite jį peržiūrėti, palikite Rašymo ir trynimo įrankius su patvirtinimu.
Pasirinktinėms jungtims reikalingas mokamas Claude planas. Team ir Enterprise planuose savininkas pirmiausia prideda jungtį organizacijos jungčių nustatymuose, tada kiekvienas narys prijungia savo ThunderPhone paskyrą.
Kuo Claude skiriasi
Claude (jungtis ir „Claude Code“ papildinys) gauna siauresnį įrankių rinkinį pagal Claude jungčių katalogo politiką:
- Kiekvienas skambutis ir žinutė patvirtinami po vieną.
place_callirsend_smspirmiausia grąžina peržiūrą (agentą, skambinančiojo ir gavėjo numerius, o žinutės atveju – jos tekstą) beiconfirmation_token; niekas nėra skambinama ar siunčiama, kol Claude po jūsų patvirtinimo nepakartoja užklausos su žetonu. - Kampanijų valdymo nėra.
create_campaign,add_campaign_contactsircampaign_actionnepasiekiami; kurkite, įkelkite ir pradėkite kampanijas valdymo skydelyje.list_campaigns,get_campaign_statsircheck_campaignvis dar veikia. - Nėra
test_integration. Išbandykite integracijos užklausą jos puslapyje valdymo skydelyje. preview_voicepaleidžia fiksuotą pasisveikinimo pavyzdį pasirinktu balsu ir kalba; jis neskaito pasirinktinio teksto.list_voicesirlist_agentsgrąžina suvestinę;get_agentpateikia visą agento konfigūraciją.
DI informavimas
Kiekvienas skambutis, kurį ThunderPhone agentas inicijuoja arba į kurį atsiliepia, pradedamas žodiniu informavimu apie DI. Pagal numatytuosius nustatymus sakoma: „Šiame skambutyje dalyvauja DI asistentas, jis bus įrašomas ir transkribuojamas.“ Jo išjungti (consent_announcement_enabled nustatytas į false arba ai_live_processing_disclosure_override išjungtas) neleidžiama, nebent organizacijos administratorius prieš tai valdymo skydelyje, iš bet kurio kliento, įskaitant Claude, būtų užregistravęs pasirašytą patvirtinimą.
ChatGPT
- Jei ThunderPhone rodomas ChatGPT programų kataloge, pasirinkite jį ir prisijunkite.
- Kitu atveju atidarykite Nustatymai → Programos ir jungtys → Išplėstiniai nustatymai, įjunkite Kūrėjo režimą ir sukurkite jungtį su URL
https://api.thunderphone.com/v1/mcpbei OAuth autentifikavimu. - Prisijunkite prie ThunderPhone, pasirinkite organizaciją ir patvirtinkite leidimus. Įtraukite ThunderPhone į pokalbį iš įrankių meniu.
Agento ar telefono numerio ištrynimas, juodraščio atmetimas, kampanijos paleidimas ir bandomosios užklausos, galinčios įrašyti duomenis į išorinę sistemą, siuntimas abiejose programose reikalauja antro patvirtinimo; žr. Ardomųjų veiksmų patvirtinimas.
Claude Code
claude mcp add --transport http thunderphone https://api.thunderphone.com/v1/mcp \
--header "Authorization: Bearer $THUNDERPHONE_API_KEY"Codex
Pridėkite tai į ~/.codex/config.toml:
[mcp_servers.thunderphone]
url = "https://api.thunderphone.com/v1/mcp"
bearer_token_env_var = "THUNDERPHONE_API_KEY"Cursor
Sukurkite .cursor/mcp.json:
{
"mcpServers": {
"thunderphone": {
"url": "https://api.thunderphone.com/v1/mcp",
"headers": {
"Authorization": "Bearer ${env:THUNDERPHONE_API_KEY}"
}
}
}
}Claude Desktop
Pridėkite mcp-remote tarpinį komponentą į Claude Desktop konfigūraciją:
{
"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
Sukurkite .vscode/mcp.json ir įveskite raktą VS Code įvesties raginime:
{
"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}"
}
}
}
}Įrankiai
Kiekvienas įrankis turi MCP anotacijas. Lentelėse R reiškia tik skaitymą, D – destruktyvumą, I – idempotentiškumą, o O – sąveiką su išoriniu pasauliu arba tinklu. Brūkšnys reiškia, kad jokia užuomina nenustatyta.
Ryšys
| Įrankis | Pagrindiniai argumentai | Anotacijos | Ką atlieka |
|---|---|---|---|
get_connection_identity | — | R, I | Patvirtina prisijungimo duomenis ir grąžina organizaciją bei saugius prisijungimo duomenų metaduomenis. |
Agentai
| Įrankis | Pagrindiniai argumentai | Anotacijos | Ką jis atlieka |
|---|---|---|---|
list_agents | — | R, I | Pateikia agentų sąrašą. |
get_agent | agent_id | R, I | Gauna vieną agentą. |
create_agent | agento konfigūracija | — | Sukuria agentą. Naudoja tuos pačius nustatymus kaip update_agent, įskaitant steps, handoffs, intro_clip ir intro_ring_count. |
update_agent | agent_id, pakeisti laukai, pasirinktinis prompt_edits, expected_prompt_sha256 | D | Parengia laukus agento juodraštyje, pakeisdamas ankstesnes juodraščio reikšmes. Vykdoma be patvirtinimo veiksmo: įdiegtas agentas nesikeičia iki deploy_agent, o discard_agent_draft grąžina ankstesnę juodraščio būseną. Taip pat galite nustatyti max_hold_seconds, system_tool_settings ir words. Norėdami pakeisti dalį raginimo, siųskite prompt_edits (žr. Raginimo redagavimas vietoje). |
deploy_agent | agent_id, pasirinktinis if_updated_at | D, I | Perkelia juodraštį į produkcinę aplinką. |
discard_agent_draft | agent_id, pasirinktinis if_updated_at, confirmation_token antrojoje užklausoje | D, I | Atmeta parengtus pakeitimus. Du veiksmai, žr. Ardomųjų veiksmų patvirtinimas. |
duplicate_agent | agent_id, pasirinktinis name | — | Nukopijuoja agentą organizacijoje. |
delete_agent | agent_id, confirmation_token antrojoje užklausoje | D, I | Visam laikui pašalina agentą. Du veiksmai. |
list_agent_versions | agent_id | R, I | Pateikia įdiegtų konfigūracijos versijų sąrašą. |
list_prompt_revisions | agent_id, pasirinktinis source, limit, offset | R, I | Pateikia visus agento raginimo teksto pakeitimus, įskaitant juodraščius, kiekvienam nurodydama skirtumą nuo jo pakeistos redakcijos. Pasiekiama, kai jūsų ryšiui prieinamas agento iteravimo įrankių rinkinys (žr. toliau). |
review_prompt | agent_id, pasirinktinis prompt, previous_prompt, quote_id, max_cost_cents | — | Peržiūri raginimo juodraštį (arba jūsų atsiųstą tekstą) pagal raginimų stiliaus vadovą. Kiekviena išvada pacituoja ištrauką, nurodo gairę ir siūlo paieškos bei keitimo redagavimą; rezultate taip pat pateikiamas raginime prašomas elgesys su stabiliais ID, nurodoma, ar reikia pertvarkymo, ir, jei tai paties agento raginimas, ar reikia atnaujinti jo bandomuosius pokalbius. Agento nekeičia; sąrašas išsaugomas su jo raginimo redakcija. Mokama, todėl nepažymėta kaip tik skaitoma: pirmiausia gaukite kainos pasiūlymą naudodami dry_run, tada paleiskite dar kartą be dry_run, su grąžintu quote_id ir max_cost_cents. Šie mokami vykdymai dabar įskaičiuojami į tą patį organizacijos įrankių rinkinio limitą kaip ir kiti įrankių rinkinio vykdymai. Pasiekiama, kai jūsų ryšiui prieinamas agento iteravimo įrankių rinkinys (žr. toliau). |
refactor_prompt | agent_id, pasirinktinis prompt, inventory, instructions, quote_id, max_cost_cents | — | Perrašo raginimą pagal stiliaus vadovo formą ir susieja kiekvieną elgesį kaip išlaikytą, sujungtą, performuluotą arba pašalintą. Grąžina naują tekstą ir skirtumą, o pagal numatytuosius nustatymus jį dar kartą perskaito, kad pateiktų behavior_changes (pridėta, pašalinta arba pakeista) ir behavior_preserved; pritaikykite jį naudodami update_agent. Mokama: gaukite kainos pasiūlymą naudodami dry_run, tada vieną kartą paleiskite su grąžintu quote_id ir max_cost_cents. Pasiekiama, kai jūsų ryšiui prieinamas agento iteravimo įrankių rinkinys (žr. toliau). |
list_reusable_instructions | — | R, I | Pateikia pakartotinai naudojamų instrukcijų sąrašą: bendrų raginimo taisyklių, pridėtų prie daugelio agentų naudojant update_agent reusable_instruction_ids. |
create_reusable_instruction | name, content | — | Sukuria nepriskirtą pakartotinai naudojamą instrukciją. Tik administratoriams. |
Telefono numeriai ir ryšio tiekėjai
| Įrankis | Pagrindiniai argumentai | Anotacijos | Ką jis atlieka |
|---|---|---|---|
list_phone_numbers | — | R, I | Išvardija organizacijos numerius ir maršrutizavimą. |
get_phone_number_limits | — | R, I | Gauna valdomų numerių naudojimo duomenis ir limitus. |
provision_phone_number | pasirenkami area_code, city, state, idempotency_key | D, O | Perka ThunderPhone valdomą įeinančių skambučių numerį. |
list_voip_connections | — | R, I | Išvardija prijungtus klientų ryšio paslaugų teikėjus. |
search_voip_numbers | connection_id, country, type, pasirenkamas area_code | R, I, O | Ieško teikėjo numerių fonde. |
import_voip_numbers | connection_id, numbers | D, O | Importuoja numerius, kurie jau priklauso teikėjui. |
update_phone_number | phone_number_id, maršrutizavimo, etiketės ir žiniatinklio kabliuko laukai | D | Atnaujina numerio maršrutizavimą, įskaitant agento priskyrimą. |
delete_phone_number | phone_number_id, confirm, pasirenkamas release_at_provider, confirmation_token per antrą užklausą | D, I, O | Atlaisvina numerį. Du veiksmai. |
get_voip_setup_session | pasirenkamas session_id | R, I | Nuskaito vedamą teikėjo sąranką (būseną, kontrolinį sąrašą, klausimą, į kurį ji laukia atsakymo) arba išvardija atviras sąrankas. Sąranka pradedama valdymo skydelyje, nes reikalingas teikėjo slaptažodis. Tik administratoriams. |
answer_voip_setup_question | session_id, question_id, answer | O | Perduoda naudotojo atsakymą sąrankai. Slaptažodžiai, sutikimas atlikti bandomąjį skambutį, serverio adresas, naudotojo vardas ir leidimas ThunderPhone prisijungti prie teikėjo paskyros atsakomi tik sąrankos vedlyje; šiais atvejais grąžina vedlio nuorodą ir nieko nesiunčia. |
save_voip_setup | session_id, pasirenkamas name, confirmation_token per antrą užklausą | D, I, O | Išsaugo prijungtą jungties juodraštį, kad jį būtų galima naudoti. Du veiksmai. |
check_phone_number | phone_number arba phone_number_id | R, I, O | Diagnostikuoja vieną iš organizacijos numerių pagal duomenis: maršrutizavimą, ryšį, patvirtinimą, naujausius teikėjo ir bandomuosius skambučius bei vietą, į kurią teikėjas jį nukreipia. |
SMS
| Įrankis | Pagrindiniai argumentai | Anotacijos | Ką jis daro |
|---|---|---|---|
send_sms | from_number, to, body, idempotency_key | D, I, O | Siunčia vieną paprastojo teksto SMS per prijungtą Twilio arba Telnyx numerį. |
Skambučiai
| Įrankis | Pagrindiniai argumentai | Anotacijos | Ką jis daro |
|---|---|---|---|
list_calls | pasirenkami filtrai, limit, offset | R, I | Išvardija skambučius naudodamas REST skambučių istorijos filtrus, įskaitant exclude_test_calls. |
get_call | call_id | R, I | Gauna skambučio būseną ir metaduomenis. |
get_call_transcript | call_id, pasirenkamas live | R, I | Gauna skambučio transkriptą. |
get_call_audio_url | call_id, pasirenkamas download | R, I, O | Grąžina pasirašytą garso URL; garsas niekada netransliuojamas per MCP. |
get_call_grade | call_id | R, I | Gauna naujausią skambučio įvertinimą. |
place_call | agent_id, from_number, to_number | D, O | Atlieka vieną neidemponentinį išeinantį skambutį. |
export_calls | skambučių filtrai, export_format | R, I | Eksportuoja iki REST galinio taško ribos JSON arba CSV formatu. |
get_call_analytics | pasirenkami since_days, agent_id | R, I | Agreguoja realius skambučius pagal būseną, kryptį, rezultatą, įvertinimą ir problemą, o bandomieji skambučiai skaičiuojami atskirai. |
get_call_insights | call_ids (iki 10) | R, I | Vienu metu gauna kelių skambučių įvertinimą, rezultatą, suvestinę ir aptiktas problemas. |
Testavimas ir tikrinimas
| Įrankis | Pagrindiniai argumentai | Anotacijos | Ką jis daro |
|---|---|---|---|
list_test_scenarios | agent_id | R, I | Išvardija testavimo scenarijus. |
create_test_scenario | agent_id, title, scenario_prompt, pasirinktinės sąlygos | — | Sukuria scenarijų. |
generate_test_scenarios | agent_id, pasirinktiniai count, include_edge_cases, locale | O | Generuoja scenarijus pagal agento raginimą. |
run_agent_tests | agent_id, channel, consent_to_charge, pasirinktinė atranka arba matrica | D, O | Vykdo scenarijus žiniatinklyje arba telefonijos kanalu. |
get_test_run | agent_id, batch_id | R, I | Gauna paketo būseną ir kiekvieno scenarijaus rezultatus. |
test_my_agent | agent_id, consent_to_charge, pasirinktiniai scenario_ids, count, wait_seconds | D, O | Testuoja agentą vienu iškvietimu: vykdo jo išsaugotus scenarijus (generuodamas dalį, jei jų nėra) ir laukia sprendimų iki minutės arba grąžina batch_id, skirtą get_test_run. Apmokestinama kaip run_agent_tests. |
test_in_text | agent_id, callers (nuo 1 iki 3 aprašymų), pasirinktiniai version, direction | O | Laisvos formos teksto testas: imituoti skambintojai tekstu bendrauja su agento juodraščiu (arba veikiančia versija) per tikrą procesą, o transkripcijos grąžinamos maždaug per minutę. Įrankio rezultatai yra imituoti. |
run_simulation | agent_id, consent_to_charge, pasirinktiniai scenario_prompt, direction, language | D, O | Pradeda vieną imituotą telefono skambutį tarp DI skambintojo ir agento juodraščio, kad žmogus galėtų išklausyti pakeitimą. Grąžina vykdymą su būsena in_progress. Jis įrašomas, kai agentas įrašo skambučius, ir įvertinamas jam pasibaigus. Apmokestinamas kaip testinis skambutis, pirmiausia naudojant nemokamą testavimo biudžetą. |
get_simulation | simulation_id | R, I | Gauna imituoto skambučio būseną ir, jam pasibaigus, jo rezultatą: trumpai galiojantį įrašo URL bei transkripciją, kai agentas įrašo skambučius, ir įvertinimą, kai vertinimas baigiamas (iki tol null). |
list_validation_runs | agent_id | R, I | Išvardija naujausius juodraščio patvirtinimo vykdymus. |
get_validation_status | agent_id | R, I | Gauna naujausią patvirtinimo būseną ir juodraščio atitiktį. |
list_conversations | agent_id, pasirinktiniai split, source | R, I | Išvardija pokalbius, su kuriais testuojamas agentas. Reikalingas agento iteravimo įrankių rinkinys. |
get_conversation | conversation_id | R, I | Gauna vieną testavimo pokalbį su dabartiniais jo ėjimais. Reikalingas agento iteravimo įrankių rinkinys. |
get_conversation_revisions | conversation_id, pasirinktiniai limit, offset | R, I | Išvardija kiekvieną testavimo pokalbio versiją: kaip ir kodėl ji pasikeitė (atnaujinta pasikeitus raginimui, atkurta iš ankstesnės versijos), pridėtą, pašalintą ir pakeistą elgseną, perkeltus arba nebenaudojamus pavyzdžius ir eilučių skirtumus. Reikalingas agento iteravimo įrankių rinkinys. |
generate_conversations | agent_id, pasirinktiniai count, style | O | Sukuria imituotus testavimo pokalbius su agento juodraščiu ir sunkiausius jų momentus paverčia patvirtinimo pavyzdžiais su atsakymų raktais. Pirmiausia gaukite kainos pasiūlymą naudodami dry_run; tikram vykdymui reikia jo quote_id ir max_cost_cents. Reikalingas agento iteravimo įrankių rinkinys. |
import_conversations | agent_id, pasirinktiniai since_days, max_calls | O | Paverčia naujausius agento skambučius testavimo pokalbiais (daugiausia po du vienam skambintojui, skambučiai be įrašymo praleidžiami), o sunkiausius jų momentus — pavyzdžiais. Pirmiausia gaukite kainos pasiūlymą naudodami dry_run; tikram vykdymui reikia jo quote_id ir max_cost_cents. Reikalingas agento iteravimo įrankių rinkinys. |
refresh_conversations | agent_id, pasirinktiniai conversation_ids, from_prompt_revision_id | O | Atnaujina agento testavimo pokalbius pagal dabartinį raginimą, kai elgsena buvo pridėta, pašalinta ar pakeista: iš naujo susieja, atkuria ankstesnę versiją (įskaitant tikrą garsą) arba perrašo pasenusius ėjimus ir nebetaiko pavyzdžių, kurių skambintojo ėjimo nebeliko. Pirmiausia gaukite kainos pasiūlymą naudodami dry_run; tikram vykdymui reikia jo quote_id ir max_cost_cents. Reikalingas agento iteravimo įrankių rinkinys. |
get_conversation_job | job_id | R, I | Gauna generavimo, importavimo arba atnaujinimo užduotį: būseną, iki šiol patirtą kainą pagal jos ribą ir tai, ką ji sukūrė arba atnaujino. Reikalingas agento iteravimo įrankių rinkinys. |
run_replays | agent_id, pasirinktiniai overrides, split, engine, sample_size, sample_seed, max_cost_cents, quote_id, dry_run | D, O | Pakartoja agento pavyzdžių imtį su jo juodraščiu arba su pakeitimais, pvz., kandidatiniu raginimu, balsu ar pakopa, ir įvertina kiekvieną atsakymą pagal pavyzdžio atsakymų raktą. Tikslūs pakartojimai paleidžia įrašytą ėjimo garsą taip, kaip tai darytų tiesioginis skambutis; sėkmės rodikliai pateikiami pagal modulį. PHI skambučių pakartojimai vykdomi kaip PHI, o konfigūracija, kurios jie negali vykdyti (ElevenLabs balsas, eksperimentinis produktas), atmetama. dry_run grąžina įvertį, pasirinktą sample_seed ir quote_id; tikras vykdymas siunčia tą pačią užklausą su tuo quote_id bei sample_seed ir max_cost_cents — griežta riba: prieš siunčiant kiekvieną užklausą rezervuojama jos didžiausia galima kaina, o vykdymas sustoja, užuot siuntęs netelpančią užklausą, todėl kiekvienam vykdytojui palikite įverčio largest_reservation_cents rezervą. Tikslus pakartojimas rezervuoja blogiausio atvejo sumą — apie 85 centus iki $1.25 už vieną vykdomą pakartojimą įprastam ėjimui (vienu metu vykdomi du), nors tikroji kaina yra keli centai; už vykdymą mokama pagal tikrąją pakartojimų kainą, todėl max_cost_cents nustatykite su atsarga. Tikslus pakartojimas vykdomas su biudžetu, skirtu įprastam ėjimui ir vienam pakartotiniam bandymui, kokio reikia produkcinėje aplinkoje (atsakymo varžymasis iš naujo ir stebėtojo pakartotinis bandymas); ėjimas, kuriam reikia daugiau, užregistruojamas kaip klaida replay_budget_exhausted, skaičiuojamas atskirai kaip budget_exhausted, neįtraukiamas į sėkmės rodiklį ir testavimo rinkinyje neišnaudoja jokios kohortos. Testavimo rinkinyje kohorta su įrašytu skambintojo garsu, naudojant kitą nei Bolt v2 konfigūraciją, atmetama (test_needs_exact_replay) ir lieka nepanaudota: tokią konfigūraciją matuokite kūrimo rinkinyje. Reikalingas agento iteravimo įrankių rinkinys. |
compare_configs | agent_id, configs (nuo 2 iki 4, pirmoji yra bazinė), pasirinktiniai sample_size, sample_seed, max_cost_cents, quote_id, dry_run | O | Pakartoja tuos pačius pavyzdžius su kiekviena konfigūracija ir pateikia sėkmės rodiklį, palyginti su bazine konfigūracija pataisytus ir sugadintus pavyzdžius, delsą iki pirmojo garso, kaip dažnai skambintojas laukė patvirtinimo, signalų ar tylos, ir kainą už ėjimą pagal modulį. Gaukite kainos pasiūlymą naudodami dry_run, kaip ir run_replays. Tik kūrimo rinkiniui: testavimo rinkinyje jis atmetamas (comparison_dev_only); palyginkite kūrimo rinkinyje, tada pasirinkimą pamatuokite naudodami run_replays. Reikalingas agento iteravimo įrankių rinkinys. |
get_replay_run | run_id, pasirinktiniai include_trace | R, I | Gauna pakartojimo vykdymo bendrus duomenis, pasikeitimus ir kiekvieno pavyzdžio rezultatus bei jo palyginimo grupę. Tikslūs pakartojimai, kuriems reikėjo daugiau nei jų biudžetas, skaičiuojami atskirai (budget_exhausted), neįtraukiant jų į sėkmės rodiklį. Reikalingas agento iteravimo įrankių rinkinys. |
create_talk_link | agent_id, pasirinktiniai variant_id, language, expires_in_minutes | O | Sukuria vienkartinę nuorodą, kurią žmogus atidaro naršyklėje, kad pasikalbėtų su dabartiniu agento juodraščiu, kaip naudojant skydelio mygtuką „Kalbėtis“. Pagal numatytuosius nustatymus nuoroda baigia galioti po 30 minučių (daugiausia po 120); pokalbis apmokestinamas kaip „Kalbėtis“ testinis skambutis. Žr. „Kalbėtis“ nuorodos. |
Įrankiai, pažymėti kaip reikalaujantys agento iteracijų įrankių rinkinio, yra jo dalis; kol įrankių rinkinys yra beta versijoje, jis įjungiamas kiekvienai organizacijai atskirai, o be jo jie grąžina feature_not_enabled ir nurodo, ką daryti toliau. Kiekvienas agento pokalbis yra jo kūrimo arba testavimo aibėje. Testavimo aibė skirta pakeitimui įvertinti, o ne jam derinti, todėl pokalbių įrankiai testavimo aibės pokalbiui grąžina tik jo ID, aibę, šaltinį, būseną ir skaičius. Atkūrimo vykdymas testavimo aibėje pakartoja vieną visą testavimo kohortą (nepaisoma sample_size ir sample_seed), kiekvieną pavyzdį naudodamas jo duomenų leidžiamą variklį, prieš vykdymą nustatytą pagal pavyzdį (tiksliai įrašytam skambintojo garsui, tekstu tik tekstiniam pavyzdžiui; kitokia nei Bolt v2 konfigūracija neturi tikslaus kelio, todėl kohorta su įrašytu garsu jai atmetama su test_needs_exact_replay ir lieka nepanaudota; engine praleidžiamas arba nustatomas kaip auto, nes exact arba text atmetami su test_engine_per_example, o į tekstą niekas negrįžta), ir grąžina tik bendrus rodiklius pagal variklį: sėkmės rodiklį, nesėkmes pagal sunkumą ir tipą, delsą bei kainą. Pirmasis rezultatas, kuriame išsaugomas atkūrimas, sunaudoja kohortą, todėl kitas testavimo vykdymas, bet kuriai užklausai, paima kitą, o kai jų nebelieka, jis atmetamas su no_test_cohort (skambučių importavimas arba pokalbių generavimas papildo naujas kohortas); vykdymas, kuris baigiasi neišsaugojęs atkūrimo (Core negali tiksliai atkurti jo garso pavyzdžių, exact_replay_unavailable, jo atkūrimo pajėgumas lieka užimtas, core_busy, arba kiekvienam ėjimui baigėsi biudžetas, replay_budget_exhausted), palieka kohortą nepanaudotą. Kūrimo aibėje tikslus atkūrimas, kurio Core negali vykdyti, grįžta prie teksto, o vykdymas pažymimas kaip degraded. Palyginimai vykdomi tik kūrimo aibėje. Kiekvienas mokamas įrankis priima savo bandomojo vykdymo quote_id, galiojantį vienam vykdymui: jam prasidėjus, jis vieną kartą ir negrįžtamai sunaudojamas, o atmestas pradėjimas arba pradėjimas, kuris nepavyksta iki tol, palieka jį tinkamą naudoti; jei vykdymas vėliau nepavyksta, tai nurodoma, o jis kartojamas su nauju bandomuoju vykdymu, skirtu naujam quote_id. Naudojant OAuth, review_prompt ir refactor_prompt reikia agents:write apimties, įskaitant bandomuosius vykdymus, o pokalbių ir atkūrimo įrankiams vykdyti reikia testing:write. Žmonės valdymo skydelyje mato visą testavimo aibę. Skambutis, kurio skambintojas yra agento testavimo aibėje, yra neįtrauktas, nes jis yra testavimo rinkinio dalis. Organizacijoje su įrankių rinkiniu list_calls, get_call, get_call_transcript, get_call_audio_url, get_call_grade ir export_calls jį grąžina tiksliai kaip {"call_id", "start_time", "held_out": true} (eksporto eilutėse vietoje start_time naudojamas started_at), be jo transkripcijos, įrašo, istorijos, įvertinimo ar ataskaitos; kiekvieno kito skambučio lauko nėra, todėl prieš ką nors kita neįtrauktą eilutę tikrinkite pagal jos held_out. REST API tą patį taiko API raktams ir OAuth prieigos raktams, o jos rodiniuose, apimančiuose daug skambučių, pavyzdžiui, ataskaitų suvestinėse, problemų grupėse, tyrimuose ir srauto ataskaitose, neįtraukti skambučiai neįtraukiami į skaičius, grupes ir imtis, taip pat nepateikiamas joks modelio jiems sukurtas tekstas. Rašymo veiksmas su neįtrauktu skambučiu, pavyzdžiui, vertinimas, perkėlimas į testavimo scenarijų ar ėjimo generavimas iš naujo, atmetamas su held_out_call. Testavimo scenarijus, kurį kas nors perkėlė iš neįtraukto skambučio, iš list_test_scenarios ir testavimo vykdymuose grąžinamas tiksliai kaip {"id", "held_out": true}, o iš jo sukurtas simuliacijos vykdymas, naudojant get_test_run ir simuliacijos įrankius, grąžinamas tiksliai kaip {"id", "scenario_id", "held_out": true}; jo simuliuoti skambučiai taip pat yra neįtraukti, tačiau testavimo vykdymai vis tiek jį vykdo. Kūrimo aibės pokalbis, pavyzdys arba atkūrimo rezultatas, nukopijuotas iš neįtraukto skambintojo skambučio, pateikiamas kaip testavimo aibės elementas (aibės yra nustatomos kiekvienam agentui, todėl tas skambintojas gali būti kito agento testavimo aibėje). Žmonės valdymo skydelyje neįtrauktus skambučius mato visus, o administratorius gali suteikti vienam API raktui galimybę juos matyti visus, naudodamas include_held_out_calls, kuris pagal numatytuosius nustatymus išjungtas ir nustatomas tik valdymo skydelyje, integracijai, kuriai reikia kiekvieno skambučio; MCP jo niekada nenaudoja. Žiniatinklio kabliai nesikeičia. Organizacijos be įrankių rinkinio nemato jokio held_out lauko ir joms niekas nesikeičia.
generate_conversations, import_conversations ir refresh_conversations naudoja modelio kreditus. Pirmiausia iškvieskite jas su dry_run: true: atsakyme gausite išsamų kainos pasiūlymą su quote_id, o niekas nebus vykdoma. Pasiūlyme įskaičiuojama kiekviena užklausa, kurią vykdymas gali atlikti įprastu mastu. Tikram vykdymui reikia to quote_id (jis nustoja galioti po 15 minučių ir veikia tik su tais pačiais argumentais) ir max_cost_cents – griežtos ribos: prieš kiekvieną užklausą užduotis rezervuoja didžiausią galimą tos užklausos kainą ir sustoja, užuot siuntusi netelpančią užklausą, išlaikydama tai, ką sukūrė. Dėl šio rezervo vykdymas gali sustoti neišnaudojęs dalies ribos; pasiūlymo largest_reservation_cents nurodo, kiek rezervo palikti. Imituoti skambintojai sukuriami pagal agento nurodymą; style: "adversarial" sukuria sudėtingus skambintojus, kurie spaudžia silpnąsias nurodymo vietas, ir šie pokalbiai visada patenka į kūrimo atskirtį. target: "changed_behaviors" nukreipia skambintojus į tai, kas pasikeitė paskutiniame nurodymo redagavime. Kiekvienas agentas vienu metu vykdo vieną iš šių užduočių arba vieną pakartotinio atkūrimo vykdymą, todėl atnaujinimas niekada nepakeičia pavyzdžių, kuriuos naudoja vykdomas pakartotinis atkūrimas; bandant pradėti vykdymą, kol vykdomas kitas, grąžinama job_active, replay_run_active arba conversation_job_active su informacija, ko laukti.
Po nurodymo redagavimo, kuriuo pridedama, pašalinama arba keičiama elgsena, review_prompt agento juodraštyje nurodo, kiek testavimo pokalbių buvo sukurta pagal nurodymą su kitomis elgsenomis (conversations.refresh_suggested). Tuomet refresh_conversations juos atnaujina pagal juodraštį, kad kūrimo ir testavimo rinkiniai matuotų naują nurodymą pagal istorijas, kurias jis galėjo sukurti. Atnaujinant niekas neprarandama: kiekviename pokalbyje išlaikoma kiekviena ankstesnė versija, o grįžus pašalintai taisyklei atkuriama versija iš laiko, kai ji galiojo, su tikru skambintojo garso įrašu. Programavimo agento pradėtas atnaujinimas neįtraukia į pasirinkimą, pasiūlymą, eigą ir kainą testavimo atskirties pokalbių bei pokalbių, nukopijuotų iš neįtrauktų skambučių; nurodžius vieną iš jų conversation_ids, grąžinama 403 test_conversation. Asmuo juos atnaujina valdymo skydelyje, o programavimo agentams tos užduoties rezultatuose jie rodomi tik kaip ID ir skaičiai. active pavyzdys, kurio istoriją, atsakymą ar atsakymų raktą atnaujinimas perrašo, grįžta į pending_review būseną su žyma refreshed_needs_review. Atnaujinimo pasiūlyme kiekvienas perskaitytas pokalbis įkainojamas taip, tarsi būtų perrašytas, kiekvienas modelio iškvietimas – pagal jo išvesties ribą, o pasiūlymas galioja nurodymui ir pokalbiams, pagal kuriuos jis buvo pateiktas: jei prieš vykdymą pasikeičia kuris nors iš jų, pateikite naują pasiūlymą; jei nurodymas pasikeičia vykdymo metu, užduotis sustoja kaip failed, išlaikydama tai, ką atnaujino.
Žinios
| Įrankis | Pagrindiniai argumentai | Anotacijos | Ką atlieka |
|---|---|---|---|
list_knowledge_bases | — | R, I | Pateikia žinių bazių sąrašą. |
create_knowledge_base | name, pasirinktinis description | — | Sukuria žinių bazę. |
add_knowledge_document | knowledge_base_id, name, content | — | Prideda tekstą arba Markdown. |
import_knowledge_url | url, pasirinktinis name | O | Įtraukia viešą puslapį į saugaus įkėlimo eilę. |
search_knowledge | knowledge_base_id, query | R, I | Ieško produkcinėje paieškoje. |
Integracijos, saityno kabliai ir nuotoliniai MCP serveriai
| Įrankis | Pagrindiniai argumentai | Anotacijos | Ką jis atlieka |
|---|---|---|---|
list_integrations | — | R, I | Išvardija HTTP funkcijų integracijas. |
create_integration | display_name, funkcijos spec, pasirenkami galinio taško laukai | — | Sukuria HTTP įrankį. Autentifikavimo antraštes pridėkite valdymo skydelyje. |
test_integration | url, pasirenkamas metodas / turinys / laikas baigėsi, integration_id su header_names, confirmation_token antrojoje užklausoje | D, O | Siunčia ribotą, nuo SSRF apsaugotą bandomąją užklausą. Išsaugotos antraščių reikšmės užpildomos iš integracijos ir siunčiamos tik į jos pagrindinį kompiuterį. POST (numatytasis), PUT, PATCH ir DELETE vykdomi dviem etapais; GET vykdomas iš karto. |
list_webhook_endpoints | — | R, I | Išvardija pasirašytus žiniatinklio kablio galinius taškus. |
list_webhook_deliveries | pasirenkamas agent_id, pasirenkamas endpoint_id | R, I | Išvardija naujausius žiniatinklio kablio pristatymo rezultatus be naudingųjų duomenų. |
create_webhook_endpoint | label, url, pasirenkami įvykiai / būsena | O | Sukuria pasirašytą žiniatinklio kablio galinį tašką. |
copy_webhook_endpoint | endpoint_id, target_agent_id | I | Nukopijuoja agento žiniatinklio kablį, įskaitant pasirašymo slaptąjį raktą, į kitą serveryje esantį agentą. Tik administratoriams. |
test_webhook_endpoint | endpoint_id | O | Siunčia sintetinį įvykį įprastu pristatymo būdu. |
list_mcp_servers | — | R, I | Išvardija nuotolinius serverius, kuriuos gali iškviesti balso agentai. |
create_mcp_server | display_name, url | O | Užregistruoja ir sinchronizuoja nuotolinį serverį. Serveriai, kuriems reikia autentifikavimo antraščių, pridedami valdymo skydelyje. |
sync_mcp_server_tools | server_id | D, O | Atnaujina nuotolinio serverio įrankių katalogą. |
Kampanijos
| Įrankis | Pagrindiniai argumentai | Anotacijos | Ką jis atlieka |
|---|---|---|---|
list_campaigns | — | R, I | Išvardija išeinančių skambučių kampanijas. |
create_campaign | kampanijos laukai | — | Sukuria kampanijos juodraštį. |
add_campaign_contacts | campaign_id, contacts | — | Prideda iki 5 000 JSON kontaktų. |
campaign_action | campaign_id, action, pasirenkami consent_to_charge, confirmation_token antrojoje užklausoje | D, O | Vykdo start, pause, resume arba stop. start ir resume vykdomi dviem etapais; pause ir stop vykdomi iš karto. |
get_campaign_stats | campaign_id | R, I | Gauna skaitiklius ir naujausius rezultatus. |
check_campaign | pasirenkami campaign_id, contact_phone_number, contact_status | R, I | Paaiškina, kodėl kampanija neskambina: jos skambinimo laiką pagal jos laiko juostą, kontaktus, kuriems reikia skambinti dabar, ir kas sustabdo rinkimą. |
Organizacijos nustatymai ir užblokuoti skambintojai
| Įrankis | Pagrindiniai argumentai | Anotacijos | Ką jis daro |
|---|---|---|---|
get_org_settings | — | R, I | Nuskaito laiko juostą, darbo valandas, testavimo numerius, skambučių rezultatų etiketes, būsenų pavadinimus ir išjungtus įspėjimus kartu su updated_at. |
update_org_settings | pakeisti nustatymai, if_updated_at, paprašius confirmation_token | D, I | Keičia juos (tik administratoriams). Sąrašai ir objektai pakeičia išsaugotą reikšmę. Įspėjimo išjungimas arba testavimo numerio pridėjimas atliekamas dviem veiksmais. Rezultate pateikiamos ankstesnės reikšmės, kad būtų galima anuliuoti. |
get_account_limits | — | R, I | Gauna platformos limitus su šios organizacijos reikšmėmis. |
list_blocked_callers | pasirenkami number, search | R, I | Pateikia užblokuotų skambintojų numerius. |
block_callers | numbers, pasirenkamas note, antroje užklausoje confirmation_token | D, I | Atmeta skambučius iš šių numerių, prieš atsakant bet kuriam agentui. Du veiksmai, tik administratoriams. |
unblock_callers | numbers, antroje užklausoje confirmation_token | D, I | Pašalina numerius iš blokavimo sąrašo. Du veiksmai, tik administratoriams. |
get_org_settings, update_org_settings ir get_account_limits reikia org:read arba org:write OAuth apimties; ryšio, sukurto prieš jiems atsirandant, pirmą kartą naudojant prašoma ją patvirtinti.
Galimybės, pagalba ir importai
| Įrankis | Pagrindiniai argumentai | Anotacijos | Ką jis daro |
|---|---|---|---|
get_supported_languages | — | R, I | Pateikia kalbas, kuriomis kalba agentai, kartu su kodais. |
get_agent_capabilities | — | R, I | Nurodo, ką agentas gali daryti skambučio metu ir kokie nustatymai bei integracijos yra prieinami. |
escalate_to_human | summary | O | Prašo ThunderPhone komandos pagalbos. Ji atsako ThunderPhone. Organizacijoms, kurios gali tvarkyti PHI, iš ThunderPhone perduodamas tik neutralus pranešimas. |
request_feature | title, request, details | O | Pateikia funkcijos užklausą ThunderPhone komandai. Ne daugiau kaip trys vienai organizacijai per dieną. |
start_agent_import | platform | R, I | Grąžina valdymo skydelio nuorodą, kurioje įvedate savo Vapi, Retell, ElevenLabs arba Bland raktą ir pasirenkate agentus. Nė vienas įrankis nepriima rakto. |
get_agent_import | pasirenkamas import_id | R, I | Pateikia naujausius importus arba vieno importo būseną ir susietus agentus. |
commit_agent_import | import_id, pasirenkami item_ids | O | Foniniu režimu sukuria agentus iš paruošto importo. Tik administratoriams. |
Balsai, atsiskaitymas ir dokumentacija
| Įrankis | Pagrindiniai argumentai | Anotacijos | Ką jis daro |
|---|---|---|---|
list_voices | — | R, I | Pateikia balsų ir palaikomų kalbų sąrašą. |
preview_voice | voice, language, text | O | Sugeneruoja pavyzdį ir grąžina pasirašytą URL. |
list_voice_clones | — | R, I | Pateikia tinkintų balso klonų sąrašą. |
get_billing_summary | — | R, I | Gauna likutį ir oficialias pakopų kainas; mokėjimų keitimo operacijos nepateikiamos. |
search_docs | query, pasirinktinis limit | R, I, O | Ieško viešajame dokumentacijos indekse. |
get_doc_page | path | R, I, O | Gauna vieną viešą Markdown dokumentacijos puslapį. |
Rezultatuose apie agentą, skambutį, numerį, kampaniją ar nustatymą pateikiamas web_url – atitinkamas valdymo skydelio puslapis, todėl galite jį atidaryti ThunderPhone arba tęsti darbą ten su Zeus.
Visi produkto įrankiai naudoja tuos pačius REST kodo kelius kaip viešoji API. Todėl REST tikrinimas, organizacijos aprėptis, vaidmenys, atsiskaitymo leidimai, kvotos, TCPA patvirtinimas, tiekėjo sauga ir audito veikimas taikomi nepakitę.
Tiesioginis raginimo redagavimas
update_agent gali pakeisti dalį juodraštinio raginimo nesiunčiant viso teksto iš naujo. prompt_edits yra rikiuotas paieškos ir keitimo porų sąrašas, tokio pat formato, kokį grąžina review_prompt ir 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."
}
]
}Serveris pritaiko pakeitimus eilės tvarka dabartiniam agento juodraštiniam raginimui (įdiegtam raginimui, kai juodraščio nėra) ir įrašo rezultatą į juodraštį tuo pačiu keliu kaip ir viso raginimo update_agent. Kiekvienas find turi pasirodyti raginime tiksliai vieną kartą tuo metu, kai ateina to pakeitimo eilė. Jei taip nėra, niekas neįrašoma, o klaida nurodo pakeitimą:
| Kodas | Reikšmė | Ką daryti |
|---|---|---|
prompt_edit_not_found | find tekstas nėra dabartiniame juodraštiniame raginime. edit_index nurodo, kuris tai pakeitimas. | Dar kartą nuskaitykite agentą ir tiksliai nukopijuokite ištrauką. |
prompt_edit_ambiguous | find tekstas pasirodo daugiau nei vieną kartą. occurrences nurodo, kiek kartų. | Įtraukite daugiau aplinkinio teksto. |
stale_prompt | expected_prompt_sha256 nėra dabartinio juodraštinio raginimo SHA-256: jis pasikeitė po to, kai jį perskaitėte. | Dar kartą nuskaitykite agentą, perrašykite pakeitimą pagal dabartinį tekstą ir išsiųskite jo SHA-256. |
conflict | Kitas įrašymas įvyko tarp serverio atliekamo juodraščio nuskaitymo ir jo įrašymo. | Bandykite dar kartą; šis iškvietimas juodraščio nepakeitė. |
expected_prompt_sha256 yra pasirenkamas ir taip pat apsaugo viso raginimo įrašymą. Naudokite prompt_sha256 iš review_prompt arba source_prompt_sha256 iš refactor_prompt. Bet kuris iškvietimas, pakeičiantis raginimą, grąžina prompt_sha256 naujam tekstui, previous_prompt_sha256, kai serveris pirmiausia nuskaitydavo juodraštį, ir next_step, siūlantį review_prompt, kuriame previous_prompt nustatytas į tekstą prieš pakeitimą. REST API priima tik visą raginimą: PATCH /v1/agents/{agent_id} su prompt ir if_updated_at.
Destruktyvių veiksmų patvirtinimas
Įrankiai, pažymėti D, ką nors pakeičia arba pašalina arba pradeda rinkti tikrų žmonių numerius. Tiems, kurių negalima atšaukti, reikia dviejų užklausų. Pirmoji užklausa nieko nekeičia ir grąžina:
{
"status": "confirmation_required",
"action": "Delete agent",
"target": { "id": 195, "name": "Front Desk Receptionist" },
"confirmation_token": "…",
"expires_in_seconds": 600,
"next_step": "…"
}Asistentas parodo naudotojui, kas bus paveikta, ir paprašo patvirtinimo. Tada jis pakartoja užklausą su tais pačiais argumentais ir confirmation_token. Prieigos raktas galioja 10 minučių, veikia vieną kartą (net jei tas iškvietimas nepavyksta) ir taikomas vienai organizacijai, vienam asmeniui, vienam įrankiui bei vienam tiksliam argumentų rinkiniui, todėl norint ištrinti tris agentus reikia trijų patvirtinimų. campaign_action su pause arba stop praleidžia šį veiksmą, kad vykdomą kampaniją visada būtų galima nedelsiant sustabdyti; taip pat jį praleidžia test_integration su GET. Kai kurie D įrankiai vykdomi viena užklausa, nes D žymi jų poveikį, o ne serverio patvirtinimą: update_agent pakeičia tai, kas buvo juodraštyje (discard_agent_draft tai atšaukia), deploy_agent pakeičia aktyvią konfigūraciją, update_phone_number peradresuoja aktyvius skambučius, sync_mcp_server_tools pakeičia nuotolinio serverio įrankių katalogą, import_voip_numbers nukreipia numerius į jūsų ryšio operatorių, run_agent_tests ir run_simulation gali panaudoti kreditą, send_sms ir place_call susisiekia su realiu asmeniu (place_call išlaiko atskirą sutikimo patvirtinimą), o provision_phone_number įsigyja numerį. test_my_agent naudoja testavimo kreditą ir reikalauja consent_to_charge. run_replays taip pat naudoja pinigus; jo dry_run sąmata ir max_cost_cents riba pakeičia patvirtinimą. Jūsų MCP klientas vis tiek gali paprašyti juos patvirtinti.
Kai kurie pakeitimai, kuriuos galima anuliuoti, vis tiek laukia patvirtinimo: block_callers, unblock_callers ir save_voip_setup visada, update_org_settings, kai išjungiamas įspėjimas arba pridedamas testinis numeris, ir update_agent, kai jo attention_reasons išjungia vieną iš agento įspėjimų. Jų next_step prašo patvirtinti tikslų pakeitimą, užuot įspėjęs, kad jo negalima anuliuoti.
Pradinės užklausos
prompts/list pateikia dvylika pakartotinai naudojamų darbo eigų:
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
Naudokite prompts/get su pateiktu užklausos pavadinimu ir deklaruotais argumentais, kad gautumėte paruoštą vykdyti naudotojo pranešimą.
Ištekliai
resources/list pateikia viešas, podėlyje saugomas nuorodas:
| URI | Turinys |
|---|---|
thunderphone://docs/llms.txt | Viešosios dokumentacijos rodyklė. |
thunderphone://docs/quickstart | Greitosios pradžios Markdown failas. |
thunderphone://pricing | Dabartinių viešųjų kainų Markdown failas. |
thunderphone://guides/prompt-style | Balso agento raginimų stiliaus vadovas, pagal kurį tikrina review_prompt. Jame pateiktus gairių identifikatorius (P1, W2 ir pan.) nurodo aptiktos problemos. |
thunderphone://guides/working-with-thunderphone | Kaip asistentas turėtų dirbti su šiais įrankiais: nedideliais etapais rengti juodraštį, tikrinti prieš kiekvieną diegimą, gauti naudotojo sutikimą dėl visko, kas bus vykdoma tiesiogiai ar apmokestinama, ir niekada neprašyti slaptų duomenų. |
Vieną iš jų perskaitykite naudodami resources/read. Viešoms užklausoms naudojamas trumpas laiko limitas, 2 MiB riba ir dešimties minučių proceso podėlis.
Protokolas ir klaidos
Serveris palaiko protokolo versijas 2025-06-18 ir 2025-03-26; jis atkartoja palaikomą kliento versiją, o kitu atveju pasirenka 2025-06-18. Jis įgyvendina initialize, ping, įrankius, užklausas, išteklius ir pranešimus. Pranešimai grąžina 202 Accepted. Šis būsenos nesaugantis serveris nepateikia SSE klausytojo ar seanso ištrynimo, todėl GET ir DELETE grąžina 405 Method Not Allowed su Allow: POST.
Įrankių nesėkmės vis tiek pateikiamos kaip sėkmingi JSON-RPC atsakymai su isError: true. Jų tekste yra trumpas sakinys, po kurio pateikiamas JSON blokas:
{
"code": "insufficient_balance",
"detail": "There is not enough prepaid balance.",
"next_step": "Call get_billing_summary, add funds in Organization > Billing, then retry."
}Atskiras outbound_tcpa_confirmation_required: priešdėlis išlaikomas place_call. Nežinomi JSON-RPC metodai grąžina -32601 HTTP 200 atsakyme. JSON-RPC paketai nepalaikomi MCP 2025-06-18 ir grąžina aiškią -32600 netinkamos užklausos klaidą.