page-agent

环境要求

• Node.js 与 npm 环境（用于 npm install）
• 支持 import 与 await 的现代浏览器页面环境
• 可访问的大模型服务 API Key（如 DashScope 兼容模式）

安装与启动步骤

1. 1安装 page-agent 依赖

   在项目目录执行 npm 安装，把 page-agent 作为依赖引入你的前端工程。

   npm install page-agent

   复制

2. 2初始化 PageAgent 实例

   在页面脚本中导入 PageAgent，填入模型名、baseURL、apiKey 与语言，YOUR_API_KEY 需换成你自己的密钥。

   import { PageAgent } from 'page-agent'
   
   const agent = new PageAgent({
       model: 'qwen3.5-plus',
       baseURL: 'https://dashscope.aliyuncs.com/compatible-mode/v1',
       apiKey: 'YOUR_API_KEY',
       language: 'en-US',
   })

   复制

3. 3执行自然语言指令

   调用 agent.execute 传入自然语言任务，智能体会在页面内自动完成点击等操作，可 await 等待结果。

   await agent.execute('Click the login button')

   复制

关键配置

如何确认成功

页面脚本成功执行 agent.execute 并完成指定操作（如点击登录按钮），无报错即接入成功。

常见问题

注意事项

• apiKey 属于敏感信息，示例中的 YOUR_API_KEY 必须替换为你自己的密钥，避免泄露到公开代码库
• README 为英文文档，中文文档位于 docs/README-zh.md，更多编程式用法见官网文档
• page-agent 运行在网页内部，需要你的页面环境允许加载并执行该 JavaScript