> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.
# API 連線
> 將任何 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](mailto:jane@example.com)」）。智慧體會在通話進行中即時根據這些說明選擇引數。
## 管理你的連線
每個連線列會顯示其驗證狀態——**已驗證**、
**未測試**或**錯誤**——函式名稱，以及使用它的智慧體。你可以從該列的操作選單：
* **編輯**——重新開啟設定。
* **複製**——建立副本作為起點（副本初始狀態為未測試）。
* **修訂紀錄**——檢視較早版本，並將其中一個還原至編輯器。
* **轉移**——將連線複製或移動至你所屬的另一個組織。移動會從此處移除連線；使用它的智慧體可能需要重新設定。
* **刪除**——永久刪除；使用此連線的智慧體將需要重新設定。
## 將它附加至智慧體
在建構工具的 API 連線區段中，將連線新增至智慧體
（[建立智慧體](/zh-Hant/guides/build-an-agent)）。清單會顯示哪些智慧體使用各個連線，讓你一眼掌握變更會影響什麼。
## 後續步驟
以程式化方式建立及管理相同的連線。
預先建置的 Google、Slack、HubSpot、Salesforce 與 Cal.com 連線。
將完整的工具伺服器提供給你的智慧體使用。
整合資源中的每個欄位。