從其他平台匯入智能體
使用 API 金鑰或 JSON 匯出檔，從 Vapi、Retell、ElevenLabs Agents 或 Bland 匯入智能體、工具及知識庫，檢視對應關係後完成匯入。
如果你的智能體位於 Vapi、Retell、ElevenLabs Agents 或 Bland，匯入工具會擷取它們，將每個欄位對應至 ThunderPhone，並在建立任何內容前向你顯示結果。
開始匯入
- 開啟 智能體 並選擇 匯入（或在空白智能體頁面選擇 從 Vapi、Retell、ElevenLabs 或 Bland 匯入）。
- 選擇平台。
- 按照對話框中的編號步驟，在該平台建立金鑰（系統會為你開啟相應的設定頁面）並貼上；或者切換至 貼上匯出的 JSON，並從該平台的控制台或 API 貼上一個或多個智能體物件。
- 選擇 擷取我的智能體。擷取及對應通常不足一分鐘；你可以離開頁面，稍後透過工作匣返回查看。
檢閱方案
每個智能體均會顯示名稱、已配對的語音（包括配對的信心程度）、智能等級、所附帶的工具及知識庫，以及轉換過程中任何變更的備註。展開列即可閱讀提示詞：
- 已重寫 —— 依照提示詞撰寫指南風格整合而成的一個連貫提示詞，並保留來源中的所有電話號碼、URL、工具名稱及佔位符。
- 結構化 —— 按標題排列的原始設定，內容與擷取結果完全一致。當無法驗證重寫內容時，系統會自動使用此選項。
取消勾選你不需要的智能體（測試副本預設為未勾選），編輯名稱、語音、等級或提示詞選項，然後選擇 匯入。建立完成的智能體會在建構器中開啟，並附帶其 API 連接及知識庫。
匯入內容
取得金鑰
- 開啟 dashboard.vapi.ai/org/api-keys （組織設定 → API 金鑰）。
- 建立金鑰並選擇 私人 —— 公開金鑰無法列出 assistants。
- 將金鑰複製到對話框。Vapi 金鑰沒有範圍限制；如你只為此用途建立金鑰，請在匯入後於 Vapi 刪除金鑰。
| Vapi 欄位 | ThunderPhone |
|---|---|
model.messages[system] | 提示詞 |
firstMessage, firstMessageMode | 提示詞中的開場白；首先發言者 |
voice.provider + voiceId | 最接近的目錄語音（顯示配對信心度） |
transcriber.language | 主要語言 |
model.model | 智能等級 |
model.tools / toolIds (function, apiRequest) | API 連接 |
transferCall destinations | 提示詞中的轉接部分（內置轉接） |
endCall, dtmf | 內置功能 |
query tools (knowledgeBases[].fileIds) and legacy knowledgeBaseId | 知識庫，並將已上載檔案作為文件 |
endCallMessage, endCallPhrases, voicemailMessage, messagePlan.idleMessages | 提示詞部分；留言訊息設定 |
silenceTimeoutSeconds | 靜音掛線 |
maxDurationSeconds, server.url, squads, workflows, sms/ghl/make/code/mcp tools | 已報告，未匯入 |
取得金鑰
- 開啟 dashboard.retellai.com/apiKeys （系統設定 → API 金鑰），並選擇 建立金鑰。
- 啟用 限制權限，並將 智能體、知識庫 及 電話 設為 讀取。其餘群組全部不要勾選；匯入工具不會向 Retell 寫入資料。
- 將金鑰複製到對話框。
| Retell 欄位 | ThunderPhone |
|---|---|
Retell LLM general_prompt, begin_message, start_speaker | 提示詞；開場白；首先發言者 |
states + starting_state | 提示詞中的有序通話程序 |
Conversation flow global_prompt + nodes | 有序通話程序；轉接節點亦會成為轉接規則 |
general_tools custom | API 連接 |
transfer_call, end_call, press_digit | 提示詞轉接 + 內置功能 |
voice_id (11labs-, openai-, cartesia-, …) | 最接近的目錄語音 |
language | 主要及附加語言 |
model / s2s_model | 智能等級 |
knowledge_base_ids (url, document, text sources) | 包含文件的知識庫 |
voicemail_option, end_call_after_silence_ms, boosted_keywords | 留言設定；靜音掛線；提示詞詞彙 |
webhook_url, max_call_duration_ms (when below the 60-minute default), custom-LLM engines, send_sms, MCP | 已報告，未匯入 |
取得金鑰
- 開啟 elevenlabs.io/app/settings/api-keys 並選擇 建立 API 金鑰。
- 在權限下，授予 智能體平台：讀取 （如顯示，亦授予 知識庫：讀取）；匯入工具無需其他權限。
- 將金鑰複製到對話框。
| ElevenLabs 欄位 | ThunderPhone |
|---|---|
conversation_config.agent.prompt.prompt | 提示詞 |
first_message, language | 開場白；主要語言 |
prompt.llm | 智能等級 |
tts.voice_id | 最接近的目錄語音 |
tools / tool_ids of type webhook | API 連接（查詢或正文結構） |
system tools end_call, transfer_to_number, keypad | 內置功能 + 提示詞轉接 |
knowledge_base url/text/file entries | 知識庫：URL 項目會成為 URL 文件；文字及檔案項目會按 id 擷取，並以其提取文字匯入 |
turn.silence_end_call_timeout | 靜音掛線 |
conversation.max_duration_seconds, client tools, MCP | 已報告，未匯入 |
取得金鑰
- 開啟 app.bland.ai/dashboard/settings。
- 複製該處顯示的 API 金鑰（Bland 每個帳戶只有一組金鑰；金鑰沒有範圍限制，如有需要可於其後輪換）。
- 將金鑰貼到對話框。
網頁智能體在 Bland 沒有名稱，因此匯入工具會根據 問候語（「Hi, this is Nova…」）或提示詞（「You are Nova…」）為其命名。
| Bland 欄位 | ThunderPhone |
|---|---|
Web agent prompt, first_sentence, language, model, voice | 提示詞；開場白；語言；等級；最接近的語音 |
Custom tools (name, url, method, input_schema, headers) | API 連接 |
Inbound number prompt or pathway_id | 每個來電號碼一個智能體 |
| Every pathway, attached to a number or not | 每個流程一個智能體 |
| Pathway nodes and edges (Default, Knowledge Base, Transfer Call, End Call, Webhook) | 有序通話程序；知識庫節點文字會成為文件；轉接及 Webhook 會成為內置功能及 API 連接 |
transfer_phone_number | 轉接部分 |
max_duration, webhook | 已報告，未匯入 |
| Bland-owned numbers | 已報告為不可攜帶 |
需要額外處理的項目
審閱頁面底部的報告會列出所有未能匯入的項目及原因：
- 電話號碼。 你向電訊商持有的號碼可作為VoIP 號碼連接。平台持有的號碼無法轉移；請取得新號碼並連接至已匯入的智能體。
- 每個智能體的 webhook。 ThunderPhone 會按機構傳送已簽署的 webhook；請在 Webhooks 下設定。
- 供應商儲存的憑證。 系統會複製可見的工具標頭。舊平台以 ID 儲存的憑證會被標記；請將其加入 API 連線的標頭。
- 沒有對應項目的工具（SMS 傳送、平台專用自動化）會列出，確保沒有任何項目在未通知下遺漏。
- 通話時長上限。 ThunderPhone 沒有每個智能體的最長通話時間；請改用靜默掛線設定及提示詞的結束規則。
不使用金鑰匯入
選擇 貼上匯出的 JSON，然後貼上你的平台 API 或控制台匯出的物件，可貼上一個物件或 JSON 清單：
- Vapi —— 助理物件（
GET /assistant/{id}）。透過toolIds連接的工具及知識檔案需要金鑰才能解析。 - Retell —— 智能體物件（
GET /get-agent/{id}）連同其 Retell LLM（GET /get-retell-llm/{id}）或同一清單內的對話流程物件；匯入工具會按 ID 將其連結。單獨貼上的 LLM 或流程會以系統產生的名稱匯入。 - ElevenLabs —— 智能體物件（
GET /v1/convai/agents/{id}）；其 webhook 工具會內嵌包含，因此不會有未解析的項目。 - Bland —— 網頁智能體、
/v1/agents回應，或路徑物件。
任何只透過 ID 引用但未包含在貼上內容中的項目，都會列於備註中。
匯入後
- 開啟每個智能體並閱讀其備註。
- 從建立工具撥打測試電話。
- 連接電話號碼。
- 使用請求測試工具測試每個 API 連線。
- 確認知識文件已完成索引。
- 如舊有智能體使用了 webhook，請設定機構 webhook。
匯入工具亦可透過 REST API 使用。