工作流编排

《扣子编程从零开始搭建智能体 卢欣欣 清华大学出版社》【摘要 书评 试读】- 京东图书《扣子编程从零开始搭建智能体》全书案例持续更新-CSDN博客本节将以“生成文章摘要”工作流为例介绍扣子工作流的构建过程带领读者从认识可视化编排空间、通过节点操作搭建逻辑“骨架”到深入变量配置、打通数据“血脉”再到测试与发布完整体验工作流从无到有的全生命周期。3.3.1 工作空间新建工作流或在资源库中单击某个工作流名称后扣子平台将进入工作流可视化编排页面如图3-4所示。该页面的布局主要由画布主体区域和工具栏下方区域两个核心区域构成。其中画布是页面的核心工作区用户主要在此区域中通过拖拽节点、连接节点来构建和编排工作流的业务逻辑工具栏位于画布下方集成了辅助编排的各项快捷功能包括切换交互模式、添加注释、优化布局、导出为图片、查看缩略图、添加节点、调试工作流、工作流试运行等。图3-4 工作流编排页面3.3.2 节点基本操作新建工作流后系统会默认初始化一个“开始”节点和一个“结束”节点分别作为整个流程的数据输入与输出端口。节点的基本操作主要包含添加节点、建立连接和设置参数下面将分别介绍这些操作方法。1.添加节点在编排页面的下方工具栏中单击“添加节点”按钮系统会弹出节点类型菜单选中目标节点即可将其添加到画布中。例如在“生成文章摘要信息”的工作流中生成文章摘要的工作由大模型来完成因此此处需要添加一个大模型节点如图3-5所示在“添加节点”菜单中选择“大模型”节点。图3-5 添加节点单击“大模型”后画布中即可添加一个大模型节点如图3-6所示。节点添加成功后用户可手动拖拽调整其位置也可直接单击工具栏中的“优化布局”按钮由系统自动对齐和排列画布中的所有节点。图3-6 添加大模型节点直接在源节点的连接点上按住鼠标左键将连线拖拽至画布的空白区域后松开系统同样会弹出“选择节点”菜单。通过此方法新建的节点系统会自动为其与源节点建立连接线省去了后续手动连线的步骤操作更为高效。读者可自行操作一下。2.建立连接通过工具栏添加到画布的节点在初始状态下是相互独立的。只有通过“连线”将各个节点按业务逻辑串联起来数据才能流转工作流也才能按照既定的先后顺序执行。将鼠标指针移至源节点前置节点右侧的连接点按住左键拖拽至目标节点后置节点左侧的连接点后松开即可完成连线的建立。单击连接线按“delete”键可删除不需要的连接。在“生成文章摘要”的工作流中。大模型的前置节点为“开始”后置节点为“结束”。按照上述方法先将“开始”节点连接至“大模型”节点再将“大模型”节点连接至“结束”节点。完成连接后的工作流如图3-7所示。图3-7 建立连接3.设置参数添加节点并完成连接后仅搭建了工作流的“骨架”。要使工作流真正运转还需要进行参数设置即赋予各节点具体的执行指令与数据处理。尽管不同类型节点的参数各异但其设置方法基本一致。在画布中单击目标节点页面右侧即可弹出该节点的配置对话框所有的参数配置均在此处完成。以“生成文章摘要”工作流为例单击画布中的“大模型”节点右侧配置对话框中展示了该节点的可配置项主要包括模型选择如豆包、DeepSeek、GLM等、系统提示词、用户提示词等如图3-8所示。图3-8 设置参数系统提示词用于为大模型提供全局性的系统级指导主要用于设定人设、任务边界与回复逻辑。例如可输入“你是一个专业的文本摘要提取专家请根据用户提供的文章内容生成一段100字左右的精炼摘要。”3.3.3 数据流转工作流节点之间的连线不仅定义了任务的执行顺序更是数据流动的“管道”。这种在节点之间传递的数据在扣子平台中被称为“变量”。理解并正确配置变量是让工作流真正运转起来的关键。按照数据流向的不同变量可以分为输入变量和输出变量两类。输入变量节点执行任务所需要的“原材料”。它的值可以是上游节点通过连线传递过来的动态数据也可以是开发者在配置对话框中手动填写的固定文本。输出变量节点完成任务后产出的“成品”。节点处理完输入的数据后会将结果封装在输出变量中以便传递给下一个节点继续处理。外部数据首先进入“开始”节点的输入变量随后依次流经各个中间处理节点的输入与输出变量最终汇聚到“结束”节点的输入变量并输出给用户从而形成一条完整的数据链路。接下来基于前文搭建的“生成文章摘要”工作流骨架介绍如何通过配置变量打通节点间的数据链路。1配置开始节点单击“开始”节点在右侧参数配置对话框中进行如下设置如图3-9所示。步骤1修改变量标识将默认变量名“input”修改为“article_content”做到见名知意并勾选“必填”选项。步骤2展开详细配置单击变量所在行右侧的图标显示详细配置项。步骤3添加描述信息填写该变量的用途说明如“用户输入的待提取摘要的原始文章”这有助于大模型更好地理解参数上下文。大模型节点默认有一个名为input的输入参数还可以单击“输入”右侧的“”添加输入新的变量。图3-9 设置开始节点的输入参数2配置大模型节点大模型节点的参数较多本例中仅配置和数据流转相关的几个参数如输入参数、用户提示词及输出。用户提示词是用户在对话界面主动输入、发送给智能体的指令与问题是触发智能体响应与功能调用的直接入口。在普通单轮对话中用户提示词是用户直接输入的文字但在工作流场景下它通常是一个“固定指令文本动态输入变量”的组合体。它充当了将上游数据具体化为大模型指令的“组装模板”。单击“大模型”节点在右侧参数配置对话框中设置相关参数如图3-10所示。图3-10 设置大模型节点的输入参数配置大模型节点的具体操作步骤如下。步骤1绑定输入变量单击输入变量input右侧的引用按钮在弹出的下拉列表中选择“开始”节点下的“article_content”即将开始节点接收的数据传递给大模型节点作为其输入变量。步骤2设置用户提示词在“用户提示词”输入框中输入指令例如“请提取以下文章内容的摘要{{input}}”。此处通过将“任务指令提取摘要”与“动态数据{{input}}”在自然语言层面进行强行绑定让大模型既明白数据是什么又明白要对数据执行什么操作。需要注意的是此处的“{{input}}”引用的是大模型的输入变量“input”因此必须与大模型节点的输入变量名保持一致。在实际输入时只需要在英文输入法状态下键入左半边大括号 “{”系统便会自动弹出变量补全提示单击选择相应变量即可完成快速拼接如图3-11所示。图3-11 拼接输入变量完成上述配置后当工作流被触发运行时系统会自动将“开始”节点接收到的真实文章文本替换掉{{input}}占位符从而将动态数据真正交予大模型处理。大模型节点的“输入变量”主要用于在底层建立节点间的数据传输通道而在“用户提示词”中拼接变量则是为了将动态数据嵌入到自然语言指令中为其赋予具体的语义上下文。只有将数据放入提示词模板中大模型才能准确地理解它拿到的是什么数据、需要执行什么操作而不仅是一个冷冰冰的参数值。大模型节点默认有一个名为“output”的输出变量可以在输出区域中配置输出的格式支持文本、Markdown、JSON三种格式的输出默认为JSON格式如图3-12所示。图3-12 大模型节点的输出配置3配置结束节点作为工作流的最终出口“结束”节点的配置相对简单。其核心在于设定工作流向用户交付结果平台提供了“返回变量”和“返回文本”两种模式。返回变量直接将上游节点传递过来的变量本身作为最终结果输出适用于无需额外加工、直接输出数据的场景。返回文本允许开发者自定义一段文本模板并在其中通过{{变量名}}的语法灵活引用上游变量。这种方式常用于对最终结果进行格式化包装比如在摘要前加上“以下是为您生成的摘要”等引导语使工作流按照预设的样式和结构输出提升用户的阅读体验。单击结束节点然后在右侧参数配置对话框中单击输出变量output右侧的引用按钮在弹出的下拉列表中选择“大模型”节点下的“output”作为输出变量如图3-13所示。图3-13 输出节点的配置