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 的整數。清空後離開欄位會自動填回預設值 30。 |
進階設定（點「進階設定」展開才看得到）：
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| 顯示名稱（Display Name） | 否 | （無） | 介面上顯示的標籤。 |
| HTTP 標頭（HTTP Header） | 否 | （無） | 預設 HTTP 標頭（會疊加在連結器標頭之上）。 |
| 標籤（Tags） | 否 | （無） | 自訂分類標記。 |
API 還是 HTTP？
端點固定、只想讓 Agent 填參數 → 用 API 工具；網址／方法會變、要 Agent 彈性決定 → 用 HTTP。
實際效果¶
設定好之後，Agent 會在執行時自行決定要呼叫的網址、方法與內容。下圖是使用者請 Agent 查詢一個公開 API 的資料，Agent 自己組出請求並送出：
對話裡那張卡片的標題不一定等於「名稱」欄填的字——平台會把名稱改寫過再顯示（例如 http_request 顯示成 HttpRequest，查GitHub專案 只剩 GitHub），中文常常整段被吃掉。辨識工具請看卡片內容而非標題，詳見工具總覽 › 對話裡的卡片標題。可展開的卡片會顯示 Agent 這次自行決定的網址（URL）、方法（Method）與標頭（Headers）（內容較長時卡片內可上下捲動）。下方的「接收 …的查詢結果」卡片保持收合，點一下標題即可展開，看到 API 原始回傳的內容；接著 Agent 用回傳的內容作答。和 API 工具的差別在於：這裡的網址與方法不是預先固定，而是 Agent 視情況臨機決定，彈性較高。