BAIZE AI RESOURCE

网页任务自动执行智能体

Jev-ultrafast

Jev Ultrafast 是一个本地运行的浏览器智能体。用户用自然语言描述目标,它便根据当前网页选择操作和目标元素,执行点击、输入等步骤,减少手动完成网页任务的操作。

Jev-ultrafast

资源介绍

Jev Ultrafast 面向希望用自然语言完成网页操作的用户,也适合需要在 Python 程序中调用浏览器智能体的开发者。用户提供网页地址和目标后,它会读取页面上可见的控件,为每一步选择可执行的操作及对应元素;需要填写文字时,再调用文本模型生成内容。项目提供本地演示界面,可以查看带编号的页面元素、操作选择和已执行的动作,也可以在执行前暂停。仓库给出了 Google Flights 航班搜索和维基百科文章查找示例。航班示例会核对路线、日期与结果,但不会选定或预订航班。

Agent 能力

按目标操作网页

根据自然语言目标和当前页面元素,选择点击、输入文字、选择选项、滚动或等待等操作,逐步完成网页任务。

限定可操作目标

每次观察页面后更新元素列表,只提供与所选操作兼容的目标,避免将任意模型输出直接当作网页操作指令。

查看执行过程

本地演示界面展示编号元素、操作与目标的选择概率以及已执行动作,并可在下一步执行前暂停。

通过 Python 调用

可在 Python 中向 Agent 传入网页地址和任务目标,并逐步获取运行状态,便于将网页操作纳入自己的脚本。

资源配置

运行平台

本地运行

配置方式

环境变量API Key配置文件

依赖资源

需要 Python 3.12 或更高版本;项目依赖 browser-harness 和 httpx。按 README 使用 uv sync 安装,并在 .env 中配置 TYPESAFE_API_KEY 与 TEXT_MODEL_API_KEY;Chrome 连接如有需要可用 browser-harness --doctor 检查。

运行与使用

  1. 准备 Python 3.12 或更高版本及 Chrome,克隆项目后运行 `uv sync` 安装所需依赖。

  2. 将 `.env.example` 复制为 `.env`,填写 `TYPESAFE_API_KEY` 和 `TEXT_MODEL_API_KEY`。

  3. 运行 `uv run jev`,打开 `http://127.0.0.1:8766`,在演示界面启动自动运行;也可在 Python 脚本中创建 `Agent`,传入网页地址和目标。

  4. 如 Chrome 尚未连接,运行 `uv run browser-harness --doctor`,并在提示时允许 Chrome 远程调试。

使用案例

查找航班选项

使用场景想查询指定日期从苏黎世前往伦敦的单程航班。

向 Agent 提供 Google Flights 页面地址和航线、日期等目标,让它操作页面直至匹配的航班选项可见;示例会核对搜索结果,不会预订航班。

打开百科文章

使用场景需要从维基百科首页找到某篇指定文章。

运行 `examples/run.py`,传入维基百科首页地址和文章查找目标,让智能体在网页中查找并打开对应文章。

包含内容

jev-ultrafast-source.zip
README-中文安装说明.md
LICENSE-MIT.txt
SHA256.txt

常见问题

本地演示需要配置哪些密钥?
需要在 `.env` 中填写 `TYPESAFE_API_KEY` 和 `TEXT_MODEL_API_KEY`。示例配置中的文本模型密钥使用 OpenRouter key。
演示界面可以暂停自动操作吗?
可以。演示界面的“Choose next”会在执行下一步前暂停;界面还会显示元素编号、选择概率和已执行动作。
航班示例会帮我订票吗?
不会。`examples/flights.py` 执行航班搜索并核对路线、日期和结果,但不会选择或预订航班。
运行这个项目需要什么 Python 版本?
项目配置要求 Python 3.12 或更高版本。本地演示还需要连接 Chrome;所需的 Browser Harness 会通过 `uv sync` 安装。