--- title: "核心概念" description: "平台中所有項目的地圖——各個物件的用途、它在控制台中的位置，以及可與其互動的 API。" --- ThunderPhone 是一個用於建立、執行及改善 AI 語音智慧體的完整平台。本頁是導覽地圖：你將遇到的每個概念各有一個簡短章節，並附上對應的控制台介面與支援它的 API。先快速瀏覽一次，之後遇到需要釐清的術語時再回來查閱。 控制台側邊欄對應以下結構： [智慧體](#agents)、[語音](#voices)、[電話號碼](#phone-numbers)、 [網頁小工具](#web-widgets)、[通話](#calls)、 [客戶入口網站](#client-portals)、[知識庫](#knowledge-bases)。 [即時監控](#live-monitoring)及外撥 [行銷活動](#campaigns)。 你的智慧體可使用的 [應用程式、API、MCP 伺服器及 VoIP 供應商](#connections)。 [模擬](#simulations)、[驗證集](#validation-sets)、 [實驗](#experiments)、 [問題](#issues)、[報告](#reports)、 [可觀測性](#observability)。 [團隊與角色](#team-and-roles)、[API 金鑰](#organizations)、 [通知](#alerts)、[帳務](#billing)。 供你自有程式碼使用的 [Webhook](#webhooks) 與 [函式工具](#function-tools)。 --- ## 組織 **組織**是租戶單位。其他所有資源——智慧體、電話號碼、通話、金鑰——都只屬於一個組織。你的帳戶可以隸屬於多個組織；每個組織都有自己的餘額、金鑰及成員清單。 你在 **組織 → 金鑰** 下建立的 `sk_live_` API 金鑰會綁定至一個組織。這項綁定讓 REST API 如此簡潔：你無須在 URL 路徑中加入組織 ID，因為金鑰已能識別組織。 **控制台位置**：組織切換器（側邊欄頁尾）及 **組織**設定——包含「我的帳戶」、「一般」、「金鑰」、「通知」、 「帳務設定」及「帳務紀錄」分頁。請參閱 [組織設定參考](/zh-Hant/guides/organization-settings)。 **API 中**：[`/v1/orgs`](/api-reference/organizations)、 [`/v1/developer/api-keys`](/api-reference/developer-api-keys)。 --- ## 智慧體 **智慧體**是執行通話的 AI 設定，包含： - 一個**提示詞**，用於規範智慧體說什麼及如何行動—— 包括轉接、按鍵及掛斷等通話動作；這些都是一般提示詞內容，而非獨立設定。 - 一個**引擎層級**（`spark`、`bolt`、`storm-*`）：Spark 針對成本最佳化， Bolt 針對速度最佳化，Storm 則針對複雜提示詞的智慧表現最佳化。 - 一個**語音**，以及一個**主要語言**和可選的**其他語言**——當來電者切換語言時， 智慧體會自動切換。請參閱[支援的語言](/zh-Hant/guides/supported-languages)。 - 已附加的功能：[已連線應用程式](#connections)、 [API 連線](#connections)、[知識庫](#knowledge-bases)、 [MCP 伺服器](#connections)，以及內嵌的 [函式工具](#function-tools)。 - 行為調整選項：說話順序、確認模式、背景音軌、保留逾時。 在建立器中編輯時會**自動儲存為草稿**；只有在你點選 **部署** 後才會正式上線。每次部署都會儲存在建立器的 **歷程** 分頁中，因此你可以檢視及還原任何先前版本。 **控制台位置**：**語音智慧體** → 智慧體建立器 (`/dashboard/agents`)。請參閱 [建立第一個語音智慧體](/zh-Hant/guides/build-an-agent)。 **API 中**：[`/v1/agents`](/api-reference/agents)——CRUD、 複製、轉接、版本歷程及提示詞輔助工具。 --- ## 聲音 **聲音庫**包含智慧體可使用的聲音、可播放的樣本、相容的語言、性別與口音分類，以及任何進階聲音／語言附加費。你可透過付費試聽功能，在選擇前合成自訂的 1–500 個字元片語。 符合資格的組織也可透過簡短的 WAV 或 MP3 樣本建立**自訂聲音**。自訂聲音設有配額與非同步建立狀態；準備完成後，會與聲音庫中的聲音一同顯示於智慧體選擇器中。 **在控制台中：** **聲音**（`/dashboard/voices`）。請參閱 [聲音庫與自訂聲音](/zh-Hant/guides/voice-library)。 **在 API 中：** [`/v1/voices`](/api-reference/voices)、 [聲音樣本](/api-reference/voice-samples)，以及 [自訂聲音](/api-reference/custom-voices)。 --- ## 電話號碼 **電話號碼**隸屬於組織，並將撥入來電路由至智慧體（也可承載撥出通話）。來源有兩種： - **ThunderPhone 號碼** —— 從 ThunderPhone 的號碼池佈建的真實美國號碼，數秒內即可啟用，{/* rate:phone */}$1／月，另加每分鐘 1¢{/* /rate */}附加費。這些號碼一開始僅限接聽來電。組織管理員可從「電話號碼」頁面申請撥打外線；ThunderPhone 會人工審核每項申請，核准的號碼即可撥打電話及執行行銷活動。組織預設最多可持有 25 個號碼。 - **VoIP 號碼** —— 透過你的供應商提供的 [VoIP 連線](#connections) 匯入。Twilio 和 Telnyx 可使用 API 金鑰直接連線（Telnyx 也提供引導式新帳戶設定）；SignalWire、Vonage、Plivo 與其他任何 SIP 中繼則透過 SIP 設定連線，這是一種手動 SIP 設定。完成匯入與驗證後，VoIP 號碼支援接聽來電與撥打外線。 每個號碼列都可讓你設定路由模式、選擇撥入智慧體，以及為號碼加上標籤。 **在控制台中：** **電話號碼**（`/dashboard/phone-numbers`）。 請參閱[取得電話號碼](/zh-Hant/guides/get-a-phone-number)。 **在 API 中：** [`/v1/phone-numbers`](/api-reference/phone-numbers)、 [`/v1/voip-connections`](/api-reference/voip-connections)、 [`/v1/phone-number-labels`](/api-reference/phone-number-labels)。 --- ## 通話 每一通撥入通話、撥出通話、模擬與小工具工作階段 都會成為一筆**通話紀錄**。通話包含完整且標註角色的逐字稿、 結構化的回合歷程（包括工具呼叫）、錄音、 計費總額，以及可選用的 AI 評分與問題報告。 通話處於**進行中**狀態時，你可以開啟並**旁聽**——你會以靜音方式加入， 通話中的任何人都不會聽見你。開始旁聽後，你可以 **悄聲指示**：在通話途中輸入直接傳送給智慧體的指令； 來電者不會聽見，智慧體會即時遵循指令。 **在控制台中：** **通話紀錄**（`/dashboard/call-history`）可查看 封存資料與每通通話的詳細資訊；**進行中**可查看正在通話的項目。請參閱 [檢閱、旁聽及指導你的通話](/zh-Hant/guides/review-calls)。 **在 API 中：** [`/v1/calls`](/api-reference/calls)——清單、逐字稿、 歷程、音訊、評分、匯出； [`/v1/issue-reports`](/api-reference/issue-reports)。 --- ## 客戶入口網站 **客戶入口網站**是供外部客戶使用、帶有品牌識別的唯讀通話紀錄檢視頁面。 組織管理員可選擇要顯示通話的智慧體、新增已核准的檢視者電子郵件地址、 上傳標誌與強調色，並可選擇驗證自訂網域。入口網站檢視者無須取得控制台存取權， 即可查看通話詳細資料、逐字稿與可用的錄音。 **在控制台中：** **客戶入口網站**（`/dashboard/client-portals`）。請參閱 [客戶入口網站](/zh-Hant/guides/client-portals)。 **在 API 中：** [`/v1/client-portals`](/api-reference/client-portals)可用於 管理員管理操作。 ## 網頁小工具 **網頁小工具**讓你的網站訪客透過麥克風與智慧體交談——不需要電話號碼。它使用**可公開金鑰**（`pk_live_...`）進行驗證，瀏覽器只能從你允許的網域使用此金鑰，因此可安全用於用戶端程式碼。網域清單並非驗證機制，而頁面可傳送的工作階段設定會保持關閉，直到你在金鑰上允許它們。 金鑰可使用以下兩種模式之一：`agent`（靜態綁定至單一智慧體）或 `webhook`（你的伺服器依訪客選擇設定——請參閱[每通電話的動態設定](/zh-Hant/guides/dynamic-call-config)）。小工具工作階段會使用與電話通話相同的通話基礎架構。 **在控制台中：** **網頁小工具**（`/dashboard/web-widgets`）——建立小工具、設定模式與智慧體、管理允許的網域，並複製嵌入程式碼片段。請參閱 [建立網頁小工具](/zh-Hant/guides/embed-a-web-widget-dashboard)。 **在 API 中：** [`/v1/publishable-key`](/api-reference/publishable-keys)、 [`/v1/mic-session`](/api-reference/mic-sessions)，以及 [Widget SDK 文件](/zh-Hant/widget/overview)。 --- ## 知識庫 **知識庫**是一組可供你的智慧體在通話期間搜尋的文件，讓回答有所依據——上傳檔案、貼上文字，或透過 URL 匯入網頁，接著在建置器中將知識庫附加至智慧體。當對話需要時，智慧體會透過內建搜尋工具查詢知識庫。 **在控制台中：** 用於文件庫的**知識**（`/dashboard/knowledge`）；以及建置器中的**知識**區段，可將知識庫附加至智慧體。請參閱 [為你的智慧體建立知識庫](/zh-Hant/guides/knowledge-base)。 --- ## 連線 連線讓智慧體能與外部世界互動。四種類型，位於同一個側邊欄群組： - **應用程式**（`/dashboard/app-connections`）——與 Slack、HubSpot、Salesforce、Google Calendar、Google Sheets 和 Cal.com 的 OAuth 連線。連線一次後，即可將每項操作工具（傳送 Slack 訊息、更新或建立 HubSpot 聯絡人、預約 Cal.com 時段……）切換啟用於 任一智慧體。請參閱[連接應用程式](/zh-Hant/guides/connect-apps)。 - **API**（`/dashboard/api-connections`）——將任何 HTTP API 轉換為 智慧體動作。貼上 cURL 指令，人工智慧精靈便會草擬工具定義；你也可以手動建立。**測試請求**按鈕會在你正式發布前發出沙盒呼叫。請參閱 [API 連線](/zh-Hant/guides/api-connections)——這是 [`/v1/integrations`](/api-reference/integrations) 的控制台介面。 - **MCP**（`/dashboard/mcp-connections`）——透過 URL 新增 Model Context Protocol 伺服器，讓智慧體使用其提供的工具。 請參閱[新增 MCP 伺服器](/zh-Hant/guides/mcp-servers)。 - **VoIP**（`/dashboard/voip-connections`）——用於 [自備電話號碼](#phone-numbers)的供應商憑證。請參閱 [連接 VoIP 供應商](/zh-Hant/guides/voip-providers)。 ThunderPhone 也提供自身的 MCP 端點，讓外部 MCP 用戶端能夠列出智慧體、檢視通話與逐字稿，以及撥打電話。請參閱 [將 ThunderPhone 作為 MCP 伺服器使用](/zh-Hant/guides/thunderphone-mcp-server)。 **在 API 中：** [`/v1/integrations`](/api-reference/integrations)、 [`/v1/mcp-servers`](/api-reference/mcp-servers)，以及 [`/v1/voip-connections`](/api-reference/voip-connections)；另請參閱 [建立工具整合](/zh-Hant/guides/build-tool-integration)。 --- ## 行銷活動 **行銷活動**可大規模撥打外撥電話：上傳聯絡人 CSV、選擇智慧體與撥出號碼，並設定撥打時段（日期與時數，支援時區）、併發數與重試政策（最大嘗試次數，以及哪些結果——未接聽、語音信箱、失敗——需要重試）。行銷活動會依序處理名單，並在通話紀錄中記錄每一通電話。 **在控制台中：** **行銷活動**（`/dashboard/campaigns`）。請參閱 [執行外撥電話行銷活動](/zh-Hant/guides/outbound-campaigns)。 **如需一次性的程式化通話：** 使用 [外撥電話 API](/zh-Hant/guides/place-outbound-calls)。 ## 即時監控 **即時**會顯示整個組織中所有進行中的通話，並讓你開啟其中任何一通，以便[即時旁聽及耳語](#calls)。這是監督介面：觀察新提示詞首次接收實際流量，或持續留意正在執行的行銷活動。 **在控制台中：** **即時**（`/dashboard/live`）。請參閱[觀看及監督即時通話](/zh-Hant/guides/monitor-live-calls)。 --- ## 模擬 **模擬**是由 AI 來電者與你的智慧體進行真實對話——使用相同的電話路徑、真實逐字稿及真實評分——讓你能在發布前及發布後進行測試。將其指向智慧體或電話號碼，自行撰寫來電者情境，或根據智慧體的提示詞使用 **AI 產生情境**（若你提出要求，亦包含邊緣案例），並即時觀看通話。 情境會分組為 **套件**，用以設定最低通過率，並可在 CI 中作為發布閘門；系統會依情境回報相對於已接受基準的回歸問題。 **在控制台中：** **模擬**（`/dashboard/simulations`），以及智慧體建置工具中的 **模擬**按鈕。請參閱[模擬通話](/zh-Hant/guides/simulate-a-call)。 **在 API 中：** [`/v1/test-calls`](/api-reference/test-calls) 及套件執行器——請參閱[端對端測試智慧體](/zh-Hant/guides/test-agents)。 --- ## 驗證集 **驗證集**可將真實通話中的片段轉換為可重複執行的單輪回歸檢查。每個範例會固定對話脈絡、相關的來電者音訊、原始回應及預期行為。系統會針對目前的智慧體草稿執行重播，而不會再次撥打電話；部署對話方塊可顯示最新執行結果是否仍符合該草稿。 **在控制台中：** 用於組織資料集的 **驗證集**（`/dashboard/validation`），以及用於查看執行結果的智慧體建置工具 **驗證**分頁。請參閱[驗證集](/zh-Hant/guides/validation-sets)。 **在 API 中：** [`/v1/validation-sets`](/api-reference/validation-sets)，以及同一參考頁面上的智慧體／範例重播端點。 --- ## 實驗 **實驗**會在實際流量上對智慧體設定進行 A/B 測試：定義變體（不同的提示詞、引擎或設定）、在變體之間分配流量，並比較各變體的結果。使用此功能，不必在 webhook 中手動建立分桶邏輯。 **在控制台中：** **實驗**（`/dashboard/experiments`），以及智慧體建置工具中的 **A/B**分頁。請參閱[實驗（A/B 測試）](/zh-Hant/guides/experiments-ab-testing)。 --- ## 問題 **問題**是針對特定通話標記的異常——可由人工審查者提交，或由 AI 評分偵測。問題包含嚴重性、來源及狀態，而問題頁面則是分類處理佇列：篩選、檢查有問題的通話，並追蹤修正進度。 **在控制台中：** **問題**（`/dashboard/issues`），以及通話紀錄中的單通通話標記功能。請參閱[問題分類處理](/zh-Hant/guides/issues)。 **在 API 中：** [`/v1/issue-reports`](/api-reference/issue-reports)。 --- ## 報告 **報告**會針對你的通話資料回答自然語言問題（「上週來電者要求轉由真人處理的前三大原因是什麼？」），並提供由 AI 撰寫的分析，其範圍可限定為你選擇的智慧體及日期區間。 **在控制台中：** **報告**（`/dashboard/reports`）。請參閱[報告](/zh-Hant/guides/reports)。 --- ## 可觀測性 **可觀測性**是指標介面：可依智慧體及時間範圍篩選通話量、結果及品質的時間趨勢，並可匯出供後續分析。 **在控制台中：** **可觀測性**（`/dashboard/observability`）。請參閱[可觀測性](/zh-Hant/guides/observability)。 --- ## 警示 **警示規則**會在一段時間範圍內監控指標（成功率、失敗率、平均分數、通話量、套件回歸問題），並在其跨越你設定的閾值時觸發。通知會傳送至電子郵件及 Slack，並向你的[webhook 端點](/zh-Hant/webhooks/endpoints)觸發 `alert.triggered` 事件。 **在控制台中：** **組織 → 警示**。請參閱[警示](/zh-Hant/guides/alerts)。 --- ## Webhook ThunderPhone 會在通話期間及通話結束後發生事件時，向你的伺服器傳送 **HTTP POST Webhook**。提供兩種傳送模式： - **Webhook 端點**（建議使用）：在 [`/v1/developer/webhook-endpoints`](/zh-Hant/webhooks/endpoints) 管理多個 URL，並為每個端點設定各自的密鑰與事件訂閱。 - **舊版單一 URL Webhook**：每個組織一個 URL。可在 [`/v1/webhook`](/api-reference/organizations#legacy-single-url-webhook) 或 **組織 → 一般** 中管理。保留此功能以維持向下相容性。 事件分為兩類： - **阻塞事件**預期你的伺服器回應會影響進行中通話的設定——亦即 [來電事件](/zh-Hant/webhooks/call-incoming) （`telephony.incoming` / `web.incoming`）。電話通話最多等待 13 秒，包含一次重試；小工具工作階段則等待 10 秒。 沒有備援智慧體：若沒有可用的設定，電話通話將會結束，小工具工作階段將會失敗。 - **非阻塞事件**是即發即忘的通知，會以指數退避方式重試——請參閱 [傳送語意](/zh-Hant/webhooks/overview)。 每個請求都會在 `X-ThunderPhone-Signature-V2` 中附帶含時間戳記的 HMAC-SHA256 簽章，以及僅涵蓋本文內容的舊版 `X-ThunderPhone-Signature`。請參閱 [簽章驗證](/zh-Hant/webhooks/overview)。 --- ## 函式工具 **函式工具**是你的智慧體可在對話途中呼叫的 HTTP 端點。你向 ThunderPhone 提供 OpenAI 風格的函式結構描述與端點 URL；智慧體會決定何時呼叫，ThunderPhone 則會從其伺服器發出已簽署的 HTTP 請求，並將結果交還給智慧體。 智慧體也提供**內建通話功能**——轉接通話、傳送按鍵（DTMF）輸入、結束通話及保留等候——你只需透過簡單的提示詞行啟用，無須定義工具。 **在控制台中**：建置工具的 **API 連線**區段（請參閱[連線](#connections)）。 **在 API 中**：[`/v1/integrations`](/api-reference/integrations) 與[函式工具規格](/zh-Hant/tools/overview)。 --- ## 團隊與角色 每個組織都有成員清單，並提供兩種角色：**成員**可建置及操作智慧體；**管理員**還可管理團隊與帳務。可透過電子郵件邀請成員——邀請會在 7 天後到期，也可撤銷；成員列上的 ⋯ 選單可變更角色或移除成員。可為整個組織設定單一登入——請參閱 [SSO](/zh-Hant/guides/sso)。 **在控制台中**：**組織 → 一般**。請參閱[邀請你的團隊](/zh-Hant/guides/invite-your-team)。 **在 API 中**：[`/v1/members`](/api-reference/members)、[`/v1/invites`](/api-reference/invites)。 --- ## 帳務 ThunderPhone 採用**預付制**。每個組織都有美元餘額；通話會依智慧體的每分鐘費率扣款（引擎層級加上附加費——建置工具會在你變更設定時即時顯示總費率，而[特定支援語言](/zh-Hant/guides/supported-languages)會加收 {/* rate:language */}3¢/分鐘{/* /rate */}）。餘額歸零時，系統會拒絕來電，撥出電話則會回傳 `402 Payment Required`。 你可以手動儲值，或啟用**自動儲值**並設定餘額門檻、儲值金額及選填的每月支出上限——讓通話不會在話說到一半時中斷。 **在控制台中**：**組織 → 帳務設定**與**帳務紀錄**。請參閱[儲值並開啟自動儲值](/zh-Hant/guides/billing-and-topups)，以及[完整定價參考](/zh-Hant/guides/pricing)。 **在 API 中**：[`/v1/billing`](/api-reference/billing)。 --- ## 應用程式內智慧副手 控制台內建 **智慧副手**——向它詢問「如何執行 X」，它會根據這些文件回答、提供逐步點擊導覽以標示實際控制項，並可重新播放任何引導式導覽。這是找到本頁提及控制項最快的方式。請參閱[詢問應用程式內智慧副手](/zh-Hant/guides/ask-the-copilot)。 --- ## 整合應用 五步驟精靈：智慧體 → 帳務 → 號碼 → 模擬 → 檢視。 透過四次 REST 呼叫完成相同的首次通話。 建立智慧體、儲值、取得號碼、模擬並檢視通話。 OAuth 應用程式、自訂 API、MCP 伺服器與 VoIP 供應商。 報表、可觀測性、實驗、問題與警示。 邀請與角色、API 金鑰、安全性與 SSO。 API 範例：來電、撥出、動態設定、工具與測試。 一次正確完成 HMAC 檢查，隨處重複使用。