API 連接
API 連接是你的智能體可在對話期間呼叫的自訂 HTTP 函式——查詢訂單、建立支援單,或從你自己的後端擷取帳戶狀態。你只需在 連接 → API(/dashboard/api-connections)下定義一次端點;已附加該連接的智能體便可在對話需要時呼叫它。
建立 API 連接有兩種方式:貼上可供精靈分析的內容,或手動設定連接。
快速方式:貼上並分析
- 按一下新增 API 連接
對話方塊會開啟設定精靈。在方塊中貼上範例 cURL 指令、 OpenAPI/Swagger 規格、Postman 匯出檔、TypeScript 介面或 Zod schema。
- 按一下分析
ThunderPhone 會根據你貼上的內容推斷整個連接設定——URL、 方法、標頭,以及根據所找到的查詢參數和請求主體建立的參數 schema。你貼上的標頭(包括驗證標頭)會一併帶入端點設定。
- 確認標示的欄位
推斷出的設定會開啟,並標示預測欄位供你檢視。調整名稱、說明及 參數類型,讓智能體了解何時及如何呼叫函式——模型會讀取這些說明。
- 驗證並儲存
儲存前會先向你的端點執行即時測試請求。如請求失敗,連接不會儲存—— 請修正 URL、驗證標頭或請求主體後再試。成功後,連接會以 已驗證 標籤儲存。
如設定精靈無法在你貼上的內容中找到請求 URL,便會提示你——請加入完整的 http(s) 端點後再試。
手動設定
在設定精靈中按一下 手動設定 →(或按一下 想讓 AI 推斷設定? 嘗試使用精靈 → 返回)。手動建立工具提供兩個編輯器:
- 視覺化 —— 用於設定顯示名稱、函式名稱、請求
URL、方法(
POST、GET、PUT、PATCH、DELETE)、自訂 標頭及參數 schema 的表單欄位(智能體可提供的每個引數均可按一下 新增屬性)。 - JSON —— 以原始 JSON 顯示相同定義,可直接貼上或微調工具規格。
測試請求 面板(選用)讓你可在儲存前發送已設定的請求,並顯示狀態、 延遲及回應預覽。驗證並儲存 必定會執行此測試,並只會在成功後儲存。
管理你的連接
每個連接列都會顯示其驗證狀態——已驗證、 未測試 或 錯誤——函式名稱,以及正在使用它的智能體。你可從該列的操作選單:
- 編輯 —— 重新開啟設定。
- 複製 —— 複製為新的起點(複本初始狀態為未測試)。
- 修訂記錄 —— 檢視較早版本,並將其中一個還原至編輯器。
- 轉移 —— 將連接複製或移至你所屬的另一個機構。移動後會從此處移除;使用該連接的智能體可能需要重新設定。
- 刪除 —— 永久刪除;使用該連接的智能體需要重新設定。
將它附加至智能體
在建立工具的 API 連接部分,將連接加入智能體 (建立智能體)。清單會顯示每個連接由哪些智能體使用,讓你一眼掌握變更會影響甚麼。