# 策展 · X (Twitter) 🔥

> 📖 本站完整內容索引（documentation index）：[llms.txt](/llms.txt)

> 作者：Omar Shahine (@OmarShahine) · 平台：X (Twitter) · 日期：2026-05-27

> 原始來源：https://x.com/OmarShahine/status/2059170907521003636

## 中文摘要

Webwright 透過瀏覽器執行環境實現網頁自動化。

Webwright 重新定義了網頁 Agent 的運作範式，不再將瀏覽器視為狀態持續的容器，而是將其轉化為 Agent 可隨時啟動、檢查並丟棄的工具。這種設計讓 Agent 能夠透過撰寫並執行 Python 程式碼來與網頁互動，而非僅僅依賴於單步的座標預測或 DOM 節點點擊。這種「程式碼即動作」的方法，不僅大幅提升了處理長週期任務的穩定性，也讓生成的腳本具備可重複執行與參數化的特性。

**核心設計理念**
Webwright 的架構極度精簡，旨在消除傳統 Agent 框架中隱晦的排程層與複雜的圖形引擎。其核心優勢包括：
- **以工作區為狀態**：Agent 的持久化產物是本地工作區中的程式碼與日誌，而非瀏覽器連線狀態。這使得 Agent 能夠像人類工程師一樣，透過迭代腳本來處理動態載入或重新渲染等複雜網頁行為。
- **端到端執行**：每個任務都被封裝在一個可重新執行的 Python 腳本中，瀏覽歷史即為單一程式碼檔案，易於除錯與追蹤。
- **高效工作流**：透過程式碼中的迴圈、函式與抽象化，Agent 能更有效地處理表單填寫或日期選擇等重複性步驟，減少互動輪次並降低錯誤累積。

**效能表現**
根據官方評測，Webwright 在多項基準測試中展現了優於傳統視覺化 Agent 的能力：
- **Online-Mind2Web**：在 300 個任務的評測中，使用 GPT-5.4 的 Webwright 達到了 86.7% 的成功率，在 AutoEval 類別中領先開源框架。
- **Odysseys**：在 200 個長週期任務中，Webwright 取得 60.1% 的成功率，較先前基於視覺與持續瀏覽器狀態的 SOTA 模型提升了 15.6 個百分點。
- **模型相容性**：即便使用如 Qwen-3.5-9B 等較小型的模型，透過 Webwright 提供的可重複使用工具，依然能在複雜網頁任務中達成優異表現。

**快速啟用與安裝**
使用者需確保環境已安裝 Python 3.10+ 與 Playwright 的 Chromium 驅動，並準備好 OpenAI、Anthropic 或 OpenRouter 的 API 金鑰。安裝與執行步驟如下：

1. 安裝套件：
   ```bash
   pip install -e .
   playwright install chromium
   ```
2. 執行任務：
   ```bash
   python -m webwright.run.cli \
       -c base.yaml -c model_openai.yaml \
       -t "Search for flights from SEA to JFK on 2026-08-15 to 2026-08-20" \
       --start-url https://www.google.com/flights \
       --task-id demo_openai \
       -o outputs/default
   ```

**整合至現有 Agent**
Webwright 支援作為 plugin 整合至多種主流 Agent 平台，包括 Claude Code、OpenAI Codex、OpenClaw 與 Hermes Agent。透過整合，這些 Agent 可以直接呼叫 Webwright 的 skill 來執行網頁任務，無需額外的 API 金鑰。例如在 Claude Code 中，可透過以下指令安裝：
- 新增市集：`/plugin marketplace add microsoft/Webwright`
- 安裝插件：`/plugin install webwright@webwright`

安裝後，使用者可使用 `/webwright:run` 執行一次性任務，或使用 `/webwright:craft` 產生可參數化的 CLI 工具，將網頁互動邏輯轉化為可重複使用的程式碼資產。更多詳細資訊可參考 [Webwright 專案頁面](https://microsoft.github.io/Webwright/)。

## 標籤

Agent, 自動化, 新產品, Web, Webwright