Open in
Правите помоћу Claude Code, Codex-а или Cursor-а
Инсталирајте ThunderPhone Agent Skills, повежите ThunderPhone MCP сервер и обезбедите агенту за програмирање актуелну документацију о производу.
ThunderPhone обезбеђује три слоја за агенте за писање кода:
| Слој | Шта пружа агенту |
|---|---|
| Вештине агента | Усмерени поступци за агенте, упите, бројеве, позиве, алате, веб-куке, знање, тестирање, унапређивање агента у затвореној петљи, кампање, виџете, оквире за рад у реалном времену и миграције. |
| MCP | Аутентификовани алати обухватају агенте, бројеве, позиве, тестирање, знање, алате/веб-куке, кампање, гласове, увозе и документацију како постају доступни; позовите tools/list за актуелни каталог. |
| Сирова документација | Актуелни Markdown извори за понашање производа и детаље API-ја. |
Вештине објашњавају како да обавите посао. MCP омогућава агенту за писање кода да прегледа и извршава радње у вашој организацији. Изворна документација пружа изворни материјал за питања која нису обухваћена учитаном вештином.
Инсталирајте у пројекат
Овај блок инсталира вештине, чини кључ доступним тренутној љусци и додаје MCP сервер у опсегу пројекта у Claude Code. Замените чувар места тако што ћете прочитати стварну вредност из свог менаџера тајни; не лепите кључ у репозиторијум или чет.
npx skills add thunderphone/skills
export THUNDERPHONE_API_KEY='replace-with-value-from-your-secret-manager'
claude mcp add --transport http --scope project \
--header 'Authorization: Bearer ${THUNDERPHONE_API_KEY}' \
thunderphone https://api.thunderphone.com/v1/mcpЗа Codex, замените последњу команду следећом:
codex mcp add thunderphone \
--url https://api.thunderphone.com/v1/mcp \
--bearer-token-env-var THUNDERPHONE_API_KEYCursor чита конфигурацију пројекта из .cursor/mcp.json:
{
"mcpServers": {
"thunderphone": {
"type": "http",
"url": "https://api.thunderphone.com/v1/mcp",
"headers": {
"Authorization": "Bearer ${env:THUNDERPHONE_API_KEY}"
}
}
}
}VS Code користи исти сервер под кључем servers у .vscode/mcp.json:
{
"servers": {
"thunderphone": {
"type": "http",
"url": "https://api.thunderphone.com/v1/mcp",
"headers": {
"Authorization": "Bearer ${env:THUNDERPHONE_API_KEY}"
}
}
}
}Пример сесије: двојезична зубарска рецепционерка
- Затражите од агента за програмирање да учита
create-agent,thunderphone-prompt-builder,build-tool-integration,add-knowledgeиtest-agent. Реците му да прво направи план и да још не креира ресурсе. - Дајте му проверене чињенице о ординацији, подржане задатке, правила за ескалацију и два обавезна локала. Нека провери активни каталог гласова и подржане језике уместо да измишља глас или локал.
- Затражите један продукциони промпт заснован на општим принципима и чињеницама. Агент треба да пређе на подржани језик позиваоца, говори сажето, поставља једно по једно питање и избегава скрипте са одговорима позиваоца.
- Нека дефинише уски алат за заказивање и приложи само знање које је рецепционерки потребно. Пре пуштања у рад тестирајте успешан рад алата, недоступност термина, неважећи унос, истек времена и преусмеравање на човека.
- Генеришите сценарије за оба језика, прекиде, исправке, недостајуће информације, питања о знању, неуспехе заказивања и ескалацију. Покрените их, прегледајте транскрипте и евиденцију алата, исправите најмање опште правило и поново покрените исти скуп.
- Прегледајте тачан нацрт и доказе из тестирања, а затим изричито одобрите примену и повезивање броја. Обавите контролисани аудио-позив на сваком језику пре преусмеравања стварног саобраћаја.
Унапређујте агента у затвореној петљи
Када агент почне да прима позиве, затражите од агента за кодирање да учита iterate-on-agent.
Вештина покреће исту петљу коју ThunderPhone користи за сопствене агенте, тако да се свака
измена мери пре постављања:
- Прочитајте гласовног агента, његове ревизије промпта и водич за стил промпта. Ревизије промпта су доступне преко REST-а и MCP-а, па агент за програмирање може директно да прегледа недавне измене промпта.
- Направите тест скупове.
import_conversationsпретвара недавне позиве или изабране позиве премаcall_idsу тест разговоре и њихове најтеже тренутке у примере са кључевима одговора. Ако креирање примера није успело за неке увезене разговоре, покренитеimport_conversationsсаredo_failed: trueда бисте поново направили примере за те разговоре гласовног агента без увоза позива.generate_conversationsпише разговоре за новог гласовног агента, укључујући тешке позиваоце усмерене на слабе тачке промпта (они увек иду у развојни скуп). Сваки разговор се налази у развојном скупу, за подешавање, или у тест скупу, за једнократно мерење. Позив чији је позивалац у тест скупу је издвојен: API кључу или OAuth токену, подједнако преко REST-а и MCP-а, враћају се само његов идентификатор, време почетка иheld_out: true, уписи у њега се одбијају (held_out_call), као и тест сценарији промовисани из њега; изоставите га при подешавању. - Успоставите почетно стање помоћу
run_replaysна развојном скупу. Са Bolt v2, обрт са снимљеним звуком се поново репродукује онако како би га извршио позив уживо. - Уредите нацрт.
review_promptпроверава промпт у односу на водич за стил и нуди измене за проналажење и замену;update_agentих примењује на нацрт помоћуprompt_edits; друга провера саprevious_promptпроверава шта се променило.refactor_promptпоново пише промпт који је сакупио превише закрпа и извештава о сваком понашању које је променио. Када измена додаје или уклања понашање,refresh_conversationsусклађује тест разговоре са новим промптом, враћајући раније верзије тамо где се правило вратило. - Проверите помоћу
run_replaysу односу на почетно стање, тумачећи неуспехе онако како би их позивалац чуо.compare_configsиспробава другачији ниво слушања, глас, одређивање краја говора или ниво интелигенције на истим развојним примерима; поређења су само за развој. - Измерите једном на тест скупу. Тест покретање поново репродукује целу тест
кохорту и његов први резултат је троши, па свако касније тест покретање, за било који
промпт, захтева свеже тест податке из увезених позива или генерисаних
разговора. Механизам сваког примера се пре покретања поставља на основу његових
података (снимљени звук се репродукује тачно, примери само са текстом као текст).
Збирови се приказују по механизму и ништа не прелази на текст: кохорта са
снимљеним звуком под конфигурацијом која није Bolt v2 се одбија
(
test_needs_exact_replay) и остаје неискоришћена, па ту конфигурацију мерите на развојном скупу. Агенти за програмирање добијају само збирове, уз поређење описано једноставним језиком за развојна покретања, па не могу да подешавају на тест скупу. - Преслушајте снимак
run_simulationили отворите везу за разговор и сами разговарајте са нацртом. - Поставите када то кажете.
За све што троши кредите прво се добија понуда: пошаљите dry_run: true за процену, а затим покрените са њеним quote_id и max_cost_cents, чврстом горњом границом. Понуда плаћа једно покретање: послови разговора, покретања репродукције и прегледи и рефакторисања промпта који позивају модел трајно је троше када започну. Плаћена покретања започета вашим API кључем, OAuth апликацијом или MCP-ом такође се рачунају у исти лимит комплета алата који је ваша организација омогућила,
а покретање које је одбијено или прво не успе оставља понуду употребљивом; након што је
искоришћена, поновите неуспешно покретање са новом сувом пробом. Сваки захтев
резервише највећи могући трошак пре слања, а покретању се наплаћује
стварни трошак, зато оставите резерву у процени. Прецизна репродукција резервише
око 85 центи до $1.25 по репродукцији у току за типичну размену
(нормална размена плус једно поновно покретање у продукцији), док стварни трошак износи неколико
центи: задајте покретањима репродукције горњу границу са довољно резерве. Размена која ипак остане без
буџета рачуна се засебно и не троши ниједну тестну кохорту. Агент
истовремено покреће само један посао разговора или покретање репродукције. Са OAuth-ом, алати за промпт захтевају
опсег agents:write. Када се снимак позива искључи
или се позив обрише, уклањају се и тестни разговори и примери преузети из њега. Алати за тестне разговоре,
репродукцију и преглед промпта део су комплета алата за итерацију
агента, који се омогућава по организацији док је у бета фази (линкови за разговор
су укључени за сваку организацију); затражите од
подршке да га укључи.
Користите Python или TypeScript SDK за REST захтеве са типовима.
Користите REST уместо MCP-а када је за израду потребно детерминистичко тело
захтева, верзионисани тестни подаци, масовна оркестрација или операција која не
постоји на тренутној листи MCP алата. API је доступан на https://api.thunderphone.com/v1; погледајте
увод у API и
MCP водич.