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。”
完整条款请参阅 服务条款中的 服务期限;暂停;终止。以条款为准;此处仅为摘要。