---
title: "離開 ThunderPhone"
description: "將智能體匯出為開放檔案，並透過編碼智能體技能在 LiveKit Agents、Pipecat、Vapi 或 Retell 重新建立，亦可下載通話記錄及錄音。"
ui: zeus
---

你可隨時離開 ThunderPhone。每個智能體均可免費匯出為包含開放檔案的 zip，而一項技能可協助你的編碼智能體在 LiveKit Agents、Pipecat、Vapi 或 Retell 上重新建立它。本頁說明你可帶走甚麼、如何匯出，以及在另一端需要重新設定甚麼。

## 你可帶走的內容

| 項目 | 方式 |
|---|---|
| 一個智能體：指示、工具、轉接號碼、步驟、設定、號碼路由及 webhook | [智能體匯出](#export-an-agent)，每個智能體一個 zip |
| 智能體的知識檔案 | 包含在智能體匯出檔案內 |
| 通話記錄及逐字稿 | [通話匯出](#call-history-and-recordings)，每次請求最多 1,000 通通話 |
| 錄音 | 每次請求一段錄音，按通話匯出 |
| 由你自己的電訊商提供的電話號碼 | 它們從未離開你的電訊商。請參閱[電話號碼](#phone-numbers) |

## 匯出智能體

### 在 Zeus 中

開啟智能體並前往其設定（智能體編輯器中的 **通話處理**）。在底部的 **匯出、複製或刪除** 下，選擇 **匯出**。ZIP 檔案會下載至你的電腦。

### 使用 API

<CodeGroup>
```bash cURL
curl 'https://api.thunderphone.com/v1/agents/12/export' \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -o agent-12.zip
```
</CodeGroup>

ZIP 檔案會在你提出要求時建立。任何擁有智能體讀取權限的人均可將其匯出。知識庫、電話號碼及 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}`](/api-reference/agents#agent-object) 所回傳的智能體資料，已移除憑證 |
| `prompt.md` | 目前生效的指示 |
| `knowledge/index.json` 及其旁邊的檔案 | 智能體的知識庫。每份文件均為原始檔案（如有儲存），否則為其擷取的文字 |
| `numbers.json` | 路由至此智能體的電話號碼，包括入站及出站，以及任何固定的版本或變體 |
| `webhooks.json` | 限定此智能體範圍的 [webhook 端點](/yue/webhooks/endpoints)，不包括其密鑰 |
| `README.md` | 各檔案的用途 |

超過 25 MB 的知識庫檔案會被略去，整個匯出內容超過 100 MB 的部分亦會被略去。每個項目均會在 `manifest.json` 中列出，並附上下載它的端點：
[`GET /v1/knowledge/documents/{document_id}/original`](/api-reference/knowledge-bases#download-the-original-file)。

### 絕不包括的內容

- **憑證值。** 工具的標頭只會按名稱列出。標頭值在 ThunderPhone 中為只寫資料：任何 API 回應均不會傳回它們，因此匯出亦不會包含。你需要在另一端重新輸入。這涵蓋 ThunderPhone 以憑證形式儲存的憑證。你的指示及知識庫檔案會完全按照你撰寫或上載的內容複製，因此如金鑰曾貼到提示或文件中，便會包含在 ZIP 檔案內。分享前請先檢查。
- **通話記錄及錄音。** 它們有各自的匯出方式；請參閱[通話記錄及錄音](#call-history-and-recordings)。
- **版本記錄。** 匯出內容包含目前生效的智能體。較早版本仍會列於
  [`GET /v1/agents/{agent_id}/versions`](/api-reference/agents#version-history)。
- **此智能體轉交至的其他智能體。** 請以相同方式分別匯出每個智能體。

## 轉移至其他平台

`migrate-off-thunderphone` 技能會引導你的編碼智能體完成轉移。安裝 [ThunderPhone 技能](/yue/guides/coding-agents)：

```bash
npx skills add thunderphone/skills
```

然後要求你的編碼智能體將智能體遷出 ThunderPhone，並指定目的地：**LiveKit Agents**、**Pipecat**、**Vapi** 或 **Retell**。技能會下載匯出檔、逐一要求你提供憑證、根據該目的地的對應設定重建智能體，並在轉移任何號碼前於該平台測試。轉換程序會在你的編碼智能體中執行，使用你自己的金鑰。ThunderPhone 絕不會寫入你在其他平台的帳戶。

技能會為你對應以下可轉移內容的檔案：

- 指示，包括共用指示及步驟。
- 工具：相同的端點、方法及參數結構。每個工具的 `request_format` 會記錄你的端點預期的請求本文格式。
- 轉接號碼、結束通話及撥號鍵設定。
- 知識庫檔案。
- 留言信箱、靜音及通話時長設定。
- 智能體接聽及用作撥出電話的號碼。

你需要在另一端重新設定的項目：

- **語音、語言模型及聲音供應商。** 你可在目的地自行選擇。無法保證聲音或通話效果能夠一致。
- **憑證。** 工具標頭值及 webhook 密鑰。
- **電訊。** 每個平台設定號碼接駁至智能體的方式均有不同。
- **步驟及交接。** 如目的地設有流程或交接功能，便會在該處重建。否則，技能會將步驟整合至指示中，並通知你。
- **沒有對應功能的 ThunderPhone 設定。** 智能程度、聆聽及回覆速度設定、內置電郵及短訊工具，以及通話評分、摘要及結果標籤，除非你自行重建，否則不會轉移。
- **請求簽章。** ThunderPhone 會為其發送的工具請求及 webhook 簽署。其他平台各有自己的簽署方式，因此會[驗證 ThunderPhone 簽章](/yue/guides/verify-webhook-signatures)的端點需要新的驗證檢查。
- **測試。** 轉移號碼前，先在目的地測試重建後的智能體。

在新智能體通過你的測試前，請保留 ThunderPhone 智能體。這是你的回退方案。

## 電話號碼

待新智能體通過測試後，最後才轉移號碼。

- **由你自己電訊商提供的號碼**（[VoIP 連接](/yue/guides/bring-your-own-numbers)）
  會保留在該電訊商。請在電訊商控制台將號碼指向新平台。然後在 ThunderPhone 的號碼頁面選擇 **釋放**，並不要勾選
  **同時在我的 … 帳戶取消此號碼**：號碼會與 ThunderPhone 中斷連接，並保留在你的電訊商帳戶中。透過 API，[釋放](/api-reference/phone-numbers#release-a-phone-number)號碼時，
  使用 `DELETE /v1/phone-numbers/{phone_number_id}?confirm=true`，且不要傳送 `release_at_provider`。
- **由 ThunderPhone 提供的號碼。** 在釋放任何你希望保留的號碼前，請先聯絡
  [支援團隊](mailto:support@thunderphone.com)。釋放 ThunderPhone 號碼屬永久操作：號碼會返回號碼池，並可能分配予其他客戶。

## 通話記錄及錄音

這些項目與智能體匯出檔分開處理。

- **通話。** [`GET /v1/calls/export`](/api-reference/calls#export-calls)
  每次請求最多可傳回 1,000 個通話，格式為 CSV（中繼資料）或 JSON（包含逐字稿）。使用 `agent_id` 篩選，並以
  `start_date` 及 `end_date` 分頁瀏覽通話記錄。當符合條件的通話數量多於已傳回的數量時，`X-Truncated` 回應標頭會為 `true`。
- **錄音。** [`GET /v1/calls/{call_id}/audio`](/api-reference/calls#get-recording-audio)
  會傳回單一通話錄音的短時效 URL。未有提供大量下載錄音的功能。

<CodeGroup>
```bash cURL
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
```
</CodeGroup>

## 費用

零。智能體匯出、通話匯出及錄音下載均為
免費。ThunderPhone 採用[按用量收費](/yue/guides/pricing)，不設訂閱
或席位費。當你釋放 ThunderPhone 號碼後，該號碼即停止計費。

## 離開後

不設固定合約期。你可透過帳戶的管理員電郵或其他可驗證渠道，向
legal@thunderphone.com 發出書面通知以終止協議。逾期付款可能導致服務暫停；但單憑此項
絕不會終止協議或觸發刪除客戶資料。有關資料，《條款》訂明：「正式終止後，供應商將於
六十（60）日內交還或刪除客戶資料，但須受限於客戶的匯出權利、備份週期、
法律保全令、法定保留要求、DPA 及任何已簽署的 BAA。」

完整條文載於
[服務條款](https://thunderphone.com/terms#term-termination)，章節為
**服務期限；暫停；終止**。《條款》為準；本文僅作摘要。

## 相關內容

- [從其他平台匯入智能體](/yue/guides/import-agents)
- [編碼智能體的技能](/yue/guides/coding-agents)
- [智能體 API](/api-reference/agents)
- [通話 API](/api-reference/calls)
