Open in
使用 Claude Code、Codex 或 Cursor 進行開發
安裝 ThunderPhone Agent Skills、連接 ThunderPhone MCP 伺服器,並為編碼智能體提供最新產品文件。
ThunderPhone 為編碼智能體提供三個層次:
| 層級 | 為智能體提供的內容 |
|---|---|
| 智能體技能 | 針對智能體、提示詞、電話號碼、通話、工具、Webhook、知識庫、測試、透過閉環方式改善智能體、推廣活動、小工具、即時框架及遷移的專用程序。 |
| MCP | 已驗證工具涵蓋智能體、電話號碼、通話、測試、知識庫、工具/Webhook、推廣活動、語音、匯入及文件,並會隨功能陸續推出;呼叫 tools/list 取得即時目錄。 |
| 原始文件 | 提供產品行為及 API 詳情的最新 Markdown 原始檔。 |
Skills 說明如何完成工作。MCP 讓編碼智能體檢查並操作你的組織。原始文件則為已載入 Skill 以外的問題提供參考資料。
在專案中安裝
此區塊會安裝 Skills、讓目前 shell 可使用金鑰,並將專案範圍的 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 會在 .vscode/mcp.json 中的 servers 金鑰下使用相同伺服器:
{
"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選取的 通話,轉為測試對話 及將其中最困難的時刻轉為附有答案對照的範例。如部分匯入的對話未能建立範例,請以redo_failed: true執行import_conversations,在不匯入任何通話的情況下,再次為該等智能體對話建立範例。generate_conversations會為 新智能體撰寫對話,包括針對提示詞 弱點的困難來電者(該等對話一律會放入開發分組)。每段對話會置於 用作調校的開發分組,或只作一次量度的測試分組。來電者位於測試分組的 通話會被保留:無論透過 REST 或 MCP,對 API 金鑰或 OAuth 權杖而言,只會傳回其 ID、開始時間及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 範圍。當通話錄音被關閉或通話被刪除時,從該通話取得的測試對話和範例亦會一併移除。測試對話、重播及提示詞審核工具均屬於智能體迭代工具組的一部分,現正處於 beta 階段,並按組織啟用(所有組織均可使用 talk links);請聯絡 支援團隊 啟用。
使用 Python 或 TypeScript SDK 提交具類型的 REST 請求。
當建立工作需要可預測的負載、版本化測試資料、大量編排,或需要目前 MCP 工具清單未提供的操作時,請使用 REST 而非 MCP。API 起點為 https://api.thunderphone.com/v1;請參閱
API 簡介 及
MCP 指南。