--- title: "API 連接" description: "將任何 HTTP API 轉換為智能體可在對話期間呼叫的功能：貼上 cURL 指令，精靈便會建立工具定義、參數及驗證設定。" --- API 連線是你的智能體可在對話期間呼叫的自訂 HTTP 函式——查詢訂單、建立服務單、從你的後端擷取帳戶狀態。你只需在 **連線 → API**（`/dashboard/api-connections`）下定義一次端點；已附加該連線的智能體便可在對話有需要時呼叫它。建立 API 連線有兩種方式：貼上可供精靈分析的內容，或手動設定連線。 ## 快速方式：貼上並分析對話框會開啟精靈。將範例 **cURL 指令**、 **OpenAPI/Swagger 規格**、**Postman 匯出檔**、**TypeScript 介面**或 **Zod 結構描述**貼到方框中。 ThunderPhone 會根據你貼上的內容推斷整個連線設定——URL、方法、標頭，以及根據找到的查詢參數和請求主體建立的參數結構描述。你貼上的標頭（包括驗證標頭）會帶入端點設定。推斷出的設定會開啟，並標示估計的欄位供你檢閱。調整名稱、描述和參數類型，讓智能體理解應在何時及如何呼叫該函式——描述是模型會讀取的內容。儲存前會先向你的端點執行即時測試請求。如果請求失敗，連線不會儲存——修正 URL、驗證標頭或主體後再試。成功後，連線會以 **已驗證** 標籤儲存。如果精靈無法在你貼上的內容中找到請求 URL，便會提示你——請加入完整的 `http(s)` 端點後再試。 ## 手動設定在精靈中按一下 **手動設定 →**（或按一下 **想讓 AI 推斷設定？試用精靈 →** 返回）。手動建立工具提供兩個編輯器： - **視覺化**——顯示名稱、函式名稱、請求 **URL**、**方法**（`POST`、`GET`、`PUT`、`PATCH`、`DELETE`）、自訂 **標頭**及參數結構描述的表單欄位（智能體可提供的每個引數均可按 **新增屬性**）。 - **JSON**——以原始 JSON 顯示相同定義，方便直接貼上或微調工具規格。 **測試請求** 面板（選用）讓你可在儲存前發出已設定的請求，並顯示狀態、延遲時間和回應預覽。 **驗證並儲存** 一律會執行此測試，並只會在成功時儲存。為參數提供清晰易明的描述（「客戶電郵地址，例如 jane@example.com」）。智能體會在通話期間即時根據這些描述選擇引數。 ## 管理你的連線每個連線列會顯示其驗證狀態——**已驗證**、 **未測試** 或 **錯誤**——其函式名稱，以及哪些智能體正在使用它。你可從該列的操作選單： - **編輯**——重新開啟設定。 - **複製**——複製為起點（副本初始狀態為未測試）。 - **修訂記錄**——查看較早版本，並將其中一個還原至編輯器。 - **轉移**——將連線複製或移動至你所屬的另一個組織。移動後會從此處移除；使用該連線的智能體可能需要重新設定。 - **刪除**——永久刪除；使用該連線的智能體將需要重新設定。 ## 附加至智能體在建立工具的 API 連線部分，將連線加入智能體（[建立智能體](/yue/guides/build-an-agent)）。清單會顯示每個連線由哪些智能體使用，讓你一眼掌握變更會影響甚麼。 ## 後續步驟以程式方式建立及管理相同的連線。預先建立的 Google、Slack、HubSpot、Salesforce 及 Cal.com 連線。向你的智能體開放整個工具伺服器。整合資源的每個欄位。