ThunderPhone v3 現已上線。自助開通,價格低至每分鐘 2¢。查看公告

Getting Started

使用 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_KEY

Cursor 會從 .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}"
      }
    }
  }
}

範例工作階段:雙語牙科診所接待員

  1. 要求編程智能體載入 create-agent、 thunderphone-prompt-builder、build-tool-integration、add-knowledge 及 test-agent。指示它先制定計劃,暫時不要建立資源。
  2. 向它提供已核實的診所資料、支援的任務、升級處理規則及兩種所需語言地區設定。要求它檢查即時語音目錄及支援語言,而非自行虛構語音或語言地區設定。
  3. 要求它根據通用原則及資料建立一個正式環境提示。智能體應切換至來電者支援的語言、保持簡潔語音、每次只問一條問題,並避免預設來電者回應的腳本。
  4. 要求它定義一個範圍明確的預約工具,並只附加接待員所需的知識。部署前測試工具成功、沒有可用時段、無效輸入、逾時及轉交真人處理。
  5. 為兩種語言、打斷、修正、資料缺失、知識問題、預約失敗及升級處理產生情境。執行測試、檢查逐字稿及工具證據、修正最小範圍的通用規則,然後重新執行同一組測試。
  6. 檢閱確切草稿及測試證據,然後明確授權部署及附加電話號碼。轉移真實流量前,以每種語言進行一次受控音訊通話。

以閉環方式改進智能體

智能體開始接聽來電後,請要求編程智能體載入 iterate-on-agent。 此技能執行 ThunderPhone 用於自身智能體的同一套循環,因此每項 變更均會在上線前完成量度:

  1. 閱讀智能體、其提示詞修訂版本及提示詞風格指南。提示詞修訂版本可透過 REST 及 MCP 取得,因此編程智能體可直接檢視最近的提示詞變更。
  2. 建立測試集。 import_conversations 會將最近的通話,或按 call_ids 選取的 通話,轉為測試對話 及將其中最困難的時刻轉為附有答案對照的範例。如部分匯入的對話未能建立範例,請以 redo_failed: true 執行 import_conversations,在不匯入任何通話的情況下,再次為該等智能體對話建立範例。generate_conversations 會為 新智能體撰寫對話,包括針對提示詞 弱點的困難來電者(該等對話一律會放入開發分組)。每段對話會置於 用作調校的開發分組,或只作一次量度的測試分組。來電者位於測試分組的 通話會被保留:無論透過 REST 或 MCP,對 API 金鑰或 OAuth 權杖而言,只會傳回其 ID、開始時間及 held_out: true,系統會拒絕對其進行寫入(held_out_call), 從中提升的測試情境亦同樣會被拒絕;調校時請不要使用。
  3. 使用開發分組上的 run_replays 建立基準。使用 Bolt v2 時, 附有已錄製音訊的對話回合會如同即時通話般 重播。
  4. 編輯草稿。 review_prompt 會依據風格 指南檢查提示詞,並提供尋找及取代編輯;update_agent 會透過 prompt_edits 將其套用至 草稿;第二次使用 previous_prompt 的審查會 檢查變更內容。refactor_prompt 會重寫累積了過多修補內容的提示詞, 並報告其改變的任何行為。當 編輯新增或移除某項行為時,refresh_conversations 會將測試 對話更新至新提示詞,並在規則恢復時還原較早版本。
  5. 使用 run_replays 對照基準進行驗證,並以 來電者會聽到的方式解讀失敗結果。compare_configs 會在相同的 開發範例上嘗試不同的聽覺級別、聲音、端點偵測或智能級別; 比較僅限開發分組。
  6. 在測試分組上只量度一次。測試執行會重播整個測試 組別,而其首次結果會消耗該組別,因此任何提示詞的每次後續測試執行, 都需要從匯入通話或生成的 對話取得新的測試資料。每個範例的引擎會在執行前按其 資料設定(已錄製音訊會精確重播,純文字範例則以文字方式執行)。 總計會按引擎提供,且不會回退至文字:在非 Bolt v2 配置下含有已錄製音訊的組別會被拒絕 (test_needs_exact_replay)並維持未使用狀態,因此請在開發分組上量度該 配置。編程智能體只會取得總計,以及開發執行的 淺白文字比較解讀,因此無法在測試分組上進行調校。
  7. 聆聽 run_simulation 錄音,或開啟 通話連結,親自與草稿對話。
  8. 按你的指示部署。

所有會使用點數的操作均須先取得報價:傳送 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 指南。