---
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-Hant/guides/prompting)的風格，並保留來源中的每個電話號碼、URL、工具名稱和預留位置。
- **與 Vapi 相同**，或你的平台名稱（舊版檢視中的 **結構化**）——依標題排列的來源設定，與擷取結果完全一致。當無法驗證重寫結果，或重寫後內容遠短於來源時，會自動使用此選項。

從流程匯入的智慧體會顯示 **共用指示** 而非提示詞，以及它保留了流程中的多少步驟。舊版檢視會列出每個步驟的名稱、它指示智慧體執行的工作，以及下一步前往的位置；**顯示為單一提示詞** 會將同一個智慧體顯示為單一提示詞，這也是在無法使用步驟的地方所執行的內容。
具有轉接功能的智慧體會列出它們將來電者轉接給哪些智慧體；若你取消勾選其中一個，檢視畫面會指出該轉接不會被設定。

除空白智慧體和平台為你建立的預設入門智慧體外，所有智慧體一開始都會被勾選。取消勾選你不需要的智慧體，編輯名稱、語音、設定或提示詞選項，然後按下 **匯入**。智慧體會連同其 API 連線和知識一併儲存；在將其指派給電話號碼前，先開啟智慧體檢查並測試通話。

## 流程、Squads 與智慧體轉接

多步驟智慧體會保留其結構。請參閱[智慧體步驟](/zh-Hant/guides/agent-steps)，了解步驟與交接如何在通話中運作。

- **流程會轉為步驟。** Retell 的多提示詞狀態與對話流程、Bland 路徑和 ElevenLabs 工作流程會匯入為智慧體的步驟。來源平台的全域提示詞會成為共享指示。
  - 每個節點的指示、固定話術、要收集的值與工具都會一併帶入。
  - 以文字撰寫的連線條件會成為由智慧體判斷的轉換。對收集值或 Webhook 回應的單一比較
    （`age >= 18`）會成為精確檢查的轉換。
  - Webhook 和函式節點會在步驟開始時執行其工具。可從任何步驟前往全域節點；若全域節點沒有自己的後續路徑，便會將通話交回它中斷的步驟。
  - 轉接和結束節點會成為用於轉接或結束通話的最終步驟。Retell 轉接節點會保留其後續路徑，以便在轉接未成功時使用。
  - 如果分支節點僅用於選擇下一個步驟，且可行時會與前一個步驟合併。否則會保留為獨立步驟，並加上附註。
  - 對於步驟過多，或 ThunderPhone 無法以步驟表示的流程，會匯入為一則列出所有步驟的提示詞，並加上附註。
- **Squads、智慧體轉接與智慧體切換會轉為交接。** 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`, 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`（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. 在權限下，授予 **Agents Platform：讀取**
       （如果顯示，也授予 **Knowledge base：讀取**）；匯入工具不需要其他權限。
    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` 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 |
    |---|---|
    | 網頁智慧體 `prompt`、`first_sentence`、`language`、`model`、`voice`、`pathway_id` | 提示詞；開場白；語言；等級；最接近的語音；已附加且已發布的路徑流程 |
    | Persona 正式環境版本 | 個性與協調提示詞；語音；語言；由來電者先說話設定；錄音；最長時長；預設工具與知識。一個已附加的路徑會一併匯入；多路徑路由會標示為需手動設定 |
    | 自訂與路徑工具（url、method、schema、headers、body variables） | API 連線。Bland Secret 參照會列出，且必須重新新增 |
    | Cal.com、HubSpot、Salesforce、Google Calendar 與 Google Sheets 工具 | 會標示對應的 ThunderPhone 整合功能，供你連線並啟用 |
    | Slack 工具 | 會標示為未匯入：ThunderPhone 尚無法連線至 Slack |
    | 撥入號碼詳細資料（`prompt`、`pathway_id` / version、tools、transfers、keywords、request data） | 每個撥入號碼各有一個智慧體，包含通話變數預設值與轉接規則 |
    | 每個路徑，無論是否附加至號碼 | 可用時匯入已發布版本；未發布的草稿會明確標示 |
    | 全域提示詞；預設、知識庫、轉接通話、結束通話、Webhook 與等待回應節點；邊、迴圈條件、全域節點、擷取的變數、靜態語音 | 共用指示與每個節點的一個步驟，包括可隨時執行的步驟、要收集的值、精確語音、Webhook 步驟、轉接與掛斷。會精確檢查以回應欄位或擷取變數為依據的 Webhook 回應路徑 |
    | 內嵌知識文字與可解析的知識 ID | 知識文件。無法讀取文字或檔案的項目會列出供手動上傳 |
    | `max_duration`、`wait_for_greeting`、錄音設定 | 通話限制、說話順序、錄音設定 |
    | `webhook`、動態資料查詢、多路徑 Persona 路由、不支援的節點設定、v2 智慧體 | 會列出所需的手動後續作業 |
    | 撥入號碼 | 會列出兩種選項，因為 Bland 不會說明號碼是歸 Bland 或你的 Twilio 帳戶所有 |
  </Tab>
</Tabs>

## 需要在 ThunderPhone 中處理的項目

審查頁面底部的報告會列出未移轉的號碼、webhook 和工具；每個智慧體的附註則涵蓋其餘項目。兩者合併後，會顯示所有未移轉的項目及其原因：

- **電話號碼。** 匯入後，每個原始號碼都會顯示其所在位置，以及你可以對它執行的操作：
  - **位於你自己的 Twilio 或 Telnyx 帳戶中**（例如你連接至 Vapi 或 ElevenLabs 的 Twilio 號碼）：管理員可以將其移至已匯入的智慧體。如果尚未有[VoIP 連線](/zh-Hant/guides/bring-your-own-numbers)使用該帳戶，請先建立連線。在變更任何設定前，確認步驟會說明撥打該號碼的來電將不再轉至舊平台。接著，ThunderPhone 會在你的電信業者帳戶中將該號碼指向自身（Twilio 號碼會加入 ThunderPhone 的 SIP 中繼；Telnyx 號碼會移至 ThunderPhone 的 SIP 連線），並撥打一通簡短的測試電話以啟用它。若要復原，請在 **電話與網路** 中刪除該號碼，同時將它保留在你的電信業者帳戶中，然後在舊平台重新匯入。
  - **位於你的 SIP 中繼上**：將該中繼連接為[SIP 連線](/zh-Hant/guides/voip-providers)，並在 **電話與網路** 中匯入該號碼。
  - **由平台販售**（在 Vapi、Retell 和 Bland 購買的號碼）：ThunderPhone 無法移轉該號碼。請將它攜碼移轉至電信業者後再匯入，或取得一個 ThunderPhone 號碼並將其附加至已匯入的智慧體。
  - Bland 不會說明號碼是其自有號碼還是來自你的 Twilio 帳戶，因此 Bland 號碼會顯示兩種選項。
- **每個智慧體的 Webhook。** ThunderPhone 會依組織傳送已簽署的 Webhook；請在[Webhook](/zh-Hant/webhooks/overview)下設定一個。
- **供應商儲存的憑證。** 系統會複製可見的工具標頭。舊平台以 ID 儲存的憑證會被標示；請將它們加入 API 連線的標頭。
- **內建整合。** 舊平台代管的行事曆、CRM 與訊息工具（例如 Cal.com 預約）會改為列出應連接的 ThunderPhone 整合；其憑證不會一併移轉。檢查也會標示提示詞中仍要求智慧體使用未匯入工具的情況。
- **簡訊。** ThunderPhone 智慧體會透過你自己的 Twilio 或 Telnyx 號碼傳送簡訊；請在智慧體設定中設定 SMS。
- **沒有對應項目的工具**（平台專屬自動化）會列出，確保不會有任何項目被悄悄略過。
- **通話變數。** 系統會保留 `{{name}}` 預留位置，並沿用你平台原有的預設值。ThunderPhone 會從[通話開始時傳入的變數](/zh-Hant/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` 回應，或路徑物件。
  每個貼上的物件都會匯入為各自的智慧體，即使兩個物件共用同一個 ID；
  需要 API 存取權的工具和知識 ID 會列出供手動設定，而不會略過。

僅以 id 參照且未包含在貼上內容中的任何項目，都會列在備註中。

## 匯入後

1. 開啟每個智慧體並閱讀其備註。
2. 在智慧體頁面點選 **測試通話**，或請 Zeus 進行測試。
3. 將你的號碼移轉過來，或新增一個號碼（請見上方的 **電話號碼**）。
4. 使用請求測試工具測試每個 API 連線。
5. 確認知識文件已完成索引。
6. 如果舊智慧體使用過組織 webhook，請設定組織 webhook。

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

匯入不會綁住你。你可隨時免費將任何智慧體匯出為開放檔案：請參閱 [離開 ThunderPhone](/zh-Hant/guides/leaving-thunderphone)。
