ThunderPhone v3 је сада доступан.Почните самостално, већ од 2 ¢/мин.Прочитајте објаву

Connect tools & data

Користите ThunderPhone као MCP сервер

Правите, тестирате, проверавате и користите ThunderPhone гласовне агенте из Claude, ChatGPT, Claude Code, Codex, Cursor, VS Code или другог Streamable HTTP MCP клијента.

ThunderPhone пружа сервер протокола контекста модела са стриминг HTTP-ом на адреси:

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

Ово је супротан смер од повезивања удаљеног MCP сервера са гласовним агентом:

СмерРезултат
Удаљени MCP сервер → ThunderPhone агентГласовни агент може да позове алате удаљеног сервера.
ThunderPhone → ваш MCP клијентВаш агент за кодирање може да израђује, тестира и управља ThunderPhone-ом.

Потврдите идентитет

Подразумевано користите OAuth за клијенте директоријума: пријавите се, изаберите организацију и одобрите затражене дозволе. Прекините везу у оквиру Подешавања → Безбедност → Апликације које сте повезали. Промена или ресетовање лозинке, као и промена е-адресе налога, такође опозива везу, па након тога поново повежите клијент.

За клијенте конфигурисане помоћу API кључа, креирајте кључ sk_live_ у оквиру Интеграције → API кључеви и изложите га MCP клијенту као THUNDERPHONE_API_KEY. Кључ је повезан са једном организацијом; id у власништву друге организације понаша се као да није пронађен.

Организације које обрађују PHI

Ако позиви ваше организације могу да садрже заштићене здравствене информације (PHI), зато што имате BAA са ThunderPhone или су ваши агенти означени као они који обрађују PHI, горенаведени URL никада не враћа садржај позива: транскрипте, снимке, оцене, листе позива, извозе, исходе кампања, аналитику позива и увиде, разговоре направљене на основу стварних позива и резултате поновљене репродукције. Ти алати враћају грешку са code: "phi_content_unavailable". Прављење, тестирање и конфигурисање агената ради као и обично.

Тај URL је наведен у јавним директоријумима помоћника, који не смеју да садрже PHI. Ако ваша организација има сопствени BAA са добављачем помоћника који покрива радни простор који користите:

  1. Администратор организације отвара Организација → Опште → Приступ AI помоћнику у ThunderPhone и потврђује ту покривеност.
  2. Уместо тога, повежите помоћника као прилагођени конектор са овим URL-ом:
https://api.thunderphone.com/v1/mcp/baa

Садржај позива је тада доступан тамо, укључујући позиве који могу да садрже PHI. Повлачење потврде зауставља то при следећем захтеву помоћника. Позив који је ваша организација обрадила као онај који не садржи PHI доступан је на оба URL-а.

CLI и stdio алтернативе

ThunderPhone CLI може да упише конфигурацију клијента уз очување неповезаних сервера:

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

Након глобалне инсталације @thunderphone/mcp, користите thunderphone-mcp setup са истим опцијама. Подешавање подржава Claude Code, Codex, Cursor, VS Code, Gemini, Claude Desktop и Windsurf. Директан HTTP има предност; Desktop користи stdio.

За сваки клијент који подржава stdio, подесите command: "npx" са args: ["-y", "@thunderphone/mcp"]. Омотач прво користи THUNDERPHONE_API_KEY, затим акредитиве из thunderphone login, освежавајући истекле токене, а потом OAuth преко mcp-remote. Пријава уређајем и OAuth захтевају одговарајуће увођење API OAuth-а. Путања са API кључем то не захтева. Конфигурације за директни HTTP не читају складиште акредитива CLI-ја; користите stdio омотач да поново искористите пријаву уређајем.

Ово су алтернативе ручним конфигурацијама клијента у наставку.

Конфигурација клијента

Claude и ChatGPT се пријављују помоћу OAuth-а; API кључ није потребан. Ако још немате ThunderPhone налог, на страници за пријаву изаберите Направите налог, а након потврде имејл адресе вратићете се на екран за одобравање.

Claude (веб, рачунар и мобилни уређаји)

  1. Отворите Прилагођавање → Конектори (Подешавања → Конектори у старијим верзијама). Ако се ThunderPhone појављује у директоријуму конектора, изаберите га. У супротном, изаберите Додај прилагођени конектор, назовите га ThunderPhone и унесите https://api.thunderphone.com/v1/mcp.
  2. Изаберите Повежи, пријавите се на ThunderPhone, изаберите организацију и одобрите дозволе.
  3. У ћаскању омогућите ThunderPhone из менија алатки и затражите оно што Вам је потребно, на пример „Прикажи моје агенте“.

Claude тражи потврду пре прве употребе сваке алатке. Да бисте прескочили већину тих упита, отворите Прилагођавање → Конектори → ThunderPhone и подесите Алатке само за читање на увек дозволи. Те алатке само траже податке: агенте, позиве, транскрипте, стања, документацију. Оставите Алатке за писање/брисање на одобравању ако желите да видите сваку промену пре него што се изврши.

Прилагођени конектори захтевају плаћени Claude план. На Team и Enterprise плановима власник најпре додаје конектор у подешавањима конектора организације, а затим сваки члан повезује свој ThunderPhone налог.

Шта је другачије у Claude-у

Claude (конектор и додатак Claude Code) има ужи скуп алатки, у складу са политиком директоријума Claude конектора:

  • Сваки позив и порука потврђују се појединачно. place_call и send_sms најпре враћају преглед (агента, бројеве са којих се позива и на које се позива, а за поруку и њен садржај) уз confirmation_token; ништа се не позива нити шаље док Claude не понови захтев са токеном након Ваше потврде.
  • Нема управљања кампањама. create_campaign, add_campaign_contacts и campaign_action нису доступни; креирајте, учитајте и покрените кампање на контролној табли. list_campaigns, get_campaign_stats и check_campaign и даље раде.
  • Нема test_integration. Тестирајте захтев интеграције са њене странице на контролној табли.
  • preview_voice репродукује фиксни пример поздрава гласом и на језику које изаберете; не изговара прилагођени текст.
  • list_voices и list_agents враћају сажетак; get_agent садржи потпуну конфигурацију агента.

AI обавештење

Сваки позив који ThunderPhone агент упути или на који одговори почиње говорним AI обавештењем. Подразумевано гласи: „Овај позив је са AI асистентом и биће снимљен и транскрибован.“ Искључивање (consent_announcement_enabled на false или ai_live_processing_disclosure_override на off) се одбија осим ако администратор организације претходно није забележио потписану потврду на контролној табли, из било ког клијента, укључујући Claude.

ChatGPT

  1. Ако се ThunderPhone појављује у директоријуму ChatGPT апликација, изаберите га и повежите.
  2. У супротном, отворите Подешавања → Апликације и конектори → Напредна подешавања, укључите Режим за програмере и направите конектор са URL-ом https://api.thunderphone.com/v1/mcp и OAuth аутентификацијом.
  3. Пријавите се на ThunderPhone, изаберите организацију и одобрите дозволе. Додајте ThunderPhone у ћаскање из менија алатки.

Брисање агента или броја телефона, одбацивање нацрта, покретање кампање и слање тест захтева који може да пише у спољни систем захтевају другу потврду у било којој апликацији; погледајте Потврђивање деструктивних радњи.

Claude Code

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

Codex

Додајте ово у ~/.codex/config.toml:

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

Cursor

Направите .cursor/mcp.json:

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

Claude Desktop

Додајте mcp-remote мост у конфигурацију 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

Направите .vscode/mcp.json и унесите кључ путем 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}"
      }
    }
  }
}

Алатке

Свака алатка садржи MCP напомене. У табелама R значи само за читање, D деструктивно, I идемпотентно, а O интеракцију са отвореним светом/мрежом. Цртица значи да напомена није постављена.

Веза

АлаткаГлавни аргументиНапоменеШта ради
get_connection_identity—R, IПроверава акредитив и враћа његову организацију и безбедне метаподатке акредитива.

Агенти

АлаткаГлавни аргументиНапоменеШта ради
list_agents—R, IПриказује агенте.
get_agentagent_idR, IПреузима једног агента.
create_agentконфигурација агента—Креира агента. Прихвата иста подешавања као update_agent, укључујући steps, handoffs, intro_clip и intro_ring_count.
update_agentagent_id, измењена поља, опционално prompt_edits, expected_prompt_sha256DПрипрема поља у нацрту агента и замењује оно што је нацрт претходно садржао. Покреће се без корака потврде: објављени агент остаје непромењен до deploy_agent, а discard_agent_draft враћа нацрт на претходно стање. Можете подесити и max_hold_seconds, system_tool_settings и words. Да бисте изменили део упита, пошаљите prompt_edits (погледајте Уређивање упита на месту).
deploy_agentagent_id, опционално if_updated_atD, IОбјављује нацрт у продукцији.
discard_agent_draftagent_id, опционално if_updated_at, confirmation_token у другом захтевуD, IОдбацује припремљене измене. У два корака, погледајте Потврђивање деструктивних радњи.
duplicate_agentagent_id, опционално name—Копира агента унутар организације.
delete_agentagent_id, confirmation_token у другом захтевуD, IТрајно брише агента. У два корака.
list_agent_versionsagent_idR, IПриказује објављене верзије конфигурације.
list_prompt_revisionsagent_id, опционално source, limit, offsetR, IПриказује сваку измену текста упита агента, укључујући нацрте, са разликом у односу на ревизију коју је заменила. Доступно када је комплет алата за итерације агента доступан вашој вези (погледајте у наставку).
review_promptagent_id, опционално prompt, previous_prompt, quote_id, max_cost_cents—Проверава нацрт упита (или текст који пошаљете) у односу на водич за стил упита. Сваки налаз наводи одломак, именује смерницу и нуди измену „пронађи и замени“; резултат такође наводи понашања која упит захтева, са стабилним идентификаторима, да ли је потребно рефакторисање и, за сопствени упит агента, да ли је потребно освежити његове тестне разговоре. Не мења ништа на агенту; инвентар се чува уз ревизију његовог упита. Плаћа се, па није означено као само за читање: прво затражите понуду помоћу dry_run, а затим га поново покрените без dry_run, са враћеним quote_id и max_cost_cents. Ова плаћена покретања сада се рачунају у исти лимит комплета алата организације као и друга покретања комплета алата. Доступно када је комплет алата за итерације агента доступан вашој вези (погледајте у наставку).
refactor_promptagent_id, опционално prompt, inventory, instructions, quote_id, max_cost_cents—Преписује упит у облик из водича за стил и мапира свако понашање као задржано, спојено, преформулисано или одбачено. Враћа нови текст и разлику, а подразумевано га поново чита да пријави behavior_changes (додато, уклоњено или измењено) и behavior_preserved; примените га помоћу update_agent. Плаћа се: затражите понуду помоћу dry_run, а затим га једном покрените са враћеним quote_id и max_cost_cents. Доступно када је комплет алата за итерације агента доступан вашој вези (погледајте у наставку).
list_reusable_instructions—R, IПриказује поновно употребљиве инструкције: дељена правила упита повезана са више агената преко reusable_instruction_ids алатке update_agent.
create_reusable_instructionname, content—Креира неповезану поновно употребљиву инструкцију. Само за администраторе.

Бројеви телефона и оператери

АлаткаГлавни аргументиОзнакеШта ради
list_phone_numbers—R, IНаводи бројеве организације и њихово рутирање.
get_phone_number_limits—R, IПриказује коришћење и ограничења управљаних бројева.
provision_phone_numberопциони area_code, city, state, idempotency_keyD, OКупује долазни број којим управља ThunderPhone.
list_voip_connections—R, IНаводи повезане оператере корисника.
search_voip_numbersconnection_id, country, type, опциони area_codeR, I, OПретражује инвентар бројева оператера.
import_voip_numbersconnection_id, numbersD, OУвози бројеве који су већ у власништву код оператера.
update_phone_numberphone_number_id, поља за рутирање/ознаку/веб-кукуDАжурира рутирање броја, укључујући доделу агенту.
delete_phone_numberphone_number_id, confirm, опциони release_at_provider, confirmation_token у другом захтевуD, I, OОслобађа број. У два корака.
get_voip_setup_sessionопциони session_idR, IЧита вођено подешавање оператера (статус, контролну листу, питање на које чека одговор) или наводи отворена подешавања. Подешавање се покреће на контролној табли јер је потребна лозинка оператера. Само за администраторе.
answer_voip_setup_questionsession_id, question_id, answerOПрослеђује одговор корисника подешавању. На лозинке, сагласност за пробни позив, адресу сервера, корисничко име и дозволу да се ThunderPhone пријави на налог код добављача одговара се само у чаробњаку за подешавање; за њих враћа везу до чаробњака и не шаље ништа.
save_voip_setupsession_id, опциони name, confirmation_token у другом захтевуD, I, OЧува повезану радну верзију везе да би могла да се користи. У два корака.
check_phone_numberphone_number или phone_number_idR, I, OДијагностикује један од сопствених бројева организације на основу доказа: рутирања, везе, верификације, недавних позива оператера и пробних позива, као и одредишта на које га оператер шаље.

SMS

АлаткаГлавни аргументиНапоменеШта ради
send_smsfrom_number, to, body, idempotency_keyD, I, OШаље једну SMS поруку у обичном тексту преко повезаног Twilio или Telnyx броја.

Позиви

АлаткаГлавни аргументиНапоменеШта ради
list_callsопциони филтери, limit, offsetR, IПриказује позиве помоћу REST филтера историје позива, укључујући exclude_test_calls.
get_callcall_idR, IПреузима статус и метаподатке позива.
get_call_transcriptcall_id, опциони liveR, IПреузима транскрипт позива.
get_call_audio_urlcall_id, опциони downloadR, I, OВраћа потписани URL за аудио; никада не стримује аудио преко MCP-а.
get_call_gradecall_idR, IПреузима најновију оцену позива.
place_callagent_id, from_number, to_numberD, OУпућује један неидемпотентан одлазни позив.
export_callsфилтери позива, export_formatR, IИзвози до ограничења REST крајње тачке као JSON или CSV.
get_call_analyticsопциони since_days, agent_idR, IОбједињује стварне позиве према статусу, смеру, исходу, оцени и проблему, при чему се тестни позиви броје засебно.
get_call_insightscall_ids (до 10)R, IПреузима оцену, исход, сажетак и откривене проблеме за више позива одједном.

Тестирање и валидација

АлатГлавни аргументиНапоменеШта ради
list_test_scenariosagent_idR, IНаводи сценарије за тестирање.
create_test_scenarioagent_id, title, scenario_prompt, опциони услови—Креира сценарио.
generate_test_scenariosagent_id, опциони count, include_edge_cases, localeOГенерише сценарије из упита агента.
run_agent_testsagent_id, channel, consent_to_charge, опциони избор/матрицаD, OИзвршава сценарије путем веба или телефоније.
get_test_runagent_id, batch_idR, IПреузима статус групе и резултате по сценарију.
test_my_agentagent_id, consent_to_charge, опциони scenario_ids, count, wait_secondsD, OТестира агента у једном позиву: покреће његове сачуване сценарије (генерише неке ако их нема) и чека до једног минута на оцене или враћа batch_id за get_test_run. Наплаћује се као run_agent_tests.
test_in_textagent_id, callers (од 1 до 3 описа), опциони version, directionOБесплатан текстуални тест: симулирани позиваоци разговарају са радном верзијом агента (или активном верзијом) текстом кроз стварни процес, а транскрипти стижу за око један минут. Резултати алата су симулирани.
run_simulationagent_id, consent_to_charge, опциони scenario_prompt, direction, languageD, OПокреће један симулирани телефонски позив између AI позиваоца и радне верзије агента, тако да особа може да преслуша измену. Враћа покретање са статусом in_progress. Снима се када агент снима позиве и оцењује након завршетка. Наплаћује се као пробни позив, прво из бесплатног буџета за тестирање.
get_simulationsimulation_idR, IПреузима статус симулираног позива и, када се заврши, оно што је произвео: URL снимка кратког трајања и транскрипт када агент снима позиве, као и оцену када се оцењивање заврши (null пре тога).
list_validation_runsagent_idR, IНаводи недавна покретања валидације радне верзије.
get_validation_statusagent_idR, IПреузима најновије стање валидације и подударање радне верзије.
list_conversationsagent_id, опциони split, sourceR, IНаводи разговоре на којима се агент тестира. Захтева комплет алата за итерације агента.
get_conversationconversation_idR, IПреузима један пробни разговор са његовим тренутним разменама. Захтева комплет алата за итерације агента.
get_conversation_revisionsconversation_id, опциони limit, offsetR, IНаводи сваку ревизију пробног разговора: како и зашто је измењен (освежен због измене упита, враћен из раније ревизије), додата, уклоњена и измењена понашања, премештене или повучене примере и разлику реда. Захтева комплет алата за итерације агента.
generate_conversationsagent_id, опциони count, styleOПише симулиране пробне разговоре са радном верзијом агента и њихове најтеже тренутке претвара у примере за валидацију са кључевима одговора. Прво затражите понуду помоћу dry_run; за стварно покретање потребни су његов quote_id и max_cost_cents. Захтева комплет алата за итерације агента.
import_conversationsagent_id, опциони since_days, max_callsOПретвара недавне позиве агента у пробне разговоре (највише два по позиваоцу, позиви без снимања се прескачу) и њихове најтеже тренутке у примере. Прво затражите понуду помоћу dry_run; за стварно покретање потребни су његов quote_id и max_cost_cents. Захтева комплет алата за итерације агента.
refresh_conversationsagent_id, опциони conversation_ids, from_prompt_revision_idOУсклађује пробне разговоре агента са његовим тренутним упитом након додавања, уклањања или измене понашања: поново их усмерава, враћа ранију ревизију (укључујући стварни звук) или преписује застареле размене и повлачи примере чија је размена позиваоца нестала. Прво затражите понуду помоћу dry_run; за стварно покретање потребни су његов quote_id и max_cost_cents. Захтева комплет алата за итерације агента.
get_conversation_jobjob_idR, IПреузима посао генерисања, увоза или освежавања: статус, досадашњи трошак у односу на ограничење и оно што је написао или освежио. Захтева комплет алата за итерације агента.
run_replaysagent_id, опциони overrides, split, engine, sample_size, sample_seed, max_cost_cents, quote_id, dry_runD, OПоново репродукује узорак примера агента са његовом радном верзијом или са заменама као што су кандидатски упит, глас или ниво и оцењује сваки одговор према кључу одговора примера. Тачне репродукције покрећу снимљени звук размене као што би то учинио активни позив; стопе пролазности пријављују се по механизму. Репродукције PHI позива извршавају се као PHI, а конфигурација коју не могу да покрену (глас ElevenLabs-а, експериментални производ) се одбија. dry_run враћа процену, изабрани sample_seed и quote_id; стварно покретање шаље исти захтев са тим quote_id и sample_seed, као и max_cost_cents, строгим ограничењем: сваки захтев резервише своју горњу границу пре слања, а покретање се зауставља уместо да пошаље захтев који не одговара, зато оставите процењени largest_reservation_cents слободног простора по раднику. Тачна репродукција резервише свој најгори случај, око 85 центи до $1.25 по репродукцији у току за типичну размену (две се извршавају истовремено), у односу на стварни трошак од неколико центи; покретање се наплаћује према стварном трошку репродукција, зато поставите max_cost_cents са резервом. Тачна репродукција се извршава у оквиру буџета одређеног за нормалну размену плус једно поновно покретање какво се дешава у продукцији (трка за одговором поново и поновни покушај надзорника); размена којој је потребно више бележи се као грешка replay_budget_exhausted, засебно се броји као budget_exhausted, не улази у стопу пролазности и, у тест скупу, не троши ниједну кохорту. У тест скупу, кохорта са снимљеним звуком позиваоца под конфигурацијом која није Bolt v2 се одбија (test_needs_exact_replay) и остаје неискоришћена: ту конфигурацију мерите у развојном скупу. Захтева комплет алата за итерације агента.
compare_configsagent_id, configs (од 2 до 4, прва је основна), опциони sample_size, sample_seed, max_cost_cents, quote_id, dry_runOПоново репродукује исте примере под сваком конфигурацијом и пријављује стопу пролазности, примере исправљене и покварене у односу на основну конфигурацију, кашњење до првог звука, колико често је позивалац чекао на потврду, сигнале или тишину и трошак по размени, по механизму. Затражите понуду помоћу dry_run као за run_replays. Само развојни скуп: у тест скупу се одбија (comparison_dev_only); упоредите у развојном скупу, а затим измерите избор помоћу run_replays. Захтева комплет алата за итерације агента.
get_replay_runrun_id, опциони include_traceR, IПреузима укупне резултате покретања репродукције, промене и резултате по примеру, као и његову групу за поређење. Тачне репродукције којима је требало више од буџета броје се засебно (budget_exhausted), ван стопе пролазности. Захтева комплет алата за итерације агента.
create_talk_linkagent_id, опциони variant_id, language, expires_in_minutesOКреира везу за једнократну употребу коју особа отвара у прегледачу да би разговарала са тренутном радном верзијом агента, као помоћу дугмета „Разговор“ на контролној табли. Веза подразумевано истиче после 30 минута (највише 120); разговор се наплаћује као пробни позив за разговор. Погледајте Везе за разговор.

Алати означени као они којима је потребан комплет алата за итерацију агента његов су део; комплет алата се омогућава по организацији док је у бета верзији, а без њега враћају feature_not_enabled са упутствима за следеће кораке. Сваки разговор агента налази се у његовом развојном или тест скупу. Тест скуп служи за мерење измене, а не за њено подешавање, па алати за разговоре враћају разговор из тест скупа само са његовим идентификатором, скупом, извором, статусом и бројачима. Покретање репродукције на тест скупу репродукује једну целу тест кохорту (sample_size и sample_seed се занемарују), сваки пример на механизму који његови подаци дозвољавају, одређеном пре покретања на основу примера (тачно за снимљени звук позиваоца, текстуално за пример само са текстом; конфигурација различита од Bolt v2 нема тачну путању, па се кохорта са снимљеним звуком за њу одбија са test_needs_exact_replay и остаје неискоришћена; engine се изоставља или поставља на auto, јер се exact или text одбијају са test_engine_per_example, а ништа не прелази на текст), и враћа само укупне вредности по механизму: стопу пролазности, неуспехе по озбиљности и врсти, кашњење и трошак. Његов први резултат који сачува репродукцију троши кохорту, па следеће тест покретање, за било који промпт, узима другу, а ако ниједна не преостане одбија се са no_test_cohort (увоз позива или генерисање разговора попуњава нове кохорте); покретање које се заврши пре чувања репродукције (Core не може тачно да репродукује његове аудио-примере, exact_replay_unavailable, капацитет за репродукцију је и даље заузет, core_busy, или је сваком кораку истекао буџет, replay_budget_exhausted) оставља кохорту неискоришћеном. У развојном скупу, тачна репродукција коју Core не може да изврши прелази на текст и покретање се означава као degraded. Поређења се извршавају само у развојном скупу. Сваки алат који се плаћа прихвата quote_id из свог пробног покретања, који важи за једно покретање: трајно се потроши једном, када покретање започне, а покретање које је одбијено или не успе пре тога оставља га употребљивим; покретање које не успе након тога то наводи и понавља се новим пробним покретањем за нови quote_id. Са OAuth-ом, review_prompt и refactor_prompt захтевају опсег agents:write, укључујући пробна покретања, а алати за разговоре и репродукције захтевају testing:write за покретање. Корисници виде цео тест скуп на контролној табли. Позив чији је позивалац у тест скупу агента издваја се, јер је део тест скупа података. У организацији са комплетом алата, list_calls, get_call, get_call_transcript, get_call_audio_url, get_call_grade и export_calls враћају га тачно као {"call_id", "start_time", "held_out": true} (started_at уместо start_time у редовима извоза), без транскрипта, снимка, историје, оцене или извештаја; свако друго поље позива изостаје, па издвојени ред најпре препознајте по његовом held_out. REST API чини исто за API кључеве и OAuth токене, а његови прикази преко више позива (сажети извештаји, кластери проблема, истраге, извештаји о цевоводу) изостављају издвојене позиве из бројања, кластера и узорака и задржавају сваки текст који је модел из њих написао. Упис у издвојени позив (оцењивање, промовисање у тест сценарио, поновно генерисање корака) одбија се са held_out_call. Тест сценарио који је неко промовисао из издвојеног позива враћа се из list_test_scenarios и у тест покретањима тачно као {"id", "held_out": true}, а покретање симулације из њега, из get_test_run и алата за симулацију, тачно као {"id", "scenario_id", "held_out": true}; и његови симулирани позиви су издвојени, а тест покретања га и даље извршавају. Развојни разговор, пример или резултат репродукције копиран из позива издвојеног позиваоца (скупови су по агенту, па тај позивалац може бити у тест скупу другог агента) чита се као онај из тест скупа. Корисници виде издвојене позиве у целости на контролној табли, а администратор може дозволити једном API кључу да их види у целости (include_held_out_calls, подразумевано искључено, подешава се само на контролној табли), за интеграцију којој је потребан сваки позив; MCP то никада не користи. Веб-хукови су непромењени. Организације без комплета алата не виде поље held_out нити било какву промену.

generate_conversations, import_conversations и refresh_conversations троше кредите модела. Прво их позовите са dry_run: true: одговор је понуда трошкова, корак по корак, са quote_id, и ништа се не покреће. Понуда обухвата сваки захтев који покретање може да упути при уобичајеној величини. За стварно покретање потребни су тај quote_id (истиче после 15 минута и ради само са истим аргументима) и max_cost_cents, чврсти лимит: пре сваког захтева посао резервише највиши износ који тај захтев може да кошта и зауставља се уместо да пошаље онај који не стаје у лимит, задржавајући оно што је написао. Због те резервације, покретање може да се заустави са делом лимита непотрошеним; largest_reservation_cents из понуде говори колико резерве треба оставити. Симулирани позиваоци се осмишљавају на основу промпта агента; style: "adversarial" генерише захтевне позиваоце који притискају слабе тачке промпта, а ти разговори увек иду у развојни скуп. target: "changed_behaviors" усмерава позиваоце на оно што је промењено у последњој измени промпта. Сваки агент истовремено покреће један од ових послова или једно поновно извођење, тако да освежавање никада не мења примере на којима се изводи поновно извођење; покретање док је друго активно враћа job_active, replay_run_active или conversation_job_active са информацијом шта треба сачекати.

После измене промпта која додаје, уклања или мења понашање, review_prompt на нацрту агента пријављује колико је тестних разговора написано за промпт са другим понашањима (conversations.refresh_suggested). refresh_conversations их затим усклађује са нацртом, тако да развојни и тестни скупови мере нови промпт на историјама које је могао да произведе. Освежавање никада ништа не губи: сваки разговор задржава сваку ранију ревизију, а када се уклоњено правило врати, враћа се ревизија из времена када је постојало, са стварним звуком позиваоца. Освежавање које покрене програмерски агент изоставља разговоре из тестног скупа и разговоре копиране из изузетих позива из избора, понуде, напретка и трошка; навођење једног у conversation_ids враћа 403 test_conversation. Особа их освежава са контролне табле, а програмерским агентима резултати тог посла приказују их само као идентификаторе и бројеве. active пример чију историју, одговор или кључ одговора освежавање препише враћа се у pending_review, са ознаком refreshed_needs_review. Понуда за освежавање обрачунава цену сваког разговора који чита као да ће бити преписан, сваког позива моделу на његовом излазном лимиту, и важи за промпт и разговоре за које је дата понуда: када се било шта од тога промени пре покретања, поново затражите понуду; када се промпт промени током покретања, посао се зауставља као failed, задржавајући оно што је освежио.

База знања

АлаткаГлавни аргументиНапоменеШта ради
list_knowledge_bases—R, IПриказује базе знања.
create_knowledge_basename, опционо description—Креира базу знања.
add_knowledge_documentknowledge_base_id, name, content—Додаје текст или Markdown.
import_knowledge_urlurl, опционо nameOСтавља јавну страницу у ред за безбедно уношење.
search_knowledgeknowledge_base_id, queryR, IПретражује продукциони систем за преузимање знања.

Интеграције, веб-куке и удаљени MCP сервери

АлаткаГлавни аргументиНапоменеШта ради
list_integrations—R, IПриказује интеграције HTTP функција.
create_integrationdisplay_name, спецификација функције spec, опциона поља крајње тачке—Креира HTTP алатку. Додајте заглавља за аутентификацију на контролној табли.
test_integrationurl, опциони метод/тело/временско ограничење, integration_id са header_names, confirmation_token при другом захтевуD, OШаље ограничен тестни захтев заштићен од SSRF-а. Сачуване вредности заглавља попуњавају се из интеграције и шаљу само њеном сопственом хосту. POST (подразумевано), PUT, PATCH и DELETE су поступци у два корака; GET се извршава одмах.
list_webhook_endpoints—R, IПриказује потписане крајње тачке вебхука.
list_webhook_deliveriesопциони agent_id, опциони endpoint_idR, IПриказује недавне исходе испоруке вебхука без садржаја захтева.
create_webhook_endpointlabel, url, опциони догађаји/статусOКреира потписану крајњу тачку вебхука.
copy_webhook_endpointendpoint_id, target_agent_idIКопира вебхук агента, укључујући тајну за потписивање, на другог агента на серверу. Само за администраторе.
test_webhook_endpointendpoint_idOШаље синтетички догађај путем уобичајене испоруке.
list_mcp_servers—R, IПриказује удаљене сервере које могу да позивају гласовни агенти.
create_mcp_serverdisplay_name, urlOРегиструје и синхронизује удаљени сервер. Сервери којима су потребна заглавља за аутентификацију додају се на контролној табли.
sync_mcp_server_toolsserver_idD, OОсвежава каталог алатки удаљеног сервера.

Кампање

АлатГлавни аргументиНапоменеШта ради
list_campaigns—R, IПриказује одлазне кампање.
create_campaignпоља кампање—Креира кампању у нацрту.
add_campaign_contactscampaign_id, contacts—Додаје до 5.000 JSON контаката.
campaign_actioncampaign_id, action, опционо consent_to_charge, confirmation_token при другом захтевуD, OПокреће start, pause, resume или stop. start и resume имају два корака; pause и stop се извршавају одмах.
get_campaign_statscampaign_idR, IПреузима бројаче и недавне исходе.
check_campaignопционо campaign_id, contact_phone_number, contact_statusR, IОбјашњава зашто кампања не позива: њен прозор за позивање у сопственој временској зони, контакте који су тренутно на реду и шта зауставља бирање броја.

Подешавања организације и блокирани позиваоци

АлатГлавни аргументиОзнакеШта ради
get_org_settings—R, IЧита временску зону, радно време, пробне бројеве, ознаке исхода позива, називе статуса и који су аларми искључени, са updated_at.
update_org_settingsизмењена подешавања, if_updated_at, confirmation_token када се затражиD, IМења их (само администратори). Листе и објекти замењују сачувану вредност. Искључивање аларма или додавање пробног броја обавља се у два корака. Резултат садржи старе вредности за опозив.
get_account_limits—R, IПреузима ограничења платформе са вредностима специфичним за ову организацију.
list_blocked_callersопционални number, searchR, IПриказује блокиране бројеве позивалаца.
block_callersnumbers, опционални note, confirmation_token при другом захтевуD, IОдбија позиве са ових бројева пре него што се било који агент јави. У два корака, само за администраторе.
unblock_callersnumbers, confirmation_token при другом захтевуD, IУклања бројеве са листе блокираних. У два корака, само за администраторе.

get_org_settings, update_org_settings и get_account_limits захтевају org:read или org:write OAuth опсег; од везе успостављене пре њиховог увођења тражи се да га одобри при првој употреби.

Могућности, помоћ и увози

АлатГлавни аргументиОзнакеШта ради
get_supported_languages—R, IПриказује језике којима агенти говоре, са кодовима.
get_agent_capabilities—R, IНаводи шта агент може да уради током позива и која подешавања и интеграције постоје.
escalate_to_humansummaryOТражи помоћ од тима ThunderPhone. Они одговарају у ThunderPhone. За организације које могу да обрађују PHI, из ThunderPhone излази само неутрална напомена.
request_featuretitle, request, detailsOПодноси захтев за функцију тиму ThunderPhone. Највише три по организацији дневно.
start_agent_importplatformR, IВраћа везу до контролне табле на којој уносите свој Vapi, Retell, ElevenLabs или Bland кључ и бирате агенте. Ниједан алат не прима кључ.
get_agent_importопционални import_idR, IПриказује недавне увозе или статус једног увоза и мапиране агенте.
commit_agent_importimport_id, опционални item_idsOПрави агенте из спремног увоза, у позадини. Само администратори.

Гласови, наплата и документација

АлаткаГлавни аргументиОзнакеШта ради
list_voices—R, IПриказује гласове и подржане језике.
preview_voicevoice, language, textOГенерише узорак и враћа потписани URL.
list_voice_clones—R, IПриказује прилагођене копије гласова.
get_billing_summary—R, IПреузима стање и меродавне цене нивоа; не излаже измене плаћања.
search_docsquery, опциони limitR, I, OПретражује јавни индекс документације.
get_doc_pagepathR, I, OПреузима једну јавну страницу документације у Markdown формату.

Резултати о агенту, позиву, броју, кампањи или подешавању садрже web_url, одговарајућу страницу контролне табле, тако да је можете отворити у ThunderPhone или тамо наставити са Zeus.

Све алатке производа користе исте REST путање кода као јавни API. REST валидација, опсег организације, улоге, одобравање наплате, квоте, TCPA потврда, безбедност добављача и понашање ревизије се стога примењују без измена.

Уређивање упита на месту

update_agent може да измени део нацрта упита без поновног слања целог текста. prompt_edits је уређена листа парова за проналажење и замену, у истом формату који враћају review_prompt и 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."
    }
  ]
}

Сервер примењује измене редом на тренутни нацрт упита агента (објављени упит када нацрт не постоји) и уписује резултат у нацрт истим путем као и update_agent за цео упит. Сваки find мора да се појави тачно једном у упиту у стању у ком се налази када дође ред на ту измену. Ако се не појављује, ништа се не уписује, а грешка наводи измену:

КôдЗначењеШта да урадите
prompt_edit_not_foundТекст find није у тренутном нацрту упита. edit_index наводи која је измена у питању.Поново прочитајте агента и тачно копирајте одломак.
prompt_edit_ambiguousТекст find појављује се више пута. occurrences наводи колико пута.Укључите више околног текста.
stale_promptexpected_prompt_sha256 није SHA-256 тренутног нацрта упита: променио се након што сте га прочитали.Поново прочитајте агента, преправите измену према тренутном тексту и пошаљите његов SHA-256.
conflictДруги упис се догодио између читања нацрта на серверу и његовог уписивања.Покушајте поново; овај позив није изменио нацрт.

expected_prompt_sha256 није обавезан и такође штити упис целог упита. Користите prompt_sha256 из review_prompt или source_prompt_sha256 из refactor_prompt. Сваки позив који мења упит враћа prompt_sha256 за нови текст, previous_prompt_sha256 када је сервер прво прочитао нацрт и next_step који предлаже review_prompt са previous_prompt постављеним на текст пре измене. REST API прихвата само цео упит: PATCH /v1/agents/{agent_id} са prompt и if_updated_at.

Потврђивање деструктивних радњи

Алатке означене словом D мењају или уклањају нешто или започињу позивање стварних људи. За оне које се не могу опозвати потребна су два захтева. Први захтев ништа не мења и враћа:

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

Асистент приказује кориснику на шта ће то утицати и тражи потврдан одговор. Затим понавља захтев са истим аргументима и додатим confirmation_token. Токен важи 10 минута, може се употребити једном (чак и ако тај позив не успе) и важи за једну организацију, једну особу, један алат и један тачан скуп аргумената, тако да су за брисање три агента потребне три потврде. campaign_action са pause или stop прескаче овај корак како би активна кампања увек могла одмах да се заустави, као и test_integration са GET. Неки D алати извршавају се у једном захтеву јер D означава њихов ефекат, а не потврду на страни сервера: update_agent замењује оно што је било у нацрту (discard_agent_draft га враћа), deploy_agent замењује активну конфигурацију, update_phone_number преусмерава активне позиве, sync_mcp_server_tools замењује каталог алата удаљеног сервера, import_voip_numbers преусмерава бројеве на Вашег провајдера, run_agent_tests и run_simulation могу потрошити кредит, send_sms и place_call контактирају стварну особу (place_call задржава сопствену потврду пристанка), а provision_phone_number купује број. test_my_agent троши тестни кредит и захтева consent_to_charge. run_replays такође троши новац; његова dry_run процена и ограничење max_cost_cents замењују потврду. Ваш MCP клијент Вас и даље може затражити да их одобрите.

Неке промене које се могу поништити и даље чекају на потврду: block_callers, unblock_callers и save_voip_setup увек, update_org_settings када искључује упозорење или додаје тестни број, и update_agent када његови attention_reasons искључују једно од упозорења агента. Њихов next_step тражи од Вас да потврдите тачну промену, уместо да упозори да се она не може поништити.

Почетни упити

prompts/list приказује дванаест токова рада за вишекратну употребу:

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

Користите prompts/get са наведеним именом упита и његовим декларисаним аргументима да бисте добили корисничку поруку спремну за покретање.

Ресурси

resources/list излаже јавне, кеширане референце:

URIСадржај
thunderphone://docs/llms.txtЈавни индекс документације.
thunderphone://docs/quickstartQuickstart Markdown.
thunderphone://pricingТренутни јавни Markdown са ценама.
thunderphone://guides/prompt-styleВодич за стил упита гласовног агента према коме review_prompt врши проверу. Његови ИД-ови смерница (P1, W2 и тако даље) су они на које се налази позивају.
thunderphone://guides/working-with-thunderphoneКако асистент треба да ради са овим алатима: мале итерације на нацрту, провера пре сваког постављања, корисникова потврда за све што је активно или се наплаћује и никада тражење тајни.

Прочитајте ресурс помоћу resources/read. Јавна преузимања користе кратко временско ограничење, ограничење од 2 MiB и десетоминутни кеш у процесу.

Протокол и грешке

Сервер подржава верзије протокола 2025-06-18 и 2025-03-26; враћа подржану верзију клијента, а у супротном бира 2025-06-18. Имплементира initialize, ping, алате, упите, ресурсе и обавештења. Обавештења враћају 202 Accepted. Овај сервер без стања не излаже SSE слушач нити брисање сесије, па GET и DELETE враћају 405 Method Not Allowed са Allow: POST.

Неуспеси алата и даље остају успешни JSON-RPC одговори са isError: true. Њихов текст садржи кратку реченицу након које следи JSON блок:

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

Различити префикс outbound_tcpa_confirmation_required: задржан је за place_call. Непознате JSON-RPC методе враћају -32601 у HTTP 200 одговору. JSON-RPC пакети нису подржани у MCP 2025-06-18 и враћају исправну грешку неважећег захтева -32600.