---
title: "從其他平台匯入智能體"
description: "使用 API 金鑰或 JSON 匯出檔，從 Vapi、Retell、ElevenLabs Agents 或 Bland 匯入智能體、工具及知識庫，檢視對應關係後完成匯入。"
ui: classic
---

如果你的智能體位於 Vapi、Retell、ElevenLabs Agents 或 Bland，匯入工具會擷取它們，將每個欄位對應至 ThunderPhone，並在建立任何內容前向你顯示結果。

<Note>
  你的 API 金鑰僅用於匯入。在擷取清單期間會經過加密處理，擷取完成後會立即刪除；如有任何失敗或捨棄操作，亦會刪除。開始或確認匯入需要管理員角色。
</Note>

## 開始匯入

1. 開啟 **智能體** 並選擇 **匯入**（或在空白智能體頁面選擇 **從 Vapi、Retell、ElevenLabs 或 Bland 匯入**）。
2. 選擇平台。
3. 按照對話框中的編號步驟，在該平台建立金鑰（系統會為你開啟相應的設定頁面）並貼上；或者切換至 **貼上匯出的 JSON**，並從該平台的控制台或 API 貼上一個或多個智能體物件。
4. 選擇 **擷取我的智能體**。擷取及對應通常不足一分鐘；你可以離開頁面，稍後透過工作匣返回查看。

## 檢閱方案

每個智能體均會顯示名稱、配對的語音（包括配對信心程度）、
隨附的工具和知識庫，以及翻譯期間任何變更的備註。展開某一列以閱讀提示：

- **已重寫** —— 一個連貫的提示詞，採用[提示詞撰寫指南](/yue/guides/prompting)的風格，並保留來源中的每個電話號碼、URL、工具名稱及佔位符。
- **結構化** —— 完全按照擷取結果，將原始設定排列於各標題之下。當無法驗證重寫內容，或重寫後的內容遠比來源短時，系統會自動使用此選項。

從流程匯入的智能體會顯示 **共用指示** 而非提示詞，然後列出其步驟：每個步驟的名稱、向智能體說明的操作，以及下一步的去向。**顯示為單一提示詞** 會將同一智能體顯示為單一提示詞，亦即在無法使用步驟的情況下實際執行的內容。設有轉接的智能體會列出可將來電者轉接至哪些智能體；如取消勾選其中一個，檢閱頁面會顯示該轉接不會被設定。

除空白智能體及平台為你建立的預設入門智能體外，所有智能體一開始均已選取。取消勾選你不需要的智能體，編輯名稱、語音、層級或提示詞選項，然後按 **匯入**。建立的智能體會在建構工具中開啟，並附帶其 API 連接及知識庫。

## 流程、團隊及智能體轉接

多步驟智能體會保留原有結構。請參閱[智能體步驟](/yue/guides/agent-steps)，了解步驟及交接如何在通話中運作。

- **流程會轉為步驟。** Retell 多提示狀態及對話流程、Bland 路徑及 ElevenLabs 工作流程，會匯入為智能體的步驟。來源平台的全域提示會成為共用指示。
  - 每個節點的指示、固定台詞、要收集的資料及工具都會一併保留。
  - 以文字編寫的邊緣條件會轉為由智能體判斷的轉換條件。
    對已收集資料或 webhook 回應的單一比較
    （`age >= 18`）會轉為精確核對的轉換條件。
  - Webhook 及函式節點會在步驟開始時執行其工具。全域節點可從任何步驟到達；沒有自身後續路徑的節點，會將通話交回其原先中斷的步驟。
  - 轉接及結束節點會轉為最後步驟，用於轉接或結束通話。
    Retell 轉接節點會保留其備用路徑，以應對轉接未能接通的情況。
  - 如分支節點只用於選擇下一個步驟，在可行情況下會合併至前一個步驟。否則會保留為獨立步驟，並附上說明。
  - 如流程對步驟而言過於龐大，或 ThunderPhone 無法以步驟表示，便會匯入為單一提示，列出所有步驟並附上說明。
- **團隊、智能體轉接及智能體切換會轉為交接。** 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. 建立金鑰並選擇 **私人** —— 公開金鑰無法列出
       assistants。
    3. 將金鑰複製到對話框。Vapi 金鑰沒有範圍限制；如你只為此用途建立金鑰，請在匯入後於
       Vapi 刪除金鑰。

    | Vapi 欄位 | ThunderPhone |
    |---|---|
    | `model.messages[system]` | 提示詞 |
    | `firstMessage`, `firstMessageMode` | 提示詞中的開場白；由誰先說話 |
    | `voice.provider` + `voiceId` | 語音目錄中最接近的聲線，並盡力查找 Vapi 語音庫（顯示配對信心程度） |
    | `transcriber.language`, `languages`, keywords/keyterms | 語言及語音辨識詞彙 |
    | `model.model` | 未對應：匯入的智能體會以 Pro 智能及 Standard 聽覺開始 |
    | `model.tools`, `toolIds`, `toolRefs`（function, apiRequest） | API 連接；保留 Vapi 請求封套及助理層級的伺服器後備機制 |
    | `transferCall` 目的地 | 提示詞中的電話轉駁；SIP、助理及動態目的地會列出供檢閱 |
    | `handoff` 工具 | 轉交至同一次匯入中具名的助理 |
    | `endCall`, `dtmf` | 內置功能 |
    | Google Calendar, Google Sheets, `sms` | 會列出所需的 ThunderPhone 整合或 SMS 設定 |
    | 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`（網址、文件、文字來源） | 附有文件的知識庫 |
    | `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`、Agent Workflow 節點及已排序的分支條件 | 共用指示及每個工作流程節點一個步驟；工具節點會在步驟開始時執行其工具；運算式分支會標示供審核 |
    | `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` 網址／文字／檔案／資料夾項目，包括工作流程步驟知識 | 知識庫文件；資料夾會展開，並按 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 |
    |---|---|
    | 網頁智能體 `prompt`、`first_sentence`、`language`、`model`、`voice`、`pathway_id` | 提示詞；開場白；語言；等級；最接近的語音；已附加的已發佈路徑流程 |
    | 人設正式版本 | 個性及編排提示詞；語音；語言；由來電者先說話的設定；錄音；最長通話時間；預設工具及知識庫。包括單一路徑流程；多路徑路由會標示為需手動設定 |
    | 自訂及路徑工具（url、method、schema、headers、body variables） | API 連接。Bland Secret 參照會被標示，必須重新加入 |
    | Cal.com、HubSpot、Salesforce、Google Calendar 及 Google Sheets 工具 | 會列出對應的 ThunderPhone 整合功能，供你連接及啟用 |
    | Slack 工具 | 標示為未匯入：ThunderPhone 尚未能連接 Slack |
    | 入線號碼詳細資料（`prompt`、`pathway_id`／版本、工具、轉接、關鍵字、請求資料） | 每個入線號碼對應一個智能體，並附有通話變數預設值及轉接規則 |
    | 每個路徑流程，不論是否附加至號碼 | 如有可用版本則使用已發佈版本；未發佈草稿會清楚標示 |
    | 全域提示詞；Default、Knowledge Base、Transfer Call、End Call、Webhook 及 Wait for Response 節點；邊緣、迴圈條件、全域節點、擷取變數、固定語句 | 共用指示及每個節點對應一個步驟，包括可隨時執行的步驟、要收集的值、精確語句、webhook 步驟、轉接及掛線。會精確檢查回應欄位或擷取變數上的 webhook 回應路徑 |
    | 內嵌知識文字及可解析的知識 ID | 知識文件。無法讀取文字或檔案的項目會標示為需手動上載 |
    | `max_duration`、`wait_for_greeting`、錄音設定 | 通話時限、說話次序、錄音設定 |
    | `webhook`、動態資料查詢、多路徑人設路由、不支援的節點設定、v2 智能體 | 標示所需的手動後續操作 |
    | 入線號碼 | 由於 Bland 不會說明由其或你的 Twilio 帳戶擁有號碼，因此會一併列出兩種可能性 |
  </Tab>
</Tabs>

## 需要額外處理的項目

審核頁面底部的報告會列出未有遷移的電話號碼、Webhook 及
工具；每個智能體的註記則涵蓋其餘項目。兩者合起來會顯示所有未有遷移的項目及原因：

- **電話號碼。** 匯入後，每個來源號碼都會顯示其所在位置，以及你可以對它採取的操作：
  - **在你自己的 Twilio 或 Telnyx 帳戶內**（例如你已連接至 Vapi 或 ElevenLabs 的
    Twilio 號碼）：管理員可以將其遷移至已匯入的智能體。如該帳戶尚未有
    [VoIP 連線](/yue/guides/bring-your-own-numbers)，請先建立連線。在任何變更進行前，確認步驟
    會說明撥打該號碼的來電將不再轉接至舊平台。
    ThunderPhone 隨後會在你的電訊營辦商帳戶中將該號碼設定為轉駁至自身（Twilio
    號碼會加入 ThunderPhone 的 SIP 中繼；Telnyx 號碼會遷移至 ThunderPhone 的 SIP 連線），並撥出短暫測試通話以啟用它。
    如要還原，請在 **電話號碼** 刪除該號碼，同時將其保留於你的
    電訊營辦商帳戶，然後在舊平台再次匯入。
  - **在你的 SIP 中繼上**：將中繼連接為
    [SIP 連線](/yue/guides/voip-providers)，然後在
    **電話號碼** 匯入該號碼。
  - **由平台出售**（於 Vapi、Retell 及 Bland 購買的號碼）：
    ThunderPhone 無法遷移此類號碼。請將其攜號轉台至電訊營辦商後匯入，或取得一個
    ThunderPhone 號碼並將其連接至已匯入的智能體。
  - Bland 不會說明號碼是其自有號碼還是來自你的 Twilio
    帳戶，因此 Bland 號碼會顯示兩個選項。
- **每個智能體的 Webhook。** ThunderPhone 會為每個組織傳送已簽署的
  Webhook；請在 [Webhook](/yue/webhooks/overview) 下設定一個。
- **供應商儲存的憑證。** 系統會複製可見的工具標頭。
  舊平台按 ID 儲存的憑證會被標記；請將它們新增至 API
  連線的標頭。
- **內置整合。** 由舊平台託管的日曆、CRM 及訊息工具（例如 Cal.com
  預約）會列出應改為連接的 ThunderPhone 整合；其憑證不會一併遷移。審核亦會標記
  仍然指示智能體使用未有匯入工具的提示詞。
- **短訊。** ThunderPhone 智能體會透過你自己的電訊營辦商連線傳送短訊；請在智能體設定中設定 SMS。
- **沒有對應項目的工具**（平台專用自動化）會列出，
  確保不會有任何項目被悄然遺漏。
- **通話變數。** 系統會保留 `{{name}}` 佔位符，並沿用
  你平台原有的預設值。ThunderPhone 會從
  [通話開始時傳遞的變數](/yue/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 已停用 Workflow，因此請先將 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` 回應或流程物件。
  每個貼上的物件均會匯入為獨立智能體，即使兩者共用同一 id；需要 API 存取權的
  工具及知識 id 會列出供手動設定，而不會被捨棄。

任何只透過 ID 引用但未包含在貼上內容中的項目，都會列於備註中。

## 匯入後

1. 開啟每個智能體並閱讀其備註。
2. 在建構工具中撥打測試電話。
3. 轉移你的號碼，或新增一個號碼（請參閱上方的 **電話號碼**）。
4. 使用請求測試工具測試每個 API 連線。
5. 確認知識文件已完成建立索引。
6. 如舊有智能體使用了組織 Webhook，請設定組織 Webhook。

匯入工具亦可透過 [REST API](/api-reference/agent-imports) 使用。

匯入不會將你綁定於平台。你可隨時免費將任何智能體匯出為開放檔案：請參閱 [離開 ThunderPhone](/yue/guides/leaving-thunderphone)。
