API 連接

API 連接是你的智能體可在對話期間呼叫的自訂 HTTP 函式——查詢訂單、建立支援單,或從你自己的後端擷取帳戶狀態。你只需在 連接 → API/dashboard/api-connections)下定義一次端點;已附加該連接的智能體便可在對話需要時呼叫它。

建立 API 連接有兩種方式:貼上可供精靈分析的內容,或手動設定連接。

快速方式:貼上並分析

  1. 按一下新增 API 連接

    對話方塊會開啟設定精靈。在方塊中貼上範例 cURL 指令OpenAPI/Swagger 規格Postman 匯出檔TypeScript 介面Zod schema

  2. 按一下分析

    ThunderPhone 會根據你貼上的內容推斷整個連接設定——URL、 方法、標頭,以及根據所找到的查詢參數和請求主體建立的參數 schema。你貼上的標頭(包括驗證標頭)會一併帶入端點設定。

  3. 確認標示的欄位

    推斷出的設定會開啟,並標示預測欄位供你檢視。調整名稱、說明及 參數類型,讓智能體了解何時及如何呼叫函式——模型會讀取這些說明。

  4. 驗證並儲存

    儲存前會先向你的端點執行即時測試請求。如請求失敗,連接不會儲存—— 請修正 URL、驗證標頭或請求主體後再試。成功後,連接會以 已驗證 標籤儲存。

如設定精靈無法在你貼上的內容中找到請求 URL,便會提示你——請加入完整的 http(s) 端點後再試。

手動設定

在設定精靈中按一下 手動設定 →(或按一下 想讓 AI 推斷設定? 嘗試使用精靈 → 返回)。手動建立工具提供兩個編輯器:

測試請求 面板(選用)讓你可在儲存前發送已設定的請求,並顯示狀態、 延遲及回應預覽。驗證並儲存 必定會執行此測試,並只會在成功後儲存。

管理你的連接

每個連接列都會顯示其驗證狀態——已驗證未測試錯誤——函式名稱,以及正在使用它的智能體。你可從該列的操作選單:

將它附加至智能體

在建立工具的 API 連接部分,將連接加入智能體 (建立智能體)。清單會顯示每個連接由哪些智能體使用,讓你一眼掌握變更會影響甚麼。

下一步