> ## Documentation Index > Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt > Use this file to discover all available pages before exploring further. # 核心概念 > 平台中所有項目的地圖——各個物件的用途、在控制台中的位置，以及與其互動的 API。 ThunderPhone 是用於建立、執行及改善人工智慧語音智慧體的完整平台。本頁是導覽地圖：你將遇到的每個概念各有一個簡短章節，並說明控制台介面及其背後支援的 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)。 *** ## 智慧體 **智慧體**是執行通話的人工智慧設定。它整合了： * 用於規範智慧體說什麼及如何行為的**提示**—— 包括轉接、按鍵及掛斷等通話動作；這些都是一般提示文字，而非獨立設定。 * **引擎層級**（`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 號碼池配置的真實美國號碼，幾秒內即可啟用。僅限來電，接聽時會播放簡短的語音 免責聲明，且控制台將每個組織限制為最多 10 個。非常適合首次測試；不適合正式環境。 * **VoIP 號碼**——透過你自己的供應商和 [VoIP 連線](#connections)導入。Twilio 和 Telnyx 可直接連線 （Telnyx 提供引導式設定）；SignalWire 和 Vonage 即將推出—— 目前你可透過手動 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 指令後，AI 精靈會草擬工具定義；你也可以手動建立。**測試請求**按鈕會在你部署前發出沙箱呼叫。請參閱 [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`）。你最多有 10 秒可回應；若逾時，系統會由靜態指派的智慧體處理通話。 * **非阻塞事件**為即發即忘的通知，並會以指數退避方式重試——請參閱[傳送語意](/zh-Hant/webhooks/overview)。 每個請求都會在 `X-ThunderPhone-Signature` 中附帶 HMAC-SHA256 簽章。請參閱[簽章驗證](/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 採用**預付制**。每個組織都有 USD 餘額；通話會依智慧體的每分鐘費率扣款（引擎級別加上附加費——當你變更設定時，建置器會即時顯示總費率，而[特定附加語言](/zh-Hant/guides/supported-languages)每分鐘另加 3¢）。當餘額歸零時，系統會拒絕接聽來電，撥出電話則會回傳 `402 Payment Required`。 你可以手動儲值，或啟用**自動儲值**，設定餘額門檻、儲值金額及選填的每月支出上限——確保通話不會在句子說到一半中斷。 **在控制台中：** **組織 → 帳務設定**與**帳務紀錄**。請參閱[儲值並啟用自動儲值](/zh-Hant/guides/billing-and-topups)，以及[完整定價參考](/zh-Hant/guides/pricing)。 **在 API 中：**[`/v1/billing`](/api-reference/billing)。 *** ## 應用程式內 AI 副駕 控制台內建 **AI 副駕**——向它詢問「我要如何 X」，它會根據這些文件提供答案、提供逐步操作導覽並突顯實際控制項，也可以重新播放任何引導導覽。這是尋找本頁提及控制項的最快方式。請參閱[詢問應用程式內 AI 副駕](/zh-Hant/guides/ask-the-copilot)。 *** ## 整合使用 五步驟精靈：智慧體 → 計費 → 號碼 → 模擬 → 檢視。 透過四次 REST 呼叫完成相同的首次通話。 建立智慧體、儲值、取得號碼、模擬並檢視通話。 OAuth 應用程式、自訂 API、MCP 伺服器與 VoIP 供應商。 報告、可觀測性、實驗、問題與警示。 邀請與角色、API 金鑰、安全性與 SSO。 API 範例：來電、撥出電話、動態設定、工具與測試。 一次正確完成 HMAC 檢查，並在各處重複使用。