API 連接

將任何 HTTP API 轉換為智能體可在對話期間呼叫的功能：貼上 cURL 指令，精靈便會建立工具定義、參數及驗證設定。

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 顯示相同定義，方便直接貼上或微調 工具規格。

測試請求 面板（選用）讓你可在儲存前發出已設定的請求， 並顯示狀態、延遲時間和回應預覽。 驗證並儲存 一律會執行此測試，並只會在成功時儲存。

管理你的連線#

每個連線列會顯示其驗證狀態——已驗證、 未測試 或 錯誤——其函式名稱，以及哪些智能體正在使用它。 你可從該列的操作選單：

• 編輯——重新開啟設定。
• 複製——複製為起點（副本初始狀態為 未測試）。
• 修訂記錄——查看較早版本，並將其中一個還原至 編輯器。
• 轉移——將連線複製或移動至你所屬的另一個組織。 移動後會從此處移除；使用該連線的智能體可能需要重新設定。
• 刪除——永久刪除；使用該連線的智能體將需要 重新設定。

附加至智能體#

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

後續步驟#