# 網路工具

網頁搜尋、抓取頁面、HTTP 請求與下載的工具。

| 工具 | 併發 | 說明 |
|---|---|---|
| `search_web` | ✓ | 即時網路查詢，同時回傳 DuckDuckGo 結果與 Google News 標題，格式為 `{"web":[...],"news":[...]}`。`source` 可選 `all` / `web` / `news`；`time_range` 對兩個來源套用回溯區間（新聞上限 7 天）；`edition` 設定新聞地區（`TW:zh-Hant`、`US:en`）；`cdp=true` 強制以瀏覽器擷取（HTTP 202 時自動啟用）；另有旗標可跳過結果快取。上限 90 秒 |
| `fetch_page` | ✓ | 擷取單一網頁並以 `markdown`、`html` 或 `json` 回傳（readability + 透過 ToriiDB 的 4xx/5xx skip cache）。預設帶上持久 Chrome profile 的 cookie，需登入的站台可透明存取；優先嘗試 headless，失敗才改用可見視窗重試。`save=true` 改為寫入本地檔案而非回傳內容；另有同網域連結選項支援遞迴文件研究。上限 90 秒 |
| `http_request` | ✓ | 原始 HTTP 請求（GET/POST/PUT/DELETE/PATCH），回傳 status + headers + body。`content_type` 可選 `json` / `form` / `multipart`；multipart 接受 `{"fields":{...},"files":[{"name","path","content_type"}]}`，路徑須為絕對路徑並以二進位讀入。timeout 上限 300 秒。內建 SSRF 防護（DNS 解析後比對 loopback / private / link-local），特定主機可透過 `net_white_list` 放行。會重複呼叫的端點應以 `edit_tool` 建成 `api_*` 工具 |
| `download_file` | ✓ | 下載二進位檔案到本地（tar.gz、圖片、壓縮檔、安裝檔）。絕對 `path` 直接使用，相對路徑併入 `~/.config/agenvoy/download/`，父目錄自動建立。timeout 上限 600 秒。JSON/HTML 請改用 `http_request` 或 `fetch_page(save=true)` |
| `html_template` | ✓ | v1.0.17 新增。來自 `https://view.agenvoy.com` 的 HTML 頁面範例庫：`mode=list` 回傳每個範本的 `name`、`category`、`title`、`desc`；`mode=read` 依 `name` 回傳單一範本的完整 HTML。在 `reasoning_guide(topics=["html_render"])` 之後建構 HTML 產出時使用，完成後以 `write_result(format="html")` 存檔。取代過去以 `http_request` / `fetch_page` 讀取同一範例庫的做法。其他網頁 → `fetch_page`。上限 30 秒 |