---
title: "从其他平台导入智能体"
description: "使用 API 密钥或 JSON 导出文件，从 Vapi、Retell、ElevenLabs Agents 或 Bland 迁移智能体、工具和知识库，检查映射后导入。"
ui: zeus
---

如果您的智能体部署在 Vapi、Retell、ElevenLabs Agents 或 Bland 上，导入工具会获取它们，将每个字段映射到 ThunderPhone，并在创建任何内容之前向您显示结果。

<Note>
  您的 API 密钥仅用于导入。在获取清单期间会被加密，并会在获取完成后——以及在任何失败或丢弃操作后——立即删除。开始或提交导入需要管理员角色。
</Note>

## 开始导入

1. 打开**智能体**并选择**导入智能体**，或请 Zeus 将您的
   智能体迁移过来。
2. 选择平台。
3. 按照步骤在该平台上创建密钥（系统会为您打开相应的
   设置页面）并粘贴密钥，或者选择**改为粘贴导出的 JSON**
   并粘贴该平台控制台或 API 中的一个或多个智能体对象。
4. 选择**获取我的智能体**（按钮会显示您的平台名称）。获取和映射通常不到
   一分钟；您可以离开此页面后再返回。仍在进行的导入以及您之前的导入，
   都会列在**导入智能体**页面中。

在旧版视图中，**导入**位于**语音智能体**中，并会在对话框中打开相同的步骤。

## 审核方案

每个智能体都会显示名称、匹配的语音（以及匹配置信度）、其包含的工具和知识库，以及有关翻译过程中任何变更的说明。展开一行即可查看提示词：

- **已清理**（旧视图中为 **已重写**）——采用
  [提示词编写指南](/zh/guides/prompting)风格的一份连贯提示词，保留源内容中的每个电话号码、URL、工具
  名称和占位符。
- **与 Vapi 一致**，或您的平台名称（旧视图中为 **结构化**）——按标题排列的源配置，与
  提取结果完全一致。当无法验证重写结果，或重写结果比源内容短得多时，将自动使用此选项。

从流程导入的智能体会显示 **共享说明**，而不是
提示词，并显示它从流程中保留了多少个步骤。旧视图的审核会
列出每个步骤的名称、它指示智能体执行的操作以及下一步去向，而 **显示为单个提示词** 会将同一智能体显示为单个提示词，
这也是在步骤不可用时它运行的内容。
具有转接的智能体会列出它们将来电者转接给的智能体；如果您取消勾选
其中一个，审核会显示不会配置该转接。

除空白智能体和平台为您创建的默认初始智能体外，每个智能体
默认均处于选中状态。取消勾选您不需要的智能体，编辑名称、
语音、设置或提示词选项，然后选择 **导入**。智能体会连同其 API 连接和知识库一起
保存；在将其配置到号码之前，请打开一个智能体进行检查并试拨电话。

## 流程、Squad 和智能体转接

多步骤智能体会保留其结构。请参阅[智能体步骤](/zh/guides/agent-steps)，了解步骤和交接如何在通话中运行。

- **流程会变为步骤。** Retell 多提示词状态和对话流程、Bland 路径以及 ElevenLabs 工作流会作为智能体的步骤导入。源平台的全局提示词会成为共享指令。
  - 每个节点的指令、固定话术、要收集的值和工具都会保留。
  - 以文字编写的边缘条件会变为由智能体决定的转场。对收集值或 webhook 响应的单一比较
    （`age >= 18`）会变为精确检查的转场。
  - webhook 和函数节点会在步骤开始时运行其工具。全局节点可以从任何步骤到达；如果全局节点本身没有后续路径，通话会返回到它中断的步骤。
  - 转接和结束节点会变为用于转接或结束通话的最后步骤。Retell 转接节点会保留其出口，以便转接未成功时继续处理。
  - 仅用于选择下一步骤的分支节点会在可能的情况下合并到前一步骤中。否则，它会保留为独立步骤，并附带说明。
  - 对于步骤过大，或 ThunderPhone 无法表示为步骤的流程，会作为一个列出所有步骤的提示词导入，并附带说明。
- **Squad、智能体转接和智能体切换会变为交接。** Vapi Squad 的每位成员都会作为独立智能体导入，并以成员和 Squad 命名。第一位成员接听 Squad 的通话，其他成员则通过交接接通。ElevenLabs 转接至其他智能体以及 Retell 智能体切换也会变为交接。来电者会保持在线，且此前的对话会一并保留。
  - 通过交接接入的通话会保留最初接听该通话的智能体的通话设置：语音信箱、通话限制、语言和录音。接手的智能体会使用自己的提示词、步骤、工具和语音。
  - 交接只能指向同一次导入中导入的智能体。如果另一个智能体不在导入内容中，或者您取消勾选了它，说明会指出这一点，您可以稍后在智能体的设置中添加交接。

## 导入内容

<Tabs>
  <Tab title="Vapi">
    **获取密钥**

    1. 打开 [dashboard.vapi.ai/org/api-keys](https://dashboard.vapi.ai/org/api-keys)
       （组织设置 → API 密钥）。
    2. 创建密钥并选择 **私有** ——公有密钥无法列出
       智能体。
    3. 将其复制到对话框中。Vapi 密钥不设权限范围；如果您仅为此操作创建了该密钥，请在导入后于
       Vapi 中删除它。

    | Vapi 字段 | ThunderPhone |
    |---|---|
    | `model.messages[system]` | 提示词 |
    | `firstMessage`、`firstMessageMode` | 提示词中的开场白；由谁先说话 |
    | `voice.provider` + `voiceId` | 最接近的语音目录声音，并尽力查询 Vapi 库（显示匹配置信度） |
    | `transcriber.language`、`languages`、关键词/关键术语 | 语言和语音识别词汇 |
    | `model.model` | 未映射：导入的智能体默认使用 Pro 智能和 Standard 听觉 |
    | `model.tools`、`toolIds`、`toolRefs`（function、apiRequest） | API 连接；保留 Vapi 请求封装和智能体级服务器回退 |
    | `transferCall` 目标 | 提示词中的电话转接；SIP、智能体和动态目标会报告以供审核 |
    | `handoff` 工具 | 转接至同一次导入中已导入的指定智能体 |
    | `endCall`、`dtmf` | 内置功能 |
    | Google Calendar、Google Sheets、`sms` | 报告所需的 ThunderPhone 集成或短信设置 |
    | Slack | 报告为未导入：ThunderPhone 尚无法连接 Slack |
    | `query` 和 `knowledgeBase` 工具，以及旧版 `knowledgeBaseId` | 将可访问的已上传文件作为文档的知识库 |
    | `endCallMessage`、`endCallPhrases`、`voicemailMessage`、空闲消息计划和超时钩子 | 提示词部分；语音信箱和静音设置 |
    | `maxDurationSeconds`、不录音选项 | 最长通话时长（保留 Vapi 默认的 600 秒）；审核页面会报告不录音选项 |
    | Squads | 每位成员对应一个智能体，各自拥有提示词、覆盖设置、语音、工具和知识。`assistantDestinations` 会成为它们之间的转接；第一位成员保留 Squad 的号码 |
    | 自定义知识/模型服务器、合规计划、其他钩子、工作流和不受支持的托管工具 | 报告具体的审核或重建操作；不会存储原始计划和凭据 |
  </Tab>
  <Tab title="Retell">
    **获取密钥**

    1. 打开 [dashboard.retellai.com/apiKeys](https://dashboard.retellai.com/apiKeys)
       （系统设置 → API 密钥），然后选择 **创建密钥**。
    2. 启用 **限制权限**，并将 **智能体**、**知识库**
       和 **电话**设为 **读取**。其他所有组均不要勾选；导入工具绝不会向 Retell 写入数据。
    3. 将密钥复制到对话框中。

    | Retell 字段 | ThunderPhone |
    |---|---|
    | 最新发布的智能体及其精确的 Retell LLM／流程版本 | 已发布的提示词和行为；较新的草稿会标记为待审查 |
    | Retell LLM `general_prompt`、`begin_message`、`start_speaker`、状态 | 共享指令；开场行为；每个状态对应一个步骤，包含其工具、转换以及每次转换收集的值 |
    | 对话流程 `global_prompt`、节点、组件、全局节点和边 | 共享指令和步骤；会精确检查收集值上的方程条件；精确的开场文本和转接步骤 |
    | `agent_swap` 工具和节点 | 转交给同次导入中导入的 Retell 智能体 |
    | 自定义工具 | 包含查询参数、超时设置和仅 Retell／args 请求结构的 API 连接；会报告签名变更以及任何非默认的语音、重试、响应变量或表单编码设置 |
    | `transfer_call`、`end_call`、`press_digit` | 条件转接（包括分机号）+ 内置功能；会报告推断转接和暖转接的差异 |
    | `check_availability_cal`、`book_appointment_cal` | 标记为需在集成下重新连接的 Cal.com 工具；Retell 凭据绝不会延续 |
    | `send_sms`、MCP | 会提供 SMS 或 MCP 设置说明 |
    | `voice_id`（`11labs-`、`openai-`、`cartesia-`、…） | 最接近的目录语音 |
    | `language`（一个区域设置、多语言模式或区域设置列表） | 主要语言和其他语言 |
    | `model` / `s2s_model` | 未映射：导入的智能体将以 Pro 智能级别和 Standard 听觉级别开始 |
    | `knowledge_base_ids`（url、文档、文本来源） | 包含文档的知识库 |
    | `default_dynamic_variables`、支持的系统变量 | ThunderPhone 变量默认值和纯文本通话上下文指令 |
    | `voicemail_option`、`end_call_after_silence_ms`、`max_call_duration_ms`、`ring_duration_ms`、禁用录音、`boosted_keywords` | 语音信箱行为；通话限制；录音设置；提示词术语 |
    | `webhook_url`、自定义 LLM 引擎、不支持的流程节点和仅限供应商的设置 | 标记为需要手动审查，不会被静默丢弃 |
  </Tab>
  <Tab title="ElevenLabs 智能体">
    **获取密钥**

    1. 打开 [elevenlabs.io/app/settings/api-keys](https://elevenlabs.io/app/settings/api-keys)
       并选择 **创建 API 密钥**。
    2. 在权限下，为其授予 **智能体平台：读取**
       （如显示，也授予 **知识库：读取**）；导入工具不需要其他权限。
    3. 将密钥复制到对话框中。

    | ElevenLabs 字段 | ThunderPhone |
    |---|---|
    | `conversation_config.agent.prompt.prompt`、智能体工作流节点和有序分支条件 | 共享指令以及每个工作流节点对应一个步骤；工具节点会在步骤开始时运行其工具；表达式分支会标记为待审查 |
    | `first_message`、`language`、`language_presets` | 开场语；主要语言和其他语言；翻译后的开场语 |
    | `prompt.llm` | 未映射：导入的智能体将以 Pro 智能级别和 Standard 听觉级别开始 |
    | `tts.voice_id` | 最接近的目录语音 |
    | webhook `tool_ids`，包括附加到工作流步骤的工具 | 包含可移植请求正文／查询参数的 API 连接；固定供应商参数和凭据会被移除并报告 |
    | 用于结束通话、电话转接、按键和语音信箱的 `built_in_tools` | 内置功能、转接规则和语音信箱行为；SIP 和动态目标会标记为需要重新构建 |
    | 转接到其他智能体（`transfer_to_agent`、智能体工作流节点） | 转交给同次导入中导入的 ElevenLabs 智能体 |
    | `knowledge_base` url／文本／文件／文件夹条目，包括工作流步骤知识 | 知识库文档；文件夹会被展开，文本／文件内容会按 id 获取 |
    | `turn.silence_end_call_timeout`、`conversation.max_duration_seconds`、`asr.keywords`、`privacy.record_voice` | 静默和最长时长限制；发音术语；关闭录音会在审查页面中报告 |
    | 自定义 LLM、MCP 服务器、过程、工作区 webhook、每步模型／语音／语言覆盖、ElevenLabs 预约工具 | 会报告导入后所需的操作 |
  </Tab>
  <Tab title="Bland">
    **获取密钥**

    1. 打开 [app.bland.ai/dashboard/settings](https://app.bland.ai/dashboard/settings)。
    2. 复制其中显示的 **API 密钥**（Bland 每个账户只有一个密钥；该密钥不设权限范围，因此如有需要，您可在之后轮换该密钥）。
    3. 将其粘贴到对话框中。

    Bland 显示标签不会被视为智能体的身份。导入工具会根据问候语和提示词判断智能体自称的身份；对于流程，则使用全局提示词和起始节点。如果无法进行该检查或未找到名称，导入后的提示词将保持中性。

    | Bland 字段 | ThunderPhone |
    |---|---|
    | Web 智能体 `prompt`、`first_sentence`、`language`、`model`、`voice`、`pathway_id` | 提示词；开场白；语言；档位；最接近的语音；已附加的已发布路径流程 |
    | Persona 生产版本 | 个性和编排提示词；语音；语言；呼叫者先说话设置；录音；最长时长；默认工具和知识。包含单个附加路径；多路径路由会标记为需手动设置 |
    | 自定义和路径工具（url、方法、架构、标头、正文变量） | API 连接。Bland Secret 引用会被报告，且必须重新添加 |
    | Cal.com、HubSpot、Salesforce、Google Calendar 和 Google Sheets 工具 | 会列出对应的 ThunderPhone 集成，供您连接并启用 |
    | Slack 工具 | 会报告为未导入：ThunderPhone 尚无法连接 Slack |
    | 呼入号码详情（`prompt`、`pathway_id` / 版本、工具、转接、关键词、请求数据） | 每个呼入号码对应一个智能体，包含通话变量默认值和转接规则 |
    | 每个路径，无论是否附加到号码 | 可用时使用已发布版本；未发布草稿会被明确标记 |
    | 全局提示词；默认、知识库、转接通话、结束通话、Webhook 和等待响应节点；边、循环条件、全局节点、提取变量、静态话术 | 共享指令以及每个节点对应的一个步骤，包括可随时执行的步骤、要收集的值、精确话术、Webhook 步骤、转接和挂断。会精确检查响应字段或提取变量上的 Webhook 响应路径 |
    | 内联知识文本和可解析的知识 ID | 知识文档。无法读取文本或文件的项目会报告为需手动上传 |
    | `max_duration`、`wait_for_greeting`、录音设置 | 通话时限、说话顺序、录音设置 |
    | `webhook`、动态数据查找、多路径 Persona 路由、不支持的节点设置、v2 智能体 | 会报告所需的手动后续操作 |
    | 呼入号码 | 会同时列出两种选项，因为 Bland 不会说明号码归其所有还是归您的 Twilio 账户所有 |
  </Tab>
</Tabs>

## 需在 ThunderPhone 中处理的内容

审核页面底部的报告会列出未迁移的号码、Webhook 和工具；每个智能体的说明涵盖其余内容。它们共同展示所有未迁移的内容及其原因：

- **电话号码。** 导入后，每个源号码都会显示其所在位置以及您可以对其执行的操作：
  - **位于您自己的 Twilio 或 Telnyx 账户中**（例如，您连接到 Vapi 或 ElevenLabs 的 Twilio 号码）：管理员可以将其移至已导入的智能体。如果尚未有任何 [VoIP 连接](/zh/guides/bring-your-own-numbers)关联该账户，请先连接。任何更改发生前，确认步骤会说明拨打该号码的电话将不再转至旧平台。
    随后，ThunderPhone 会在您的运营商账户中将该号码指向自身（Twilio 号码会加入 ThunderPhone 的 SIP 中继；Telnyx 号码会移至 ThunderPhone 的 SIP 连接），并发起一次简短的测试通话以启用它。如需撤销此操作，请在 **电话与网页** 中删除该号码，同时将其保留在您的运营商账户中，然后在旧平台上重新导入。
  - **位于您的 SIP 中继上**：将该中继连接为
    [SIP 连接](/zh/guides/voip-providers)，然后在 **电话与网页** 中导入该号码。
  - **由平台出售**（在那里购买的 Vapi、Retell 和 Bland 号码）：ThunderPhone 无法迁移该号码。请将其转移至运营商后导入，或者获取一个 ThunderPhone 号码并将其关联到已导入的智能体。
  - Bland 不会说明号码是其自有号码还是来自您的 Twilio 账户，因此 Bland 号码会显示这两种选项。
- **按智能体配置的 Webhook。** ThunderPhone 按组织交付已签名的 Webhook；请在 [Webhook](/zh/webhooks/overview)下设置一个。
- **供应商存储的凭据。** 系统会复制可见的工具标头。旧平台按 ID 存储的凭据会被标记；请将其添加到 API 连接的标头中。
- **内置集成。** 旧平台托管的日历、CRM 和消息工具（例如 Cal.com 预订）会改为列出需要连接的 ThunderPhone 集成；其凭据不会一并迁移。审核还会标记仍指示智能体使用未导入工具的提示词。
- **短信。** ThunderPhone 智能体通过您自己的 Twilio 或 Telnyx 号码发送短信；请在智能体设置中配置 SMS。
- **没有对应项的工具**（平台特定的自动化）会被列出，以确保不会悄然遗漏任何内容。
- **通话变量。** 会保留 `{{name}}` 占位符及您平台原有的默认值。ThunderPhone 会根据[通话开始时传入的变量](/zh/guides/call-variables)填充它们，否则将其留空；审核会列出您需要传入的变量。
- **通话限制和录音。** 会导入最长通话时长。当源智能体从未更改此设置时，会设置平台自身的默认值：Vapi 和 ElevenLabs 为 10 分钟，Retell 为 1 小时，Bland 为 30 分钟。不是正数的源值会在不设置最长时长的情况下导入，审核中也会说明这一点。超出 ThunderPhone 范围的静音和最长时长限制会被调整，审核说明会列出源值和导入后的值。当源智能体关闭了通话录音时，智能体的审核说明会指出其导入后是否保持关闭录音，或者在尚不支持关闭录音的情况下以开启录音的状态导入。

## 导入时会发生哪些变化

旧平台保留为其自身默认值的部分设置，会改用 ThunderPhone 的默认值。审核会在每个智能体的详情中，以每个智能体一条说明的形式列出这些设置，但仅在两个平台存在差异时显示。以下 ThunderPhone 数值为其默认值，您可以按智能体分别更改：

| 设置 | 原平台默认值 | ThunderPhone 默认值 |
|---|---|---|
| 外呼响铃时长 | Retell：30 秒 | 60 秒 |
| 结束静默通话 | Retell：10 分钟后挂断；ElevenLabs：从不挂断 | 每 15 秒询问一次（若尚无人说话，则约 6 秒后询问；若来电者要求智能体等待，则至少 1 分钟后询问），静默 1 分钟后挂断 |
| 通话录音 | Bland 入站号码和角色：关闭 | 开启。请联系支持团队，或在可用时于智能体设置中更改 |
| 遇到语音信箱时 | Bland 角色：挂断 | 智能体根据其提示词决定 |

您在旧平台中更改过的设置会按您的设置导入，不会列在这里。唯一的例外是“从不挂断”的静默通话设置：它会像默认值一样列出，并且智能体会保留 ThunderPhone 的确认机制。导入后，您可以在智能体设置中更改其中任何一项。

## 无需密钥导入

选择 **改为粘贴导出的 JSON**，然后粘贴您的平台 API
或控制台导出的对象，作为单个对象或 JSON 列表：

- **Vapi** —— 助理对象（`GET /assistant/{id}`）、Squad 对象（`GET /squad/{id}`），或两者之一的列表。仅通过 id 关联的工具和知识文件需要密钥才能解析。Vapi 已弃用 Workflows，因此请先将 Workflow 转换为 Squad，再进行粘贴。
- **Retell** —— 智能体对象（`GET /get-agent/{id}?version=...`）**及其同版本的** Retell LLM（`GET /get-retell-llm/{id}?version=...`），或同一列表中的对话流程对象。导入器会按 id 和版本关联；如果存在发布状态，会优先使用粘贴的已发布智能体；独立的 LLM 或流程会以生成的名称导入。
- **ElevenLabs** —— 智能体对象（`GET /v1/convai/agents/{id}`）。当前导出通常仅通过 id 引用 webhook 工具和知识文档。粘贴时会将这些项目报告为未解析；请使用 API 密钥进行完整导入。
- **Bland** —— 网页智能体、`/v1/agents` 响应或 pathway 对象。每个粘贴的对象都会作为独立智能体导入，即使两个对象共享同一 id；需要 API 访问权限的工具和知识 id 会列出以供手动设置，而不会被丢弃。

仅通过 ID 引用且未包含在粘贴内容中的项目会列在说明中。

## 导入后

1. 打开每个智能体并阅读其备注。
2. 在智能体页面上点击 **测试通话**，或让 Zeus 对其进行测试。
3. 迁移您的号码，或绑定一个新号码（参见上方的 **电话号码**）。
4. 使用请求测试器测试每个 API 连接。
5. 确认知识文档已完成索引。
6. 如果旧智能体使用了组织 webhook，请设置组织 webhook。

导入器也可通过 [REST API](/api-reference/agent-imports) 使用。

导入不会将您锁定在 ThunderPhone 中。任何智能体都可以随时免费导出为开放文件：请参阅[离开 ThunderPhone](/zh/guides/leaving-thunderphone)。
