前言在鸿蒙智能体开发系列的前两篇中我们完成了开发环境的准备与智能体的基础配置。本篇将重点介绍**工作流Workflow**的完整开发流程。工作流是华为小艺开放平台提供的核心能力之一专门用于处理功能类的请求——它通过顺序执行一系列节点来实现某个具体功能。工作流为智能体的数据流动和任务处理提供了一个结构化框架其核心在于将大模型的强大能力与特定的业务逻辑相结合通过系统化、流程化的方法实现高效、可扩展的 AI 应用开发。本文将以笑话生成助手为完整示例从新建工作流、配置各类节点、试运行调试到关联智能体发布完整还原每一步实际操作。本文所有截图和操作步骤均基于华为 AppGallery Connect 小艺开放平台建议配合 官方文档开发工作流 阅读。一、工作流概述1.1 工作流的定位与作用根据官方文档工作流适用于处理功能类请求的场景。小艺开放平台提供了可视化画布开发者可以通过拖拽节点迅速搭建工作流并在画布中实时查看数据的流转过程和任务的执行顺序。与普通对话模式LLM 模式相比工作流模式具有以下特点流程可控每个步骤通过节点明确定义执行顺序清晰逻辑可见数据在节点间的流转在可视化画布上一目了然易于调试试运行时可查看每个节点的输入输出详情支持复杂场景可嵌套使用子工作流满足多层次的业务需求1.2 工作流支持的节点类型根据工作流节点说明平台目前提供了以下 18 种节点类型节点类型说明开始节点工作流的入口点结束节点工作流的出口点大模型节点调用大模型进行内容生成与处理插件节点集成第三方插件功能工作流节点嵌套调用其他工作流子工作流代码节点执行自定义代码逻辑选择器节点根据条件进行分支选择意图分类节点对用户意图进行分类输出节点返回处理结果循环节点实现循环逻辑处理批处理节点批量处理数据知识库节点与知识库进行交互变量节点管理工作流变量查询计数变量节点查询和计数变量配额管理节点管理配额限制长期记忆节点实现长期记忆功能文本处理节点进行文本处理操作提问器节点主动向用户提问并获取回答1.3 本文示例说明本文将构建一个笑话生成工作流流程如下提问器节点主动询问用户希望听什么类型的笑话生活趣事 / 冷笑话 / 段子大模型节点根据用户选择生成对应类型的笑话内容结束节点将大模型的输出结果返回给用户二、创建工作流2.1 新建工作流在小艺开放平台页面通过【资源库】→【工作流】→【新建工作流】进入新建工作流配置页面。在弹出的对话框中填写以下信息工作流名称为工作流命名如笑话生成流程分类选择合适的分类描述简要说明工作流的功能填写完成后点击【确定】按钮即可创建一个新的工作流。创建成功后页面会自动跳转至工作流的可视化编辑器界面。初始状态下工作流包含一个开始节点和一个结束节点。三、添加提问器节点3.1 为什么需要提问器我们希望在工作流开始时主动询问用户的喜好——例如用户想听什么类型的笑话。这正是提问器节点的用途它可以向用户展示一个问题并收集用户的回答文字输入或选项选择然后将回答作为变量传递给后续节点。3.2 添加提问器节点点击开始节点右侧的加号在弹出的节点列表中选择“提问器”即可在画布上创建一个新的提问器节点并自动与开始节点连接。四、配置提问器节点4.1 配置提问器参数点击提问器节点右侧会展开节点配置面板。按以下步骤操作删除输入配置由于本示例不需要从开始节点获取任何输入参数删除默认的输入配置项。填写提问内容在提问内容处填入希望展示给用户的问题例如选择您喜欢的类型设置回答用途在回答用途下拉框中选择“选项回答”面板下方会出现选项配置区域。4.2 添加固定输出选项在提问器设置面板中找到输出区域点击“添加固定输出选项”依次添加以下三个选项生活趣事冷笑话段子每个选项添加后会自动在提问器节点上生成一条对应的输出分支。用户在回答时可以从这三个选项中选择其中一个。五、配置大模型节点5.1 添加大模型节点在页面下方找到“添加节点”的加号点击后选择“大模型”即可创建一个大模型处理节点。5.2 连接提问器与大模型节点在提问器节点的配置面板中找到问答类型的各输出分支分别点击每个分支右侧的加号将所有输出分支都与大模型节点连接起来。这样无论用户选择哪个选项生活趣事、冷笑话、段子流程都会进入同一个大模型节点进行处理。5.3 配置大模型输入参数点击大模型节点在右侧配置面板中找到“输入”区域找到参数值右侧的设置图标齿轮图标在弹出的下拉列表中点击“提问器”选择userResponse即用户的回答结果作为输入变量这样大模型节点就能获取到用户选择的笑话类型并将其用于后续的 Prompt 生成。5.4 编写系统 Prompt在大模型配置面板中找到“系统 Prompt”输入框填入基础的系统提示词例如你是一个笑话创作助手根据用户选择的类型生成笑话。填写完成后可以点击输入框右侧的“优化”按钮系统会利用 AI 自动优化当前提示词使其更加专业有效。AI 优化后系统会在面板中展示优化结果。确认内容符合预期后点击“替换”按钮将优化后的提示词应用到当前节点。5.5 配置用户 Prompt在用户 Prompt 配置区域直接引用提问器节点的输出变量即可也就是使用上一个提问器节点生成的用户答案作为输入内容。说明通过引用变量的方式可以动态地将用户的选择内容插入到 Prompt 中实现个性化的大模型调用。六、配置结束节点6.1 连接大模型节点与结束节点完成大模型节点配置后将大模型节点的输出与结束节点的输入连接起来。点击结束节点在右侧配置面板中将输出设置成上一节点大模型节点的输出。6.2 配置回答内容在结束节点的“回答内容”配置项中引用大模型节点的输出变量即可也就是使用上一个大模型节点生成的内容作为最终回复。至此工作流的基本编排已完成。完整的节点流转关系如下节点类型说明开始节点开始工作流入口提问器节点提问器向用户提问收集选项回答大模型节点大模型根据用户选择生成笑话内容结束节点结束将大模型输出返回给用户七、试运行与调试7.1 启动试运行完成节点配置后点击页面底部的“试运行”按钮进入试运行界面再次点击“试运行”此时会弹出运行界面。根据官方文档说明运行成功的节点边框将显示为绿色用户可在页面右侧弹窗中查看节点的输入输出以及运行的调测树信息。7.2 模拟用户交互在弹出的运行界面中系统会按工作流逻辑展示提问器的问题并显示三个可供选择的选项。点击选择其中一个选项如冷笑话工作流会继续向下执行。7.3 查看运行结果工作流执行完毕后界面会显示大模型生成的笑话内容即工作流的最终输出结果。7.4 发布工作流测试通过后点击页面右上角的“上架”按钮将工作流发布到线上环境。注意根据官方文档开发者如需在智能体内使用该工作流必须先完成工作流的上架。只有调测成功的工作流方可发布上架上架后才能在智能体配置中被关联使用。八、工作流版本管理8.1 版本存档机制完成工作流开发后建议了解平台的版本管理功能。根据官方文档工作流版本管理工作流版本存档包含以下三种方式存档方式触发时机说明上架存档每次上架完成时自动记录到版本记录系统存档工作流编辑后自动保存为当前版本测试版本手动存档点击右上角【存档】图标填写存档描述后手动触发8.2 查看版本记录点击工作流右上角的【版本记录】图标可查看所有历史版本内容包括存档类型上架/系统/手动版本号存档描述操作人存档时间当版本较多时还可以根据版本类型筛选。8.3 预览与回退历史版本在版本记录列表中选择任意历史版本可进行以下操作查看版本点击版本或操作项中的【查看版本】进入只读预览模式试运行在预览模式下仍可执行试运行验证该版本的行为还原版本点击【还原到该版本】将该历史版本覆盖当前工作流的草稿注意若已还原版本中包含的知识库、插件、工作流已下架对应节点将显示失效状态需手动清理并替换节点资源后方可正常使用。九、工作流导入与导出9.1 功能说明根据官方文档导入导出工作流已创建的工作流支持导出导出的工作流文件可以导入到任意工作空间适用于跨账号复制工作流的场景。9.2 导出工作流操作步骤在工作流列表中找到目标工作流点击操作项中的【导出】按钮系统会将该工作流导出为JSON 文件文件包含了该工作流各节点的详细信息可直接用于导入提示如果工作流中包含工作流节点子工作流导出时系统会弹出提示询问是否需要一并导出子工作流。9.3 导入工作流操作步骤在工作流列表页点击右上角的【导入工作流】按钮上传导出的工作流 JSON 文件上传完成后系统会自动预填工作流名称、描述及图标确认信息无误后点击【导入】完成创建导入注意事项部分组件有效性与账号有关导入后插件、知识库、工作流等资源存在失效可能需手动清理并重新绑定。包含子工作流的情况需先将子工作流导入并上架再导入主工作流后重新关联子工作流方可正常使用。十、创建工作流模式智能体10.1 新建智能体工作流上架后需要将其关联到一个工作流模式的智能体才能对外提供服务。在工作空间页面点击“新建智能体”按钮在创建面板中按以下要求填写模式选择选择“工作流程模式”智能体名称填写展示名称如每日一笑描述简要介绍智能体的功能支持的设备和系统选择适配的设备类型分类选择合适的应用分类填写完成后点击“创建”按钮。10.2 配置开场对话进入智能体配置界面在开场对话配置区域设置开场语和开场场景引导帮助用户快速了解如何使用该智能体。10.3 关联工作流在智能体配置界面找到“工作流配置”区域点击“添加”按钮。在弹出的工作流选择器中从当前工作空间的工作流列表里找到刚刚上架的工作流点击“添加”完成关联。关联成功后在智能体的工作流配置区域会显示已关联的工作流信息。总结本文基于华为小艺开放平台官方文档完整介绍了工作流的开发与发布流程主要涵盖以下内容工作流的定位与 18 种节点类型说明新建工作流并在可视化画布中进行节点编排配置提问器节点实现主动向用户收集选项信息配置大模型节点完成系统 Prompt 填写与 AI 自动优化配置结束节点将大模型输出透传给用户通过试运行验证工作流的完整执行效果版本管理支持上架存档、系统存档与手动存档三种方式并可预览和回退历史版本导入导出将工作流导出为 JSON 文件实现跨账号迁移与备份创建工作流模式智能体并关联工作流完成发布下一篇将继续介绍鸿蒙智能体的更多能力包括知识库的创建与集成敬请期待。如果这篇文章对你有帮助欢迎点赞、收藏⭐、关注你的支持是我持续创作的动力相关资源小艺开放平台 Agent 文档首页开发工作流官方文档创建工作流官方文档工作流节点说明官方文档工作流版本管理官方文档导入导出工作流官方文档工作流/工作流配置官方文档
鸿蒙智能体开发实战：3.创建工作流
前言在鸿蒙智能体开发系列的前两篇中我们完成了开发环境的准备与智能体的基础配置。本篇将重点介绍**工作流Workflow**的完整开发流程。工作流是华为小艺开放平台提供的核心能力之一专门用于处理功能类的请求——它通过顺序执行一系列节点来实现某个具体功能。工作流为智能体的数据流动和任务处理提供了一个结构化框架其核心在于将大模型的强大能力与特定的业务逻辑相结合通过系统化、流程化的方法实现高效、可扩展的 AI 应用开发。本文将以笑话生成助手为完整示例从新建工作流、配置各类节点、试运行调试到关联智能体发布完整还原每一步实际操作。本文所有截图和操作步骤均基于华为 AppGallery Connect 小艺开放平台建议配合 官方文档开发工作流 阅读。一、工作流概述1.1 工作流的定位与作用根据官方文档工作流适用于处理功能类请求的场景。小艺开放平台提供了可视化画布开发者可以通过拖拽节点迅速搭建工作流并在画布中实时查看数据的流转过程和任务的执行顺序。与普通对话模式LLM 模式相比工作流模式具有以下特点流程可控每个步骤通过节点明确定义执行顺序清晰逻辑可见数据在节点间的流转在可视化画布上一目了然易于调试试运行时可查看每个节点的输入输出详情支持复杂场景可嵌套使用子工作流满足多层次的业务需求1.2 工作流支持的节点类型根据工作流节点说明平台目前提供了以下 18 种节点类型节点类型说明开始节点工作流的入口点结束节点工作流的出口点大模型节点调用大模型进行内容生成与处理插件节点集成第三方插件功能工作流节点嵌套调用其他工作流子工作流代码节点执行自定义代码逻辑选择器节点根据条件进行分支选择意图分类节点对用户意图进行分类输出节点返回处理结果循环节点实现循环逻辑处理批处理节点批量处理数据知识库节点与知识库进行交互变量节点管理工作流变量查询计数变量节点查询和计数变量配额管理节点管理配额限制长期记忆节点实现长期记忆功能文本处理节点进行文本处理操作提问器节点主动向用户提问并获取回答1.3 本文示例说明本文将构建一个笑话生成工作流流程如下提问器节点主动询问用户希望听什么类型的笑话生活趣事 / 冷笑话 / 段子大模型节点根据用户选择生成对应类型的笑话内容结束节点将大模型的输出结果返回给用户二、创建工作流2.1 新建工作流在小艺开放平台页面通过【资源库】→【工作流】→【新建工作流】进入新建工作流配置页面。在弹出的对话框中填写以下信息工作流名称为工作流命名如笑话生成流程分类选择合适的分类描述简要说明工作流的功能填写完成后点击【确定】按钮即可创建一个新的工作流。创建成功后页面会自动跳转至工作流的可视化编辑器界面。初始状态下工作流包含一个开始节点和一个结束节点。三、添加提问器节点3.1 为什么需要提问器我们希望在工作流开始时主动询问用户的喜好——例如用户想听什么类型的笑话。这正是提问器节点的用途它可以向用户展示一个问题并收集用户的回答文字输入或选项选择然后将回答作为变量传递给后续节点。3.2 添加提问器节点点击开始节点右侧的加号在弹出的节点列表中选择“提问器”即可在画布上创建一个新的提问器节点并自动与开始节点连接。四、配置提问器节点4.1 配置提问器参数点击提问器节点右侧会展开节点配置面板。按以下步骤操作删除输入配置由于本示例不需要从开始节点获取任何输入参数删除默认的输入配置项。填写提问内容在提问内容处填入希望展示给用户的问题例如选择您喜欢的类型设置回答用途在回答用途下拉框中选择“选项回答”面板下方会出现选项配置区域。4.2 添加固定输出选项在提问器设置面板中找到输出区域点击“添加固定输出选项”依次添加以下三个选项生活趣事冷笑话段子每个选项添加后会自动在提问器节点上生成一条对应的输出分支。用户在回答时可以从这三个选项中选择其中一个。五、配置大模型节点5.1 添加大模型节点在页面下方找到“添加节点”的加号点击后选择“大模型”即可创建一个大模型处理节点。5.2 连接提问器与大模型节点在提问器节点的配置面板中找到问答类型的各输出分支分别点击每个分支右侧的加号将所有输出分支都与大模型节点连接起来。这样无论用户选择哪个选项生活趣事、冷笑话、段子流程都会进入同一个大模型节点进行处理。5.3 配置大模型输入参数点击大模型节点在右侧配置面板中找到“输入”区域找到参数值右侧的设置图标齿轮图标在弹出的下拉列表中点击“提问器”选择userResponse即用户的回答结果作为输入变量这样大模型节点就能获取到用户选择的笑话类型并将其用于后续的 Prompt 生成。5.4 编写系统 Prompt在大模型配置面板中找到“系统 Prompt”输入框填入基础的系统提示词例如你是一个笑话创作助手根据用户选择的类型生成笑话。填写完成后可以点击输入框右侧的“优化”按钮系统会利用 AI 自动优化当前提示词使其更加专业有效。AI 优化后系统会在面板中展示优化结果。确认内容符合预期后点击“替换”按钮将优化后的提示词应用到当前节点。5.5 配置用户 Prompt在用户 Prompt 配置区域直接引用提问器节点的输出变量即可也就是使用上一个提问器节点生成的用户答案作为输入内容。说明通过引用变量的方式可以动态地将用户的选择内容插入到 Prompt 中实现个性化的大模型调用。六、配置结束节点6.1 连接大模型节点与结束节点完成大模型节点配置后将大模型节点的输出与结束节点的输入连接起来。点击结束节点在右侧配置面板中将输出设置成上一节点大模型节点的输出。6.2 配置回答内容在结束节点的“回答内容”配置项中引用大模型节点的输出变量即可也就是使用上一个大模型节点生成的内容作为最终回复。至此工作流的基本编排已完成。完整的节点流转关系如下节点类型说明开始节点开始工作流入口提问器节点提问器向用户提问收集选项回答大模型节点大模型根据用户选择生成笑话内容结束节点结束将大模型输出返回给用户七、试运行与调试7.1 启动试运行完成节点配置后点击页面底部的“试运行”按钮进入试运行界面再次点击“试运行”此时会弹出运行界面。根据官方文档说明运行成功的节点边框将显示为绿色用户可在页面右侧弹窗中查看节点的输入输出以及运行的调测树信息。7.2 模拟用户交互在弹出的运行界面中系统会按工作流逻辑展示提问器的问题并显示三个可供选择的选项。点击选择其中一个选项如冷笑话工作流会继续向下执行。7.3 查看运行结果工作流执行完毕后界面会显示大模型生成的笑话内容即工作流的最终输出结果。7.4 发布工作流测试通过后点击页面右上角的“上架”按钮将工作流发布到线上环境。注意根据官方文档开发者如需在智能体内使用该工作流必须先完成工作流的上架。只有调测成功的工作流方可发布上架上架后才能在智能体配置中被关联使用。八、工作流版本管理8.1 版本存档机制完成工作流开发后建议了解平台的版本管理功能。根据官方文档工作流版本管理工作流版本存档包含以下三种方式存档方式触发时机说明上架存档每次上架完成时自动记录到版本记录系统存档工作流编辑后自动保存为当前版本测试版本手动存档点击右上角【存档】图标填写存档描述后手动触发8.2 查看版本记录点击工作流右上角的【版本记录】图标可查看所有历史版本内容包括存档类型上架/系统/手动版本号存档描述操作人存档时间当版本较多时还可以根据版本类型筛选。8.3 预览与回退历史版本在版本记录列表中选择任意历史版本可进行以下操作查看版本点击版本或操作项中的【查看版本】进入只读预览模式试运行在预览模式下仍可执行试运行验证该版本的行为还原版本点击【还原到该版本】将该历史版本覆盖当前工作流的草稿注意若已还原版本中包含的知识库、插件、工作流已下架对应节点将显示失效状态需手动清理并替换节点资源后方可正常使用。九、工作流导入与导出9.1 功能说明根据官方文档导入导出工作流已创建的工作流支持导出导出的工作流文件可以导入到任意工作空间适用于跨账号复制工作流的场景。9.2 导出工作流操作步骤在工作流列表中找到目标工作流点击操作项中的【导出】按钮系统会将该工作流导出为JSON 文件文件包含了该工作流各节点的详细信息可直接用于导入提示如果工作流中包含工作流节点子工作流导出时系统会弹出提示询问是否需要一并导出子工作流。9.3 导入工作流操作步骤在工作流列表页点击右上角的【导入工作流】按钮上传导出的工作流 JSON 文件上传完成后系统会自动预填工作流名称、描述及图标确认信息无误后点击【导入】完成创建导入注意事项部分组件有效性与账号有关导入后插件、知识库、工作流等资源存在失效可能需手动清理并重新绑定。包含子工作流的情况需先将子工作流导入并上架再导入主工作流后重新关联子工作流方可正常使用。十、创建工作流模式智能体10.1 新建智能体工作流上架后需要将其关联到一个工作流模式的智能体才能对外提供服务。在工作空间页面点击“新建智能体”按钮在创建面板中按以下要求填写模式选择选择“工作流程模式”智能体名称填写展示名称如每日一笑描述简要介绍智能体的功能支持的设备和系统选择适配的设备类型分类选择合适的应用分类填写完成后点击“创建”按钮。10.2 配置开场对话进入智能体配置界面在开场对话配置区域设置开场语和开场场景引导帮助用户快速了解如何使用该智能体。10.3 关联工作流在智能体配置界面找到“工作流配置”区域点击“添加”按钮。在弹出的工作流选择器中从当前工作空间的工作流列表里找到刚刚上架的工作流点击“添加”完成关联。关联成功后在智能体的工作流配置区域会显示已关联的工作流信息。总结本文基于华为小艺开放平台官方文档完整介绍了工作流的开发与发布流程主要涵盖以下内容工作流的定位与 18 种节点类型说明新建工作流并在可视化画布中进行节点编排配置提问器节点实现主动向用户收集选项信息配置大模型节点完成系统 Prompt 填写与 AI 自动优化配置结束节点将大模型输出透传给用户通过试运行验证工作流的完整执行效果版本管理支持上架存档、系统存档与手动存档三种方式并可预览和回退历史版本导入导出将工作流导出为 JSON 文件实现跨账号迁移与备份创建工作流模式智能体并关联工作流完成发布下一篇将继续介绍鸿蒙智能体的更多能力包括知识库的创建与集成敬请期待。如果这篇文章对你有帮助欢迎点赞、收藏⭐、关注你的支持是我持续创作的动力相关资源小艺开放平台 Agent 文档首页开发工作流官方文档创建工作流官方文档工作流节点说明官方文档工作流版本管理官方文档导入导出工作流官方文档工作流/工作流配置官方文档
