HTTP 工具¶

提供一個通用的 HTTPS 請求工具，由 Agent 在執行時自行決定網址、方法與內容。較有彈性，適合多變的呼叫。若你要的是把單一固定端點包成工具、只讓 Agent 填參數，請改用 API 工具。

這項偏技術

本頁牽涉端點、HTTP 方法、請求內容、HTTP 標頭等技術概念。這些值通常由工程／IT 同事提供，若你不確定要填什麼、從哪裡拿，建議直接請他們協助，照著給的值填即可。

開始前

若呼叫需要認證或共用基底網址，建議先建立一個 Connector（連結器）資源，由它提供認證標頭；見 Connector 資源。也可不用 Connector，由 Agent 自行帶上完整網址與標頭。

「描述」決定 Agent 會不會用對工具

Agent 是靠每個工具的「描述」（Description）判斷何時、該不該用它。描述寫得越清楚具體，Agent 越能在對的時機正確使用；寫得太籠統，可能該用時沒用、或用錯場合。建議寫明這個工具用來呼叫什麼、什麼情況下該用。

欄位說明¶

通用 HTTPS 請求工具，網址與方法由 Agent 執行時自行決定。

新增 HTTP 工具的設定面板，包含名稱、描述、連結器、逾時、HTTP 標頭等欄位

欄位	必填	預設	說明
名稱（Name）	是	（無）	工具識別名稱，同一 Agent 內不可重複。
描述（Description）	是	（無）	說明這個工具的用途與使用時機。
連結器（Connector）	否	（無）	選一個 API 類型的 Connector，提供套用到每次請求的認證標頭。
逾時（Timeout）	否	30	單次請求最長等待秒數，範圍 1–120。

進階設定（點「進階設定」展開才看得到）：

欄位	必填	預設	說明
顯示名稱（Display Name）	否	（無）	介面上顯示的標籤。
HTTP 標頭（HTTP Header）	否	（無）	預設 HTTP 標頭（會疊加在 Connector 標頭之上）。
標籤（Tags）	否	（無）	自訂分類標記。

API 還是 HTTP？

端點固定、只想讓 Agent 填參數 → 用 API 工具；網址／方法會變、要 Agent 彈性決定 → 用 HTTP。

設定好之後，Agent 會在執行時自行決定要呼叫的網址、方法與內容。下圖是使用者請 Agent 查詢一個公開 API 的資料，Agent 自己組出請求並送出：

Agent 對話畫面：用 HTTP 工具對指定網址送出 GET 請求（含 URL、Method、Headers），再依回傳的 JSON 整理出專案描述與 Star 數

可展開的卡片會顯示 Agent 這次自行決定的網址（URL）、方法（Method）與標頭（Headers），接著用回傳的內容作答。和 API 工具的差別在於：這裡的網址與方法不是預先固定，而是 Agent 視情況臨機決定，彈性較高。