網路工具
網頁搜尋、抓取頁面、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 秒 |