跳转到内容

浏览器 RPA

浏览器 RPA 在本机 Chromium 浏览器环境中自动执行重复任务:打开网页、操作元素、读取结果,并用条件或循环控制流程。流程保存为模板,存放在当前登录的 MoreLogin 账号中,可以在桌面客户端里运行,也可以通过浏览器 RPA Local API 在指定环境上运行。

本节面向通过程序编排和运行模板的开发者与 AI 代理。需要自动操作 Android 云手机时,请参考云手机 RPA。

前提条件

  • MoreLogin 桌面客户端 V2.73.0 或更高版本已启动并登录。模板保存在当前账号中,并显示在客户端的「自定义模板」里。
  • Local API 地址为 http://127.0.0.1:<port>/api/rpa/browser/v1。端口以客户端设置中 Local API 的端口为准,默认是 40000。
  • 认证方式与其他 Local API 相同,见认证。
  • 运行需要 Chromium 浏览器环境(browserTypeId: 1)。
  • GET /capabilities 返回当前客户端和账号可用的操作、限额和文档地址。编排模板前先查询。

核心概念

概念含义
模板已保存的流程,包含标题、说明和子模板依赖。每次保存都会生成新版本。
流程模板中按顺序排列的节点树,以唯一的 start 节点开始、唯一的 end 节点结束。
节点流程中的一个步骤,例如打开网址或点击元素。每种节点类型都有契约,规定输入和输出。
环境运行使用的浏览器环境。environmentId 就是浏览器 Local API 中环境的 envId。
运行在某个环境上执行一次已保存的模板版本。运行包含节点执行记录和产物。
请求收据带 Idempotency-Key 的写请求的处理结果。请求超时后,用它确认实际结果。

与其他 Local API 的区别

浏览器 RPA 接口不使用通用响应格式中的 {code, msg, data} 结构。

  • 返回真实的 HTTP 状态码,例如 201、202、409、412、422、429、503。
  • 成功响应为 {data, meta},错误响应为 {error, meta}。错误码是 RPA_VALIDATION_FAILED 这类字符串,见错误码。
  • 写请求使用 Idempotency-Key、If-Match 和 X-RPA-Catalog-Revision 请求头,见写请求所需的请求头。
  • 认证失败仍使用 Local API 标准的 401 格式。

开始使用

  1. 快速开始:查询能力和节点契约,校验并保存一个返回最终网页地址的模板。
  2. 通过 API 运行模板:对已保存的版本做预检、启动运行并读取结果。
  3. 共同字段与流程结构:了解流程结构、引用、超时和重试。
  4. 节点目录:查看每个节点的输入、默认值、引用和输出。
  5. Local API 参考:查看全部接口、写请求所需的请求头,以及超时和版本冲突的恢复方法。

需要手动运行模板时,见在客户端运行模板。