{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/zh/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"浏览器 RPA"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"浏览器-rpa","__idx":0},"children":["浏览器 RPA"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["浏览器 RPA 在本机 Chromium 浏览器环境中自动执行重复任务：打开网页、操作元素、读取结果，并用条件或循环控制流程。流程保存为模板，存放在当前登录的 MoreLogin 账号中，可以在桌面客户端里运行，也可以通过浏览器 RPA Local API 在指定环境上运行。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["本节面向通过程序编排和运行模板的开发者与 AI 代理。需要自动操作 Android 云手机时，请参考",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/zh/rparobotic-process-automation/01-overview/01-rpa-introduction"},"children":["云手机 RPA"]},"。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"前提条件","__idx":1},"children":["前提条件"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["MoreLogin 桌面客户端 V2.73.0 或更高版本已启动并登录。模板保存在当前账号中，并显示在客户端的「自定义模板」里。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Local API 地址为 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["http://127.0.0.1:<port>/api/rpa/browser/v1"]},"。端口以客户端设置中 Local API 的端口为准，默认是 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["40000"]},"。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["认证方式与其他 Local API 相同，见",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/zh/api-reference/getting-started/authentication"},"children":["认证"]},"。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["运行需要 Chromium 浏览器环境（",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["browserTypeId: 1"]},"）。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /capabilities"]}," 返回当前客户端和账号可用的操作、限额和文档地址。编排模板前先查询。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"核心概念","__idx":2},"children":["核心概念"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"概念"},"children":["概念"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"含义"},"children":["含义"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["模板"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["已保存的流程，包含标题、说明和子模板依赖。每次保存都会生成新版本。"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["流程"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["模板中按顺序排列的节点树，以唯一的 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["start"]}," 节点开始、唯一的 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["end"]}," 节点结束。"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["节点"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["流程中的一个步骤，例如打开网址或点击元素。每种节点类型都有契约，规定输入和输出。"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["环境"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["运行使用的浏览器环境。",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["environmentId"]}," 就是",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/zh/api-reference/browser/local-api"},"children":["浏览器 Local API"]}," 中环境的 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["envId"]},"。"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["运行"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["在某个环境上执行一次已保存的模板版本。运行包含节点执行记录和产物。"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["请求收据"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["带 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Idempotency-Key"]}," 的写请求的处理结果。请求超时后，用它确认实际结果。"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"与其他-local-api-的区别","__idx":3},"children":["与其他 Local API 的区别"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["浏览器 RPA 接口不使用",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/zh/api-reference/getting-started/response-format"},"children":["通用响应格式"]},"中的 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{code, msg, data}"]}," 结构。"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["返回真实的 HTTP 状态码，例如 201、202、409、412、422、429、503。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["成功响应为 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{data, meta}"]},"，错误响应为 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{error, meta}"]},"。错误码是 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RPA_VALIDATION_FAILED"]}," 这类字符串，见",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/zh/browser-rpa/api/error-codes"},"children":["错误码"]},"。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["写请求使用 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Idempotency-Key"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["If-Match"]}," 和 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-RPA-Catalog-Revision"]}," 请求头，见",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/zh/browser-rpa/local-api#%E5%86%99%E8%AF%B7%E6%B1%82%E6%89%80%E9%9C%80%E7%9A%84%E8%AF%B7%E6%B1%82%E5%A4%B4"},"children":["写请求所需的请求头"]},"。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["认证失败仍使用 Local API 标准的 401 格式。"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"开始使用","__idx":4},"children":["开始使用"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/zh/browser-rpa/quickstart"},"children":["快速开始"]},"：查询能力和节点契约，校验并保存一个返回最终网页地址的模板。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/zh/browser-rpa/run-api-example"},"children":["通过 API 运行模板"]},"：对已保存的版本做预检、启动运行并读取结果。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/zh/browser-rpa/node-contract-guide"},"children":["共同字段与流程结构"]},"：了解流程结构、引用、超时和重试。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/zh/browser-rpa/nodes"},"children":["节点目录"]},"：查看每个节点的输入、默认值、引用和输出。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/zh/browser-rpa/local-api"},"children":["Local API 参考"]},"：查看全部接口、写请求所需的请求头，以及超时和版本冲突的恢复方法。"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["需要手动运行模板时，见",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/zh/browser-rpa/run"},"children":["在客户端运行模板"]},"。"]}]},"headings":[{"value":"浏览器 RPA","id":"浏览器-rpa","depth":1},{"value":"前提条件","id":"前提条件","depth":2},{"value":"核心概念","id":"核心概念","depth":2},{"value":"与其他 Local API 的区别","id":"与其他-local-api-的区别","depth":2},{"value":"开始使用","id":"开始使用","depth":2}],"frontmatter":{"seo":{"title":"浏览器 RPA"}},"lastModified":"2026-11-20T14:40:39.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/zh/browser-rpa/overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}