Skip to main content
API 連線是你的智慧體可在對話期間呼叫的自訂 HTTP 函式——查詢訂單、建立服務單，或從你自己的後端擷取帳戶狀態。你只需在 連線 → API（/dashboard/api-connections）下方定義一次端點；已附加此連線的智慧體即可在對話需要時呼叫它。 建立 API 連線有兩種方式：貼上可供精靈分析的內容，或手動設定連線。

​
快速方式：貼上並分析

1

點擊「新增 API 連線」

對話方塊會開啟精靈。將範例 cURL 指令、 OpenAPI/Swagger 規格、Postman 匯出檔、TypeScript 介面或 Zod 結構描述貼到方塊中。
2

點擊「分析」

ThunderPhone 會從你貼上的內容推斷整個連線設定——URL、 方法、標頭，以及根據找到的查詢參數和請求主體產生的參數結構描述。你貼上的標頭（包括 驗證標頭）會帶入端點設定。
3

確認醒目標示的欄位

推斷出的設定會開啟，並以醒目方式標示猜測的欄位供你檢查。調整名稱、說明和參數類型，讓 智慧體了解何時及如何呼叫函式——模型會讀取這些說明。
4

驗證並儲存

儲存前會先對你的端點執行即時測試請求。如果請求失敗，連線不會儲存——請修正 URL、驗證 標頭或主體後再試一次。成功後，連線會以 已驗證 標記儲存。
如果精靈無法在你貼上的內容中找到請求 URL，會通知你——請加入完整的 http(s) 端點後再試一次。

​
手動設定

在精靈中點擊 手動設定 →（或點擊 想讓 AI 推斷設定？ 試用精靈 → 返回）。手動建構工具提供兩個編輯器：
  • 視覺化——用於設定顯示名稱、函式名稱、請求 URL、方法（POST、GET、PUT、PATCH、DELETE）、自訂 標頭和參數結構描述的表單欄位（為智慧體可提供的每個引數點擊 新增屬性）。
  • JSON——以原始 JSON 顯示相同定義，可直接貼上或微調工具規格。
測試請求面板（選用）可讓你在儲存前發送已設定的請求，並顯示狀態、延遲和回應預覽。 驗證並儲存一律會執行此測試，且僅在成功時儲存。
為參數提供淺顯易懂的說明（「客戶電子郵件地址，例如 jane@example.com」）。智慧體會在通話進行中即時根據這些說明選擇引數。

​
管理你的連線

每個連線列會顯示其驗證狀態——已驗證、 未測試或錯誤——函式名稱，以及使用它的智慧體。你可以從該列的操作選單：
  • 編輯——重新開啟設定。
  • 複製——建立副本作為起點（副本初始狀態為未測試）。
  • 修訂紀錄——檢視較早版本，並將其中一個還原至編輯器。
  • 轉移——將連線複製或移動至你所屬的另一個組織。移動會從此處移除連線；使用它的智慧體可能需要重新設定。
  • 刪除——永久刪除；使用此連線的智慧體將需要重新設定。

​
將它附加至智慧體

在建構工具的 API 連線區段中，將連線新增至智慧體 （建立智慧體）。清單會顯示哪些智慧體使用各個連線，讓你一眼掌握變更會影響什麼。

​
後續步驟

透過 API 整合工具

以程式化方式建立及管理相同的連線。

連接應用程式

預先建置的 Google、Slack、HubSpot、Salesforce 與 Cal.com 連線。

新增 MCP 伺服器

將完整的工具伺服器提供給你的智慧體使用。

整合 API 參考資料

整合資源中的每個欄位。