Open in
Разработвайте с Claude Code, Codex или Cursor
Инсталирайте уменията на агента ThunderPhone, свържете MCP сървъра на ThunderPhone и предоставете на агент за програмиране актуална продуктова документация.
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създава такива за нов агент, включително трудни обаждащи се, насочени към слабите места на промпта (те винаги отиват в dev дяла). Всеки разговор е в dev дял за настройване или в тестов дял за еднократно измерване. Обаждане, чийто обаждащ се е в тестов дял, се изключва: за API ключ или OAuth токен, както чрез REST, така и чрез MCP, се връщат само неговият идентификатор, начален час иheld_out: true, записите в него се отказват (held_out_call), както и тестови сценарии, повишени от него; изключете го при настройване. - Установете базова линия с
run_replaysвърху dev дяла. С Bolt v2 ход с записано аудио се преиграва така, както би го изпълнило обаждане на живо. - Редактирайте черновата.
review_promptпроверява промпта спрямо ръководството за стил и предлага редакции за търсене и замяна;update_agentги прилага към черновата сprompt_edits; втора проверка сprevious_promptпроверява какво се е променило.refactor_promptпренаписва промпт, който е натрупал твърде много корекции, и отчита всяко поведение, което е променил. Когато редакция добавя или премахва поведение,refresh_conversationsактуализира тестовите разговори спрямо новия промпт, като възстановява по-ранни версии там, където правило се е върнало. - Проверете с
run_replaysспрямо базовата линия, като преглеждате неуспехите така, както би ги чул обаждащ се.compare_configsизпробва различно ниво на чуване, глас, определяне на край на реплика или ниво на интелигентност върху същите dev примери; сравненията са само за dev. - Измерете веднъж върху тестовия дял. Тестово изпълнение преиграва една цяла тестова
кохорта и първият му резултат я изразходва, така че всяко следващо тестово изпълнение, за който и да е
промпт, изисква нови тестови данни от импортирани обаждания или генерирани
разговори. Механизмът на всеки пример се задава преди изпълнението според неговите
данни (записаното аудио се преиграва точно, а примерите само с текст — като текст).
Общите резултати се предоставят по механизъм и нищо не се връща към текст: кохорта със
записано аудио при конфигурация, различна от Bolt v2, се отказва
(
test_needs_exact_replay) и остава неизползвана, затова измервайте тази конфигурация в dev. Агентите за програмиране получават само общи резултати, както и сравнение на разбираем език при dev изпълнения, така че да не могат да настройват върху тестовия дял. - Прослушайте запис от
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.