Open in
從其他平台匯入智能體
使用 API 金鑰或 JSON 匯出檔,從 Vapi、Retell、ElevenLabs Agents 或 Bland 匯入智能體、工具及知識庫,檢視對應關係後完成匯入。
如果你的智能體位於 Vapi、Retell、ElevenLabs Agents 或 Bland,匯入工具會擷取它們,將每個欄位對應至 ThunderPhone,並在建立任何內容前向你顯示結果。
開始匯入
- 開啟 智能體 並選擇 匯入(或在空白智能體頁面選擇 從 Vapi、Retell、ElevenLabs 或 Bland 匯入)。
- 選擇平台。
- 按照對話框中的編號步驟,在該平台建立金鑰(系統會為你開啟相應的設定頁面)並貼上;或者切換至 貼上匯出的 JSON,並從該平台的控制台或 API 貼上一個或多個智能體物件。
- 選擇 擷取我的智能體。擷取及對應通常不足一分鐘;你可以離開頁面,稍後透過工作匣返回查看。
檢閱方案
每個智能體均會顯示名稱、配對的語音(包括配對信心程度)、 隨附的工具和知識庫,以及翻譯期間任何變更的備註。展開某一列以閱讀提示:
- 已重寫 —— 一個連貫的提示詞,採用提示詞撰寫指南的風格,並保留來源中的每個電話號碼、URL、工具名稱及佔位符。
- 結構化 —— 完全按照擷取結果,將原始設定排列於各標題之下。當無法驗證重寫內容,或重寫後的內容遠比來源短時,系統會自動使用此選項。
從流程匯入的智能體會顯示 共用指示 而非提示詞,然後列出其步驟:每個步驟的名稱、向智能體說明的操作,以及下一步的去向。顯示為單一提示詞 會將同一智能體顯示為單一提示詞,亦即在無法使用步驟的情況下實際執行的內容。設有轉接的智能體會列出可將來電者轉接至哪些智能體;如取消勾選其中一個,檢閱頁面會顯示該轉接不會被設定。
除空白智能體及平台為你建立的預設入門智能體外,所有智能體一開始均已選取。取消勾選你不需要的智能體,編輯名稱、語音、層級或提示詞選項,然後按 匯入。建立的智能體會在建構工具中開啟,並附帶其 API 連接及知識庫。
流程、團隊及智能體轉接
多步驟智能體會保留原有結構。請參閱智能體步驟,了解步驟及交接如何在通話中運作。
- 流程會轉為步驟。 Retell 多提示狀態及對話流程、Bland 路徑及 ElevenLabs 工作流程,會匯入為智能體的步驟。來源平台的全域提示會成為共用指示。
- 每個節點的指示、固定台詞、要收集的資料及工具都會一併保留。
- 以文字編寫的邊緣條件會轉為由智能體判斷的轉換條件。
對已收集資料或 webhook 回應的單一比較
(
age >= 18)會轉為精確核對的轉換條件。 - Webhook 及函式節點會在步驟開始時執行其工具。全域節點可從任何步驟到達;沒有自身後續路徑的節點,會將通話交回其原先中斷的步驟。
- 轉接及結束節點會轉為最後步驟,用於轉接或結束通話。 Retell 轉接節點會保留其備用路徑,以應對轉接未能接通的情況。
- 如分支節點只用於選擇下一個步驟,在可行情況下會合併至前一個步驟。否則會保留為獨立步驟,並附上說明。
- 如流程對步驟而言過於龐大,或 ThunderPhone 無法以步驟表示,便會匯入為單一提示,列出所有步驟並附上說明。
- 團隊、智能體轉接及智能體切換會轉為交接。 Vapi Squad 的每位成員都會匯入為獨立智能體,並按該成員及 Squad 命名。首位成員會接聽 Squad 的來電,其他成員則透過交接聯絡。ElevenLabs 轉接至另一個智能體,以及 Retell 智能體切換,亦會轉為交接。來電者會維持在線,並保留至今的對話內容。
- 透過交接接通的通話,會保留最初接聽智能體的通話設定:語音信箱、通話限制、語言及錄音。接手的智能體則會使用其本身的提示、步驟、工具及語音。
- 交接只可指向同一次匯入中已匯入的智能體。如另一個智能體不在匯入項目中,或你取消勾選該智能體,說明會指出此情況,而你可稍後在智能體設定中新增交接。
匯入內容
取得金鑰
- 開啟 dashboard.vapi.ai/org/api-keys (組織設定 → API 金鑰)。
- 建立金鑰並選擇 私人 —— 公開金鑰無法列出 assistants。
- 將金鑰複製到對話框。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 的電話號碼 |
| 自訂知識/模型伺服器、合規方案、其他掛鈎、工作流程及不支援的託管工具 | 會列出具體的檢閱或重建操作;不會儲存原始方案及憑證 |
取得金鑰
- 開啟 dashboard.retellai.com/apiKeys (系統設定 → API 金鑰),並選擇 建立金鑰。
- 啟用 限制權限,並將 智能體、知識庫 及 電話 設為 讀取。其餘群組全部不要勾選;匯入工具不會向 Retell 寫入資料。
- 將金鑰複製到對話框。
| 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 引擎、不支援的流程節點及供應商專用設定 | 標示供手動審核,不會靜默略過 |
取得金鑰
- 開啟 elevenlabs.io/app/settings/api-keys 並選擇 建立 API 金鑰。
- 在權限下,授予 智能體平台:讀取 (如顯示,亦授予 知識庫:讀取);匯入工具無需其他權限。
- 將金鑰複製到對話框。
| 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 預約工具 | 連同匯入後所需操作一併標示 |
取得金鑰
- 開啟 app.bland.ai/dashboard/settings。
- 複製該處顯示的 API 金鑰(Bland 每個帳戶只有一組金鑰;金鑰沒有範圍限制,如有需要可於其後輪換)。
- 將金鑰貼到對話框。
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 帳戶擁有號碼,因此會一併列出兩種可能性 |
需要額外處理的項目
審核頁面底部的報告會列出未有遷移的電話號碼、Webhook 及 工具;每個智能體的註記則涵蓋其餘項目。兩者合起來會顯示所有未有遷移的項目及原因:
- 電話號碼。 匯入後,每個來源號碼都會顯示其所在位置,以及你可以對它採取的操作:
- 在你自己的 Twilio 或 Telnyx 帳戶內(例如你已連接至 Vapi 或 ElevenLabs 的 Twilio 號碼):管理員可以將其遷移至已匯入的智能體。如該帳戶尚未有 VoIP 連線,請先建立連線。在任何變更進行前,確認步驟 會說明撥打該號碼的來電將不再轉接至舊平台。 ThunderPhone 隨後會在你的電訊營辦商帳戶中將該號碼設定為轉駁至自身(Twilio 號碼會加入 ThunderPhone 的 SIP 中繼;Telnyx 號碼會遷移至 ThunderPhone 的 SIP 連線),並撥出短暫測試通話以啟用它。 如要還原,請在 電話號碼 刪除該號碼,同時將其保留於你的 電訊營辦商帳戶,然後在舊平台再次匯入。
- 在你的 SIP 中繼上:將中繼連接為 SIP 連線,然後在 電話號碼 匯入該號碼。
- 由平台出售(於 Vapi、Retell 及 Bland 購買的號碼): ThunderPhone 無法遷移此類號碼。請將其攜號轉台至電訊營辦商後匯入,或取得一個 ThunderPhone 號碼並將其連接至已匯入的智能體。
- Bland 不會說明號碼是其自有號碼還是來自你的 Twilio 帳戶,因此 Bland 號碼會顯示兩個選項。
- 每個智能體的 Webhook。 ThunderPhone 會為每個組織傳送已簽署的 Webhook;請在 Webhook 下設定一個。
- 供應商儲存的憑證。 系統會複製可見的工具標頭。 舊平台按 ID 儲存的憑證會被標記;請將它們新增至 API 連線的標頭。
- 內置整合。 由舊平台託管的日曆、CRM 及訊息工具(例如 Cal.com 預約)會列出應改為連接的 ThunderPhone 整合;其憑證不會一併遷移。審核亦會標記 仍然指示智能體使用未有匯入工具的提示詞。
- 短訊。 ThunderPhone 智能體會透過你自己的電訊營辦商連線傳送短訊;請在智能體設定中設定 SMS。
- 沒有對應項目的工具(平台專用自動化)會列出, 確保不會有任何項目被悄然遺漏。
- 通話變數。 系統會保留
{{name}}佔位符,並沿用 你平台原有的預設值。ThunderPhone 會從 通話開始時傳遞的變數 填入這些值, 否則會將其留空;審核會列出你需要傳遞的變數。 - 通話限制及錄音。 系統會匯入最長通話時間。當 來源智能體從未變更此設定時,會套用平台本身的預設值: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 引用但未包含在貼上內容中的項目,都會列於備註中。
匯入後
- 開啟每個智能體並閱讀其備註。
- 在建構工具中撥打測試電話。
- 轉移你的號碼,或新增一個號碼(請參閱上方的 電話號碼)。
- 使用請求測試工具測試每個 API 連線。
- 確認知識文件已完成建立索引。
- 如舊有智能體使用了組織 Webhook,請設定組織 Webhook。
匯入工具亦可透過 REST API 使用。
匯入不會將你綁定於平台。你可隨時免費將任何智能體匯出為開放檔案:請參閱 離開 ThunderPhone。