HTTP 工具¶
提供一個通用的 HTTPS 請求工具，由 Agent 在執行時自行決定網址、方法與內容。較有彈性，適合多變的呼叫。若你要的是把單一固定端點包成工具、只讓 Agent 填參數，請改用 API 工具。
這項偏技術
本頁牽涉端點、HTTP 方法、請求內容、HTTP 標頭等技術概念。這些值通常由工程／IT 同事提供，若你不確定要填什麼、從哪裡拿，建議直接請他們協助，照著給的值填即可。
開始前
若呼叫需要共用的認證標頭，建議先建立一個 HTTP 類型的連結器資源，由它集中提供標頭；見 連結器資源。也可不用連結器，由 Agent 自行帶上完整網址與標頭。
「描述」決定 Agent 會不會用對工具
Agent 是靠每個工具的「描述」（Description）判斷何時、該不該用它。描述寫得越清楚具體，Agent 越能在對的時機正確使用；寫得太籠統，可能該用時沒用、或用錯場合。建議寫明這個工具用來呼叫什麼、什麼情況下該用。
欄位說明¶
通用 HTTPS 請求工具，網址與方法由 Agent 執行時自行決定。
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| 名稱（Name） | 是 | （無） | 工具識別名稱，同一 Agent 內不可重複。 |
| 描述（Description） | 是 | （無） | 說明這個工具的用途與使用時機。 |
| 連結器（Connector） | 否 | （無） | 選一個 HTTP 類型的連結器，提供套用到每次請求的認證標頭。 |
| 逾時（Timeout） | 否 | 30 | 單次請求最長等待秒數，範圍 1–120。 |
進階設定（點「進階設定」展開才看得到）：
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| 顯示名稱（Display Name） | 否 | （無） | 介面上顯示的標籤。 |
| HTTP 標頭（HTTP Header） | 否 | （無） | 預設 HTTP 標頭（會疊加在連結器標頭之上）。 |
| 標籤（Tags） | 否 | （無） | 自訂分類標記。 |
API 還是 HTTP？
端點固定、只想讓 Agent 填參數 → 用 API 工具；網址／方法會變、要 Agent 彈性決定 → 用 HTTP。
實際效果¶
設定好之後，Agent 會在執行時自行決定要呼叫的網址、方法與內容。下圖是使用者請 Agent 查詢一個公開 API 的資料，Agent 自己組出請求並送出：
可展開的卡片會顯示 Agent 這次自行決定的網址（URL）、方法（Method）與標頭（Headers），接著用回傳的內容作答。和 API 工具的差別在於：這裡的網址與方法不是預先固定，而是 Agent 視情況臨機決定，彈性較高。