--- 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 顯示相同定義，可直接貼上或微調工具規格。 **測試請求**面板（選用）可讓你在儲存前發送已設定的請求，並顯示狀態、延遲和回應預覽。**驗證並儲存**一律會執行此測試，且只會在成功時儲存。標頭值僅可寫入。儲存後會加密，且不會再顯示於控制台或 API 中。編輯連線時，已儲存的標頭會顯示其名稱，並以圓點取代值，同時標示 **已儲存**：保持原樣即可保留已儲存的值，或輸入新值加以取代。測試請求與實際通話會使用已儲存的值。**複製**會將已儲存的值複製到新的連線。為參數提供清楚易懂的說明（「客戶電子郵件地址，例如 jane@example.com」）。智慧體會在通話進行中依據這些說明即時選擇引數。 ## 管理你的連線每個連線列會顯示其驗證狀態——**已驗證**、 **未測試**或**錯誤**——函式名稱，以及哪些智慧體正在使用它。你可以從該列的動作選單執行以下操作： - **編輯**——重新開啟設定。 - **複製**——複製為起始設定（副本初始狀態為未測試）。 - **修訂紀錄**——檢視較早版本，並將其中一個還原至編輯器。 - **轉移**——將連線複製或移動至你所屬的其他組織。移動後會從此處移除；使用該連線的智慧體可能需要重新設定。 - **刪除**——永久刪除；使用此連線的智慧體需要重新設定。 ## 將它附加至智慧體在建立工具的 API 連線區段中，將連線新增至智慧體（[建立智慧體](/zh-Hant/guides/build-an-agent)）。清單會顯示哪些智慧體使用各連線，讓你一眼即可瞭解變更會影響哪些項目。 ## 後續步驟以程式方式建立及管理相同的連線。預先建立的 Google、Slack、HubSpot、Salesforce 與 Cal.com 連線。將整個工具伺服器提供給你的智慧體使用。整合資源中的每個欄位。