AgentQL怎麼用 AI網頁代理開發工具教程

AgentQL是一個AI網頁代理開發工具，用自然語言描述就能讓AI自動瀏覽網頁和提取資料。你可以先用瀏覽器除錯擴充套件試查詢，再透過Python或JavaScript SDK把查詢接入自動化程式；下面從安裝、寫查詢到檢查結果，按能直接上手的流程來做。

第一步：準備帳號和 API Key

開啟 AgentQL 官網，註冊開發者帳號並進入控制檯，建立或複製 API Key。先把金鑰放在本地，別貼進公開程式碼倉庫。新手建議先用瀏覽器擴充套件練習查詢，不必馬上搭完整專案；確認網頁能識別目標內容後，再進入 SDK 開發。AgentQL 的 Quick Start 指引要求先取得 API Key，才能執行查詢。

第二步：安裝瀏覽器除錯擴充套件

在 Chrome 網上應用店搜尋並安裝 AgentQL Debugger。安裝完成後開啟一張要測試的網頁，再按 Windows 或 Linux 的 Ctrl+Shift+I，或 Mac 的 Cmd+Option+I，開啟開發者工具。檢視頂部標籤欄並點選 AgentQL；如果標籤沒顯示，就點右側的雙箭頭選單，從隱藏專案裡選它。首次使用時按提示輸入 API Key。

第三步：寫出第一條自然語言查詢

在 AgentQL 面板的查詢框輸入大括號，再用容易看懂的名稱描述頁面元素，例如搜尋按鈕。點選 Fetch Web Elements，觀察返回結果；滑鼠懸停在結果上時，頁面會高亮對應位置。若一個頁面有多個同類元素，在名稱後加方括號表示要取列表。比如要找標題，可以寫 headings[]，先看是否覆蓋了預期內容。

第四步：提取結構化資料

要拿到商品資訊，可以在查詢中描述欄位和列表層級，例如產品列表、產品名稱及價格。寫好後點選 Fetch Data，面板會返回內容而不是頁面元素本身，適合檢查抓取結果。需要區分頁面裡的多個區域時，給欄位補充所在位置或用途，例如“文章裡的標題”，減少匹配到導航欄標題的情況。

第五步：處理頁面上的按鈕和輸入框

如果目標不只是讀資料，還要操作網頁，就在查詢裡描述按鈕、輸入框或彈窗的用途。比如先定位搜尋按鈕，再找彈窗中的搜尋框，填寫關鍵詞後讀取結果列表。偵錯程式適合邊寫邊看是否定位正確；如果點到相似按鈕，補充周圍文字、所在彈窗等上下文，再重新 Fetch Web Elements 驗證。

第六步：用 Python 接入專案

在專案目錄開啟終端，先安裝 SDK 並初始化：pip3 install agentql，接著執行 agentql init，按提示配置 API Key。建立 Python 指令碼後，用 Playwright 開啟目標網頁，再呼叫 AgentQL 查詢元素或資料。先在偵錯程式驗證同一條查詢，再放進指令碼，出錯時更容易判斷是查詢描述還是程式流程的問題。

第七步：執行並核對返回結果

儲存指令碼，在終端執行 python3 檔名.py。先拿一個頁面、少量欄位測試，逐項核對返回值是否對應頁面上實際顯示的內容；列表為空時，檢查網頁是否載入完成、目標是否在彈窗或分頁裡，再補充查詢上下文。確認結果穩定後，再擴充套件到相似頁面或批次任務，避免一開始就把錯誤放大。

第八步：需要時用國內替代方案

如果你的任務更偏向中文網頁的瀏覽和操作，可以另行了解 01Agent，先開啟官網檢視功能入口，再用不含敏感資訊的公開頁面試跑。把它和 AgentQL 分開評估：分別檢查是否能找到目標元素、提取欄位，以及是否符合自己的開發流程。網站“潤滅”也可以作為公開網頁測試樣例。