什么是工作流自动化（RPA）
工作流自动化（RPA）是 MagicAI 把多步任务编排成可执行流程的模块。在 MagicAI 里，工作流自动化 = RPA，是同一个能力的两种叫法。下文统一称 工作流自动化（RPA） 或 RPA 工作流。
一条 RPA 工作流可以同时混用：
- 调接口、读写数据库
- 处理 JSON / 数组 / 对象 / 表格 / 日期
- 调用大模型、知识库、提示词
- 操作浏览器、手机 App、桌面软件
- 条件、循环、并行、try-catch
不需要按“哪种类型”二选一。同一条工作流里，可以前几步调 API 拿数据，中间几步操作网页填表，最后几步发飞书通知。
| 你的目标 | 用工作流自动化（RPA） |
|---|---|
| 调用接口、处理数据、生成报告 | 是 |
| 打开网页、点击按钮、填写表单、读取文本 | 是 |
| 操作手机 App | 是 |
| 操作本地桌面软件 | 是 |
| 让流程每天定时跑 | 是 |
| 让数字员工调用一段固定动作 | 是（再封装成专业技能） |
| 对话型问答 / 拆解需求 | 用 AI 智能团队 / Agent Team |
| 生成图片或视频 | 用 创作 |
工作流由哪些部分组成
Section titled “工作流由哪些部分组成”工作流由一连串“节点”组成。常见类别：
| 类别 | 你能做什么 |
|---|---|
| 大模型与 AI | 调用大模型、字段抽取、长文本理解、提示词处理 |
| 知识库 | 让流程基于团队资料回答或处理 |
| 数据处理 | 处理 JSON、数组、对象、表格、日期 |
| 流程控制 | 条件分支、循环、并行分支、try-catch、子流程 |
| 网页操作 | 打开网页、点击、填写、获取文本、截图 |
| 手机操作 | 打开 App、点击、滑动、输入、读取界面 |
| 桌面操作 | 操作桌面软件、键盘鼠标、截图、OCR |
| HTTP 与连接 | 调外部接口、发通知、读写数据库 |
| 文件与命令 | 保存文件、解析文档、执行 Shell |
| 断言与等待 | 判断结果、等待元素、等待页面状态 |
完整指令清单见 指令参考。
输入、变量、输出
Section titled “输入、变量、输出”- 开始节点：定义工作流的输入，例如订单号、日期、文件地址。
- 变量：节点之间用变量传递数据，例如把上一步的结果保存为
output，下一步引用${output}。 - 结束节点：定义对外输出。AI 智能团队、定时任务或其他流程拿到的就是结束节点的字段。
条件、循环、并行、异常
Section titled “条件、循环、并行、异常”- 条件分支：根据变量走不同路径。
- 循环：批量遍历列表元素。
- 并行分支：同时跑多条支线，再汇总。
- try-catch：捕获节点失败、走备用方案。
- 节点级失败处理：每个节点都可以单独配置“失败时停止 / 失败时继续 / 可选 / 自动重试”，并设置重试次数。
异常和重试是 节点上的选项，不是单独节点；建议在第一次搭建时就给关键节点配好。
工作流怎么执行
Section titled “工作流怎么执行”MagicAI 桌面端内置了一套工作流引擎，所有工作流都在它上面执行。你不用关心引擎本身，但需要知道：
- 客户端启动时引擎会自动准备好，不需要单独启动。
- 工作流可以在 运行 / 调试 模式下跑，也可以发布后被定时任务、AI 智能团队或其他流程触发。
- 浏览器节点默认使用 MagicAI 提供的浏览器环境，不需要你自己装浏览器。
- 桌面 RPA 节点需要 macOS / Windows 上的相关权限（详见 第一次使用前准备 中的“操作系统权限”一节）。
一个工作流可以被这几种方式触发：
- 在编辑器里点 运行 / 调试。
- AI 智能团队 / Agent Team 中的数字员工调用。
- 已发布工作流被 定时任务 周期触发（按 Cron 时间表）。
| 阶段 | 你要做的 | 推荐阅读 |
|---|---|---|
| 1. 了解模块 | 知道工作流自动化（RPA）能做什么 | 本页 |
| 2. 跑通一次 | 完成第一个最小示例 | 工作流自动化快速开始 |
| 3. 实战搭建 | 完整搭一条浏览器 RPA 工作流 | 搭建浏览器 RPA 工作流 |
| 4. 提升稳定性 | 等待、定位、调试、日志 | 录制、元素与调试 |
| 5. 上线运行 | 发布、定时、回滚 | 发布、定时与日志 |
| 6. 排障 | 系统化定位失败 | 常见问题与排障 |
和 AI 智能团队的关系
Section titled “和 AI 智能团队的关系”把 AI 智能团队 / Agent Team 当作 “理解 + 决策”，把工作流自动化（RPA）当作 “稳定执行”。
典型协作链路：
- 用户向数字员工说目标。
- 数字员工拆解，判断是否需要调用工作流。
- 工作流从开始节点接输入，按节点顺序执行。
- 工作流在结束节点输出结构化结果。
- 数字员工把结果解释给用户，或继续下一步。
如果一件事会反复出现，把它沉淀为工作流，再让 AI 智能团队 / Agent Team 调用。
| 你遇到的情况 | 处理方式 |
|---|---|
| 客户端启动后看不到工作流入口 | 阅读 安装与登录 检查账号 / 工作空间 |
| 客户端环境异常 | 阅读 第一次使用前准备 |
| 工作流跑不起来 | 阅读 常见问题与排障 |
- 想立即上手：工作流自动化快速开始。
- 想搭一条端到端流程：搭建浏览器 RPA 工作流。
- 想看每个节点参数：指令参考。