---
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` and the files beside it | 智慧體的知識。每份文件會是儲存的原始檔案；若沒有原始檔案，則為其擷取的文字 |
| `numbers.json` | 路由至此智慧體的號碼，包括撥入和撥出號碼，以及任何釘選的版本或變體 |
| `webhooks.json` | 限於此智慧體的 [Webhook 端點](/zh-Hant/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 技能](/zh-Hant/guides/coding-agents)：

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

接著要求你的程式設計智慧體將智慧體移出 ThunderPhone，並指定
目的地：**LiveKit Agents**、**Pipecat**、**Vapi** 或 **Retell**。此
技能會下載匯出資料、逐一詢問你各項憑證、根據該目的地的對應關係重建智慧體，
並在移轉任何號碼前於該平台進行測試。轉換會在你的程式設計智慧體中執行，
並使用你自己的金鑰。ThunderPhone 絕不會寫入你在其他平台上的帳號。

技能會為你對應並保留為檔案的內容：

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

你需要在另一端重新設定的內容：

- **語音、語言模型與語音供應商。** 你在目的地選擇這些供應商。
  無法保證語音或通話聽起來的效果會一致。
- **憑證。** 工具標頭值與 Webhook 密鑰。
- **電話服務。** 每個平台設定號碼如何連線至智慧體的方式都不同。
- **步驟與交接。** 若目的地具備流程或交接功能，會在該平台重新建立。
  在其他平台上，技能會將步驟整合至指示中並告知你。
- **沒有對應項目的 ThunderPhone 設定。** 智慧程度、聽取與回覆速度設定、
  內建電子郵件與簡訊工具，以及通話評分、摘要與結果標籤，除非你重新建立，
  否則不會移轉。
- **請求簽章。** ThunderPhone 會為其傳送的工具請求與 Webhook 簽署。
  其他平台會以自己的方式簽署，因此會
  [驗證 ThunderPhone 簽章](/zh-Hant/guides/verify-webhook-signatures) 的端點
  需要新的驗證機制。
- **測試。** 在移轉號碼前，先在目的地測試重建的智慧體。

在新的智慧體通過你的測試前，請保留 ThunderPhone 智慧體。這是你的退路。

## 電話號碼

請最後再移轉號碼，待新的智慧體通過測試後再進行。

- **你自己電信業者的號碼**（[VoIP 連線](/zh-Hant/guides/bring-your-own-numbers)）
  會保留在該電信業者。請在電信業者的控制台中，將其指向新平台。
  接著在 ThunderPhone 的號碼頁面選擇 **釋放**，並保持
  **同時取消我在 … 帳號中的此號碼** 未勾選：該號碼會與 ThunderPhone
  中斷連線，但仍保留在你的電信業者帳號中。透過 API，使用
  `DELETE /v1/phone-numbers/{phone_number_id}?confirm=true` 來
  [釋放](/api-reference/phone-numbers#release-a-phone-number) 號碼，
  且不要傳送 `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 採用[隨用隨付](/zh-Hant/guides/pricing)模式，無須訂閱，也不收取席位費。當你釋出 ThunderPhone 號碼後，該號碼將停止計費。

## 離開後

沒有固定合約期限。你可透過帳戶管理員電子郵件，或其他可驗證的管道，以書面通知 legal@thunderphone.com 終止協議。付款逾期可能會暫停服務；但單憑此事絕不會終止協議，也不會觸發刪除客戶資料。關於資料，條款指出：「在正式終止後，供應商將在六十（60）天內返還或刪除客戶資料，但須遵守客戶的匯出權利、備份週期、法律保全、法律要求的保存義務、DPA，以及任何已簽署的 BAA。」

完整內容請參閱[服務條款](https://thunderphone.com/terms#term-termination)中的
**服務期限；暫停；終止**。服務條款為準；此處僅為摘要。

## 相關內容

- [從其他平台匯入智慧體](/zh-Hant/guides/import-agents)
- [程式設計智慧體的技能](/zh-Hant/guides/coding-agents)
- [智慧體 API](/api-reference/agents)
- [通話 API](/api-reference/calls)
