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 中。編輯連線時，已儲存的標頭會顯示其名稱，並以圓點取代值，同時標示 已儲存： 保持原樣即可保留已儲存的值，或輸入新值加以取代。測試請求與實際通話會使用已儲存的值。複製會將已儲存的值複製到新的連線。

管理你的連線#

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

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

將它附加至智慧體#

在建立工具的 API 連線區段中，將連線新增至智慧體 （建立智慧體）。清單會顯示哪些智慧體使用各連線，讓你一眼即可瞭解變更會影響哪些項目。

後續步驟#