工作流自动化（RPA）快速开始

本篇带您完成工作流自动化（RPA）的第一次上手。在 MagicAI 里，工作流自动化 = RPA。下文统一称 工作流自动化（RPA） 或 RPA 工作流。

一条工作流可以同时调接口、处理数据、调用大模型、操作浏览器 / 手机 / 桌面软件。本篇示例先聚焦最直观的浏览器场景，后续您可以在同一条流里继续加上接口、数据、AI 节点。

---

本篇示例：搭建一条最小可运行的 RPA 工作流

我们将完成：打开示例招聘网站，进入校园招聘页面，读取当前岗位数量，并把结果作为输出。

主链路：

创建任务 → 选择浏览器环境 → 打开页面 → 等待页面加载 → 点击元素 → 获取文本 → 配置输出 → 调试发布

完成后，您应该能看到：

• 浏览器自动打开目标页面。
• 工作流自动点击“校园招聘”入口。
• 运行日志中每个关键节点都成功。
• 结束节点输出一个岗位数量字段，例如 hire_count。

---

开始前请确认

• 已安装并登录 MagicAI 桌面端。
• 当前账号有创建、编辑和运行工作流的权限。
• 网络可以访问目标网站。
• 第一次练习建议选择 内置浏览器。
• 不要从验证码、支付、审批或复杂登录流程开始。

如果您还不确定该选哪种环境，请先阅读 执行环境与权限。

---

本示例会用到哪些指令？

步骤	指令	作用
打开目标网站	打开网页 或 导航到 URL	让浏览器进入目标页面
等待页面加载	等待元素存在	确认关键元素已经出现在页面上
点击入口	点击元素	点击“校园招聘”等页面按钮或链接
读取结果	获取文本	获取页面上的岗位数量文本
输出结果	结束节点	把结果暴露给定时任务、AI 智能团队 / Agent Team 或其他流程

第一次学习时，建议先用这几类基础指令跑通闭环，再学习循环、异常处理、定时任务等高级能力。

---

第一步：创建工作流

1. 在左侧导航进入 工作流自动化（RPA）。
2. 点击创建入口。
3. 选择适合浏览器自动化的创建方式，例如空白创建或浏览器模板。
4. 填写任务名称，例如 获取示例公司校招岗位数。
5. 进入工作流编辑页面。

创建完成后，画布上通常会出现 开始节点 和 结束节点。后续节点都放在开始和结束之间。

---

第二步：选择执行环境

本示例建议选择 内置浏览器。

原因是：

• 不依赖个人电脑已有浏览器状态。
• 便于在编辑时捕获元素。
• 便于观察页面变化和调试日志。

在编辑阶段，如果需要捕获元素，请先连接一个可用浏览器设备。正式运行时，系统会按流程配置启动对应执行环境。

环境准备完成的标准是：您能在浏览器区域正常打开目标网站，并且页面没有被网络、权限或登录状态拦住。

---

第三步：打开目标页面

1. 从指令面板中找到 打开网页 或 导航到 URL。
2. 将指令拖入 开始节点 和 结束节点 之间。
3. 在配置面板中填写网址：

https://example.com

4. 运行到该节点，确认浏览器能打开示例招聘首页。

如果页面打不开，请先排查网络、环境和权限，不要继续配置后面的点击和获取文本节点。

---

第四步：等待关键元素出现

网页加载需要时间。新手最常见的问题，是页面还没加载完就执行点击或获取文本。

建议在打开页面后添加一个 等待元素存在 节点：

1. 从指令面板中找到 等待元素存在。
2. 捕获页面上一个稳定元素，例如顶部导航栏或“校园招聘”入口。
3. 将定位超时设置为一个合理值，例如 10000ms。
4. 将等待结果保存为变量，例如 is_page_ready。

成功标准是：运行日志中该节点返回 true，表示页面关键元素已经出现。

---

第五步：点击“校园招聘”

页面准备好后，添加 点击元素 节点。

配置方式：

1. 把 点击元素 节点放在等待节点之后。
2. 点击 捕获元素。
3. 在浏览器页面中把鼠标移动到“校园招聘”入口，看到高亮后单击。
4. 在元素详情中将元素命名为 校园招聘入口。
5. 保存元素。

捕获元素前，请确保浏览器正处在这个节点运行时应该看到的页面状态。也就是说，浏览器应该已经打开招聘首页，并且“校园招聘”入口可见。

成功标准是：运行到该节点后，页面进入校园招聘或职位列表相关页面。

---

第六步：获取岗位数量文本

接下来添加 获取文本 节点，用来读取页面上的岗位数量或职位列表标题。

配置方式：

1. 把 获取文本 节点放在点击节点之后。
2. 如果点击后页面会跳转或刷新，建议先再加一个 等待元素存在 节点，等待职位列表区域出现。
3. 点击 捕获元素，选择显示岗位数量的文本区域。
4. 将元素命名为 校招岗位数量。
5. 将结果保存为变量，例如 hire_count_text。

如果获取到的是“全部校招职位 (536)”这类文本，先直接输出完整文本即可。后续可以再用文本处理、正则或代码节点提取其中的数字。

成功标准是：运行日志中 hire_count_text 有值，并且值和页面显示一致。

---

第七步：配置结束节点输出

工作流不只要“跑完”，还要把业务结果输出出来。

1. 点击 结束节点。
2. 新增输出字段：

字段	建议值
字段名称	hire_count
类型	String
字段值	选择上一步 hire_count_text 的输出变量

如果结束节点没有配置输出，流程即使运行成功，AI 智能团队 / Agent Team、定时任务或其他流程也很难复用结果。

---

第八步：调试运行

点击 运行 或 调试，按顺序观察每个节点。

重点检查：

• 打开网页节点是否成功进入目标页面。
• 等待节点是否返回 true。
• 点击节点是否点击了正确入口。
• 获取文本节点是否输出了 hire_count_text。
• 结束节点是否输出了 hire_count。
• 运行日志中是否有失败节点或被忽略的错误。

本示例的成功标准是：运行结束后能看到 hire_count 输出，并且日志中关键节点都成功。

---

第九步：发布和复用

调试通过后，可以发布工作流。

发布前请至少完整成功运行一次，并确认：

• 输入、变量和输出命名清晰。
• 关键元素定位稳定。
• 日志中没有被忽略的错误。
• 流程不会重复提交、重复发送或产生高风险动作。

发布说明建议写清楚：

打开示例招聘网站，进入校园招聘页面，读取岗位数量文本并输出 hire_count。

发布后，该工作流可以被团队成员复用，也可以配置 定时任务 周期运行。

---

在同一条工作流里继续混搭节点

跑通这条最小示例后，您可以在它基础上继续加：

• 在“获取文本”后加 执行代码 节点，用正则提取数字。
• 在结束前调一个 HTTP 接口，把岗位数同步到内部系统。
• 在“点击”前加大模型节点，让模型判断该不该点。
• 在 try-catch 里把整段浏览器操作包住，失败时发飞书告警。

这些都是同一条工作流自动化（RPA）的一部分，不需要切到“另一类工作流”。

---

下一步

• 想系统理解模块关系：阅读 什么是工作流自动化（RPA）。
• 想搭更完整的端到端流程：阅读 搭建浏览器 RPA 工作流。
• 想让流程更稳定：阅读 录制、元素与调试。
• 想让任务每天自动运行：阅读 发布、定时与日志。