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