构建一个小型工作流#
在本课中,你将构建一个小型的 工作流(workflow),用于从 Hacker News 获取 10 篇关于自动化的文章。该过程包含五个步骤:
- 添加手动触发节点(Manual Trigger node)
- 添加 Hacker News 节点
- 配置 Hacker News 节点
- 执行节点
- 保存工作流
最终的工作流将如下所示: 查看工作流文件
1. 添加手动触发节点(Manual Trigger node)#
打开节点面板(提示:你可以通过点击画布右上角的 + 图标,或按下键盘上的 Tab 键来打开)。
然后执行以下操作:
- 搜索 Manual Trigger 节点。
- 在搜索结果中选择该节点。
这会将 Manual Trigger 节点添加到你的画布(canvas)中,使你能够随时点击 Execute workflow 按钮运行工作流。
手动触发说明 为了加快工作流创建速度,未来你可以跳过此步骤。如果在没有触发器的情况下添加其他节点,n8n 会自动为你添加 Manual Trigger 节点。 在实际场景中,你可能更希望设置一个定时任务或其他类型的 触发器(trigger) 来自动运行工作流。
2. 添加 Hacker News 节点#
点击 Manual Trigger 节点右侧的 + 图标以打开节点面板。 然后执行以下操作:
- 搜索 Hacker News 节点。
- 在搜索结果中选择该节点。
- 在 Actions 区域,选择 Get many items。
n8n 会将该节点添加到你的画布中,并自动打开节点窗口以显示其配置详情。
3. 配置 Hacker News 节点#
当你向编辑器界面(Editor UI)中添加新节点时,该节点会自动激活,并在其窗口中显示多个配置选项:
- Parameters(参数):调整参数以细化和控制节点的功能。
- Settings(设置):调整设置以控制节点的外观和执行行为。
- Docs(文档):在新窗口中打开该节点的 n8n 官方文档。
参数 vs. 设置
- 参数(Parameters) 因节点功能不同而各异。
- 设置(Settings) 对所有节点都相同。
参数#
我们需要为 Hacker News 节点配置几个参数,使其正常工作:
- Resource(资源) : All(全部) 该资源选项会选择所有数据记录(文章)。
- Operation(操作) : Get Many(获取多个) 此操作用于获取所选的所有文章。
- Limit(限制) : 10 此参数用于限制“获取多个”操作返回的结果数量。
- Additional Fields(附加字段) > Add Field(添加字段) > Keyword(关键词) : automation(自动化) 附加字段 是你可以添加到某些节点的可选配置项,用于使请求更具体或对结果进行过滤。在此示例中,我们只想获取包含关键词 "automation" 的文章。
Hacker News 节点的参数配置现在应如下所示: Hacker News 节点参数Hacker News 节点参数
设置#
设置(Settings) 部分包含多个与节点外观和执行相关的选项。在本例中,我们将仅配置最后两个设置项,它们用于控制节点在编辑器 UI 画布中的显示方式。 在 Hacker News 节点的设置中,请修改以下内容:
- Notes(备注) : 获取最新的 10 篇文章。 节点备注 通常建议在节点中添加简短描述,说明其用途。这对于复杂或共享的工作流尤其有帮助!
- Display note in flow?(在流程中显示备注?) : 切换为 true 启用此选项后,备注将显示在画布中节点的下方。
Hacker News 节点的设置配置现在应如下所示: Hacker News 节点设置Hacker News 节点设置
重命名节点 你可以将节点重命名为更符合你使用场景的名称。有三种方法可以实现:
- 选中要重命名的节点,同时按下键盘上的 F2 键。
- 双击节点以打开节点窗口。点击窗口左上角的节点名称,输入新名称,然后点击 Rename(重命名) 保存更改。
- 右键点击节点,选择 Rename(重命名) 选项。
重命名节点通过键盘重命名节点 要查看原始节点名称(即节点类型),请打开节点窗口并选择 Settings(设置)。页面底部会显示节点的类型和版本。
4. 执行节点#
在节点详情窗口中选择 Execute step(执行步骤)按钮。你应该能在输出的 Table(表格)视图中看到 10 条结果。
Hacker News 节点在表格视图中的结果Hacker News 节点在表格视图中的结果
节点执行#
节点执行(Node execution) 节点执行表示该节点运行一次,用于获取或处理指定的数据。
如果节点成功执行,在画布上的节点顶部会出现一个绿色的小对勾。
成功执行的工作流成功执行的工作流
如果参数没有问题且一切正常,请求到的数据将在节点窗口中以 Table(表格)、JSON 和 Schema(模式)三种格式显示。你可以通过节点窗口顶部的 Table | JSON | Schema 按钮切换这些视图。
表格视图 vs JSON 视图 Table(表格)视图是默认视图。它将请求的数据以表格形式展示,其中每一行代表一条记录,每一列代表该记录的一个可用属性。
以下是 Hacker News 节点在 JSON 视图下的输出:
Hacker News 节点在 JSON 视图中的结果Hacker News 节点在 JSON 视图中的结果
节点窗口还会显示更多关于本次节点执行的信息:
- 在 Output(输出)标题旁边,你会看到一个小图标(若执行成功则为绿色对勾)。其右侧还有一个信息图标(i)。将鼠标悬停在此图标上时,会显示另外两个有助于了解工作流中每个节点性能的信息:
- Start Time(开始时间):节点执行启动的时间。
- Execution Time(执行时间):从节点开始执行到返回结果所花费的时间。
- 在 Output 标题下方,还有一项信息:10 items(10 条项目)。该字段显示了节点请求返回的项目(记录)数量。本例中预期为 10 条,因为我们已在第二步中设置了此限制。但如果你未设置限制,这个数值可以帮助你了解实际返回了多少条记录。
节点中的错误 节点上出现红色警告图标表示该节点存在错误。这可能是由于节点的凭据缺失或不正确,或者节点参数未正确配置所致。 节点中的错误节点中的错误
5. 保存工作流#
完成节点编辑后,选择 Back to canvas(返回画布) 以回到主画布界面。 默认情况下,你的工作流会自动保存为“My workflow”(我的工作流)。 在本课程中,请将工作流重命名为“Hacker News workflow”(Hacker News 工作流)。
提示 你可以通过点击编辑器 UI 顶部的工作流名称来重命名工作流。 重命名工作流后,请务必保存更改。
有两种方式可以保存工作流:
- 在编辑器 UI 的画布界面中,按下键盘上的 Ctrl + S 或 Cmd + S。
- 点击编辑器 UI 右上角的 Save(保存) 按钮。你可能需要先点击对话框外部,退出节点编辑器。
如果你看到灰色的 Saved(已保存) 文字而非 Save(保存) 按钮,则说明你的工作流已被自动保存。
总结#
恭喜!你刚刚创建了你的第一个工作流!在本课中,你学习了如何在应用节点中使用操作(actions)、配置其参数和设置,以及如何保存和执行你的工作流。
在下一课中,你将认识你的新客户 Nathan,他需要自动化他的销售报告工作。你将为他构建一个更复杂的工作流,帮助他在工作中提升效率。