網路工具
最後更新
網頁搜尋、抓取頁面、公開 API 查詢、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 時自動啟用);另有旗標可跳過結果快取。自 v1.3.1 起,設定 decision model 時會逐一判斷結果標題與當前需求是否相關,信心 0.7 以上判為不相關者移除;快取存的是未過濾的清單,因此命中快取時也會重新過濾。全部結果都不相關時,改回傳提示要求調整查詢。未設定 decision model 或判斷失敗時回傳全部結果。上限 90 秒 |
fetch_page | ✓ | 擷取單一網頁並以 markdown、html 或 json 回傳,以 output_type 選擇(預設 markdown;原 type 參數已更名為 output_type,移除於 v1.3.17)(readability + 透過 ToriiDB 的 4xx/5xx skip cache;v1.3.17 起錯誤頁依 HTTP 狀態碼與頁面標題判斷 —— 404 / 410 回 [Not found],其他 4xx/5xx 回 [Upstream] —— 最終 URL 內含 404 / 403 / 410 不再視為錯誤頁)。預設帶上持久 Chrome profile 的 cookie,需登入的站台可透明存取;優先嘗試 headless,失敗才改用可見視窗重試;headless: false 在有顯示器時直接開啟可見視窗(v1.1.4 前反而被強制為僅 headless)。scroll(v1.3.6 新增;0-20,預設 3,超過 20 會被夾到 20)決定捲動幾次以載入延遲內容,頁面不再變化就提早停止 —— 動態牆、時間軸與長留言串用 10-20,只要頁面頂端用 0。keep_links 保留同網域連結以支援遞迴文件研究;force 跳過 30 分鐘快取,並重試先前標記為失敗的 URL。save 與 save_to 參數已移除於 v1.3.6:把網頁存到本地改用 download_file(render=true)。自 v1.3.1 起工具要求 agent 抓某網站第一頁前先抓其 /llms.txt,若其中列出要找的頁面,就改抓列出的 .md URL。100 KiB 截斷與外層 Web page content: 字樣已移除於 v1.3.17:現在一次最多讀取 1 MiB,html 輸出超過 1 MiB 時回傳 [Limit] 錯誤,提示改用 output_type=markdown,或以 download_file(link, render=true) 存檔後用 read_files 分段讀取。設定 decision model 時,未帶 keep_links 且不超過 1 MiB 的 markdown 輸出會移除頁面雜訊(廣告、導覽選單、分享或訂閱提示、cookie 告示、頁尾、相關文章連結;表格不判斷),30 分鐘快取存的就是這份去雜訊後的原始內容。v1.3.17 起依當下請求的篩選改在回傳時進行,剛抓取與快取命中走同一套流程,同一份快取會依每次請求各自重新篩選:一次 decision 呼叫放得下(約 20,000 個 rune 扣掉請求長度)的 markdown 或 json 頁面整頁判斷,與請求無關時不交給模型,改回傳提示要求換來源;較長的頁面切成區塊(表格、不超過 1 MiB 頁面中的標題,以及帶 keep_links 時含連結的區塊一律保留),判定無關且信心值至少 0.7 的區塊會被刪除,markdown 輸出加上 [Filtered for the current request: kept N of M blocks; ...] 標頭(篩選後的 json tree 不帶標頭);沒有任何相關區塊時整頁不交給模型。超過 1 MiB 的頁面只取開頭 1 MiB,且只保留本身陳述答案、信心值至少 0.7 的區塊;一個都沒有時,提示會說明頁面超過 1 MiB 並指向 download_file(link, render=true)。判斷失敗時保留原內容,超過 1 MiB 的頁面則回傳開頭 1 MiB 並附同樣的指引。html 輸出不做篩選。實測結果見 fetch_page 篩選實測。上限 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 秒。GET 不需確認即執行;其他 method 一律經過確認 gate。內建 SSRF 防護(DNS 解析後比對 loopback / private / link-local),特定主機可透過 net_white_list 放行。自 v1.3.2 起,經 public_api_list 找到的公開 API 直接以它取得答案 —— 不建工具;使用者提供、需要金鑰的 API 則應建成 script_* 工具,由 script 以 get_key() 讀取金鑰,金鑰因此不會進入對話。原本「重複呼叫的端點建成 api_* 工具」的建議已隨 API 工具移除於 v1.3.2 |
public_api_list | ✓ | v1.3.2 起為內建工具(原為 API 工具 api_public_api_list)。公開 API 目錄:不帶 category 時回傳分類名稱;帶 category(不分大小寫,例如 Weather)時回傳該分類下每個 API 的名稱、說明、HTTPS 旗標與文件 URL。v1.3.8 起需求明確對應某分類時直接帶入該分類;分類不存在時回傳 [Not found] 並附完整分類清單;工具呼叫行顯示為 API(<category>)。目錄只收錄免金鑰的 API。用於沒有既有工具能處理的即時資料需求:選定 API → 以 fetch_page 讀其文件 → http_request;沒有合適的 API → reasoning_guide(topics=["tool_generate"])。上限 30 秒 |
download_file | ✓ | 把 URL 下載到本地:二進位檔案原樣存檔(tar.gz、圖片、壓縮檔、安裝檔),或自 v1.3.6 起以帶著使用者 Chrome 登入狀態的瀏覽器渲染網頁,存成 markdown、html 或 json。link 與 output_file 必填;絕對路徑的 output_file 直接使用,相對路徑併入輸出目錄(output_dir,否則 ~/Downloads,再否則 ~/.config/agenvoy/download/,不是工作目錄),父目錄自動建立,既有檔案會被覆寫。render(v1.3.6 新增,預設 false)切換到瀏覽器路徑;output_type(v1.3.6 新增:預設 markdown,另有 html、json)只在 render=true 時生效;url 與 type 參數已更名為 link 與 output_type(移除於 v1.3.17)。渲染存檔不經 decision model 篩選、不受 fetch_page 的 1 MiB 讀取上限限制,json 頁面存成純節點 tree,回傳 Downloaded <n> chars to <path>。timeout(預設 120 秒,上限 600 秒)只套用於一般下載,渲染網頁時改用瀏覽器擷取本身的時限。v1.3.17 起一般下載把回應串流寫入目標旁的暫存檔,完成後再改名就位,既有檔案只會被完整下載的結果取代;回傳 url、output_file、size_bytes,伺服器帶 X-Sha256 時另附 sha256;ok 與 status_code 欄位移除於 v1.3.17。非 2xx 回應回傳 [Upstream],附狀態碼與 body 前 4 KiB。只讀網頁不存檔 → fetch_page;JSON 或 API 回應 → http_request |
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(content=...) 存檔。取代過去以 http_request / fetch_page 讀取同一範例庫的做法。其他網頁 → fetch_page。上限 30 秒 |
v1.3.18 起,
fetch_page 遇到真人驗證時可詢問是否繼續。v1.3.19 起,download_file 設為 render=true 時也適用。同意後,請在五分鐘內於可見的瀏覽器視窗完成驗證。兩個工具共用同一工作階段的繼續或略過選擇;選擇自最後一次使用起保留 30 分鐘。關閉驗證視窗會取消操作並清除該選擇。非互動式執行、沒有顯示環境的 Linux,以及 WSL 都不會顯示提示。Agenvoy 使用 go-browser v0.3.8。run_websocket(v1.3.0 新增)已移除於 v1.3.2,沒有替代工具;單次請求 → http_request 或 fetch_page。