ThunderPhone v3 現已上線。自助開通,價格低至每分鐘 2¢。查看公告

Connect tools & data

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

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

此面板亦會顯示回應的大小,包括字元數及約略 token 數量。你的智能體會在通話的每一輪重新讀取工具結果,因此超過 20,000 個字元的回應會顯示警告及精簡建議;超過 100,000 個字元的回應則會被標示,因為智能體只能看到其開頭。請參閱 工具回傳的資料過多。

標頭值為僅可寫入。儲存後會經加密處理,並不會再次於控制台或 API 中顯示。編輯連線時,已儲存的標頭會顯示其名稱,並以圓點代替值,同時附有 已儲存 提示:保留原狀即可沿用已儲存的值,或輸入新值以取代原有設定。測試請求及實時通話均會使用已儲存的值。複製 會將已儲存的值複製至新連線。

管理你的連線

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

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

附加至智能體

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

函式名稱只需在同一個智能體內保持唯一。兩個連線可以共用同一個名稱,例如兩個儲存到不同位置的智能體各自使用一個 save_information,但同一個智能體不能同時擁有兩者:若智能體有兩個同名工具,將無法儲存;同樣地,亦無法將連線重新命名為該智能體上另一個工具已使用的名稱。

後續步驟