---
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 端点](/zh/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/guides/coding-agents)：

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

然后让您的编程智能体将一个智能体迁出 ThunderPhone，并指定目标平台：**LiveKit Agents**、**Pipecat**、**Vapi** 或 **Retell**。该技能会下载导出内容，逐一向您询问凭据，根据目标平台的映射重建智能体，并在迁移任何号码之前在该平台上进行测试。转换在您的编程智能体中使用您自己的密钥执行。ThunderPhone 绝不会写入您在其他平台上的账户。

技能会为您映射并迁移为文件的内容：

- 指令，包括共享指令和步骤。
- 工具：相同的端点、方法和参数架构。每个工具的 `request_format` 会记录您的端点所需的请求正文结构。
- 转接号码以及结束通话和按键设置。
- 知识文件。
- 语音信箱、静音和通话时长设置。
- 智能体接听哪些号码的来电，以及使用哪些号码外呼。

您需要在目标平台重新配置的内容：

- **语音、语言模型和语音提供商。** 您需要在目标平台选择它们。无法保证语音或通话声音效果能够匹配。
- **凭据。** 工具请求头值和 webhook 密钥。
- **电话通信。** 各个平台配置号码接入智能体的方式都不同。
- **步骤和交接。** 如果目标平台提供流程或交接功能，会在该平台上重新构建。否则，该技能会将步骤合并到指令中并告知您。
- **没有对应项的 ThunderPhone 设置。** 智能设置、听取和回复速度设置、内置电子邮件和短信工具，以及通话评分、摘要和结果标签都不会迁移，除非您重新构建它们。
- **请求签名。** ThunderPhone 会对其发送的工具请求和 webhook 进行签名。其他平台使用自己的签名方式，因此会[验证 ThunderPhone 签名](/zh/guides/verify-webhook-signatures)的端点需要新的验证检查。
- **测试。** 在迁移号码之前，请先在目标平台测试重建后的智能体。

在新智能体通过您的测试之前，请保留 ThunderPhone 智能体。它是您的回退方案。

## 电话号码

请在新智能体通过测试后，最后再迁移号码。

- **您自有运营商的号码**（[VoIP 连接](/zh/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/guides/pricing)模式，无订阅费和席位费。您释放 ThunderPhone 号码后，该号码将停止计费。

## 离开后

没有固定期限。您可以通过从账户管理邮箱发送的书面通知，或其他可验证渠道，向 legal@thunderphone.com 终止协议。付款逾期可能导致服务暂停；但付款逾期本身不会终止协议，也不会触发删除客户数据。关于数据，条款规定：“正式终止后，服务提供商将在六十（60）天内返还或删除客户数据，但须遵守客户的导出权利、备份周期、法律保全、法律要求的保留期限、DPA 以及任何已签署的 BAA。”

完整条款请参阅
[服务条款](https://thunderphone.com/terms#term-termination)中的
**服务期限；暂停；终止**。以条款为准；此处仅为摘要。

## 相关内容

- [从其他平台导入智能体](/zh/guides/import-agents)
- [用于编程智能体的技能](/zh/guides/coding-agents)
- [智能体 API](/api-reference/agents)
- [通话 API](/api-reference/calls)
