Open in
離開 ThunderPhone
將智能體匯出為開放檔案,並透過編碼智能體技能在 LiveKit Agents、Pipecat、Vapi 或 Retell 重新建立,亦可下載通話記錄及錄音。
你可隨時離開 ThunderPhone。每個智能體均可免費匯出為包含開放檔案的 zip,而一項技能可協助你的編碼智能體在 LiveKit Agents、Pipecat、Vapi 或 Retell 上重新建立它。本頁說明你可帶走甚麼、如何匯出,以及在另一端需要重新設定甚麼。
你可帶走的內容
| 項目 | 方式 |
|---|---|
| 一個智能體:指示、工具、轉接號碼、步驟、設定、號碼路由及 webhook | 智能體匯出,每個智能體一個 zip |
| 智能體的知識檔案 | 包含在智能體匯出檔案內 |
| 通話記錄及逐字稿 | 通話匯出,每次請求最多 1,000 通通話 |
| 錄音 | 每次請求一段錄音,按通話匯出 |
| 由你自己的電訊商提供的電話號碼 | 它們從未離開你的電訊商。請參閱電話號碼 |
匯出智能體
在 Zeus 中
開啟智能體並前往其設定(智能體編輯器中的 通話處理)。在底部的 匯出、複製或刪除 下,選擇 匯出。ZIP 檔案會下載至你的電腦。
使用 API
curl 'https://api.thunderphone.com/v1/agents/12/export' \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-o agent-12.zipZIP 檔案會在你提出要求時建立。任何擁有智能體讀取權限的人均可將其匯出。知識庫、電話號碼及 webhook 只會在憑證可讀取它們時包括在內:OAuth 權杖需要 knowledge:read、numbers:read 及 integrations:read,而 webhook 亦需要管理員或擁有者權限。任何略去的部分均會在 manifest.json 的 omitted 下列出。每分鐘超過 30 次匯出時,API 會回應 429。
| 查詢參數 | 說明 |
|---|---|
include_url_paths | true 會在匯出中保留每個 URL 的路徑,例如工具的端點。預設會將每個 URL 截短至其主機名稱。無論採用哪種方式,URL 中的使用者名稱、密碼及查詢字串均會被移除 |
如你準備在其他地方重建智能體,請使用 include_url_paths=true,因為該處需要工具端點。若計劃分享副本,則不要啟用此選項。
ZIP 檔案包含的內容
| 檔案 | 內容 |
|---|---|
manifest.json | 格式(thunderphone.agent-export/v1)、包含的內容,以及列出所有略去項目及原因的 omitted 清單 |
agent.json | GET /v1/agents/{agent_id} 所回傳的智能體資料,已移除憑證 |
prompt.md | 目前生效的指示 |
knowledge/index.json 及其旁邊的檔案 | 智能體的知識庫。每份文件均為原始檔案(如有儲存),否則為其擷取的文字 |
numbers.json | 路由至此智能體的電話號碼,包括入站及出站,以及任何固定的版本或變體 |
webhooks.json | 限定此智能體範圍的 webhook 端點,不包括其密鑰 |
README.md | 各檔案的用途 |
超過 25 MB 的知識庫檔案會被略去,整個匯出內容超過 100 MB 的部分亦會被略去。每個項目均會在 manifest.json 中列出,並附上下載它的端點:
GET /v1/knowledge/documents/{document_id}/original。
絕不包括的內容
- 憑證值。 工具的標頭只會按名稱列出。標頭值在 ThunderPhone 中為只寫資料:任何 API 回應均不會傳回它們,因此匯出亦不會包含。你需要在另一端重新輸入。這涵蓋 ThunderPhone 以憑證形式儲存的憑證。你的指示及知識庫檔案會完全按照你撰寫或上載的內容複製,因此如金鑰曾貼到提示或文件中,便會包含在 ZIP 檔案內。分享前請先檢查。
- 通話記錄及錄音。 它們有各自的匯出方式;請參閱通話記錄及錄音。
- 版本記錄。 匯出內容包含目前生效的智能體。較早版本仍會列於
GET /v1/agents/{agent_id}/versions。 - 此智能體轉交至的其他智能體。 請以相同方式分別匯出每個智能體。
轉移至其他平台
migrate-off-thunderphone 技能會引導你的編碼智能體完成轉移。安裝 ThunderPhone 技能:
npx skills add thunderphone/skills然後要求你的編碼智能體將智能體遷出 ThunderPhone,並指定目的地:LiveKit Agents、Pipecat、Vapi 或 Retell。技能會下載匯出檔、逐一要求你提供憑證、根據該目的地的對應設定重建智能體,並在轉移任何號碼前於該平台測試。轉換程序會在你的編碼智能體中執行,使用你自己的金鑰。ThunderPhone 絕不會寫入你在其他平台的帳戶。
技能會為你對應以下可轉移內容的檔案:
- 指示,包括共用指示及步驟。
- 工具:相同的端點、方法及參數結構。每個工具的
request_format會記錄你的端點預期的請求本文格式。 - 轉接號碼、結束通話及撥號鍵設定。
- 知識庫檔案。
- 留言信箱、靜音及通話時長設定。
- 智能體接聽及用作撥出電話的號碼。
你需要在另一端重新設定的項目:
- 語音、語言模型及聲音供應商。 你可在目的地自行選擇。無法保證聲音或通話效果能夠一致。
- 憑證。 工具標頭值及 webhook 密鑰。
- 電訊。 每個平台設定號碼接駁至智能體的方式均有不同。
- 步驟及交接。 如目的地設有流程或交接功能,便會在該處重建。否則,技能會將步驟整合至指示中,並通知你。
- 沒有對應功能的 ThunderPhone 設定。 智能程度、聆聽及回覆速度設定、內置電郵及短訊工具,以及通話評分、摘要及結果標籤,除非你自行重建,否則不會轉移。
- 請求簽章。 ThunderPhone 會為其發送的工具請求及 webhook 簽署。其他平台各有自己的簽署方式,因此會驗證 ThunderPhone 簽章的端點需要新的驗證檢查。
- 測試。 轉移號碼前,先在目的地測試重建後的智能體。
在新智能體通過你的測試前,請保留 ThunderPhone 智能體。這是你的回退方案。
電話號碼
待新智能體通過測試後,最後才轉移號碼。
- 由你自己電訊商提供的號碼(VoIP 連接)
會保留在該電訊商。請在電訊商控制台將號碼指向新平台。然後在 ThunderPhone 的號碼頁面選擇 釋放,並不要勾選
同時在我的 … 帳戶取消此號碼:號碼會與 ThunderPhone 中斷連接,並保留在你的電訊商帳戶中。透過 API,釋放號碼時,
使用
DELETE /v1/phone-numbers/{phone_number_id}?confirm=true,且不要傳送release_at_provider。 - 由 ThunderPhone 提供的號碼。 在釋放任何你希望保留的號碼前,請先聯絡 支援團隊。釋放 ThunderPhone 號碼屬永久操作:號碼會返回號碼池,並可能分配予其他客戶。
通話記錄及錄音
這些項目與智能體匯出檔分開處理。
- 通話。
GET /v1/calls/export每次請求最多可傳回 1,000 個通話,格式為 CSV(中繼資料)或 JSON(包含逐字稿)。使用agent_id篩選,並以start_date及end_date分頁瀏覽通話記錄。當符合條件的通話數量多於已傳回的數量時,X-Truncated回應標頭會為true。 - 錄音。
GET /v1/calls/{call_id}/audio會傳回單一通話錄音的短時效 URL。未有提供大量下載錄音的功能。
curl 'https://api.thunderphone.com/v1/calls/export?export_format=json&agent_id=12&start_date=2026-10-01T00:00:00Z&end_date=2026-11-01T00:00:00Z' \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-o calls-2026-10.json費用
零。智能體匯出、通話匯出及錄音下載均為 免費。ThunderPhone 採用按用量收費,不設訂閱 或席位費。當你釋放 ThunderPhone 號碼後,該號碼即停止計費。
離開後
不設固定合約期。你可透過帳戶的管理員電郵或其他可驗證渠道,向 legal@thunderphone.com 發出書面通知以終止協議。逾期付款可能導致服務暫停;但單憑此項 絕不會終止協議或觸發刪除客戶資料。有關資料,《條款》訂明:「正式終止後,供應商將於 六十(60)日內交還或刪除客戶資料,但須受限於客戶的匯出權利、備份週期、 法律保全令、法定保留要求、DPA 及任何已簽署的 BAA。」
完整條文載於 服務條款,章節為 服務期限;暫停;終止。《條款》為準;本文僅作摘要。