搭建产品结算工作流

准备工作

本实践选用平台预置的“Kimi-K2”模型。

创建工作流

1. 登录AgentArts智能体开发平台，在左侧导航栏“个人空间”区域，选择目标空间。
2. 单击左侧导航栏“开发中心 > 智能体管理 ”，选择“工作流”页签，单击右上角“创建工作流”。
3. 选择创建“对话型工作流”，在“创建对话型工作流”页面，配置工作流相关信息，参数如表1所示。

   表1 参数说明

   参数名称	示例	说明
   展示名称	产品结算	在工作流应用界面中展示名称不允许重复，支持中英文、数字、下划线、中划线和空格，长度2~64个字符，且名称首尾不能有空格。
   描述	产品结算	描述工作流的功能，可直观呈现给用户，长度0~256个字符。

4. 配置完成后单击“立即创建”，进入工作流编排页面。

编排工作流

在工作流编排页面，平台已预设了开始、大模型和结束节点。单击节点右上角的“”，可以对当前节点执行重命名、复制、删除操作。开始和结束节点为必选节点，不支持重命名、复制和删除。

图2 节点的重命名、复制、删除操作

1. 配置“开始”节点。

   单击“开始”节点，参考图3和表2完成参数配置。

   图3 配置开始节点
   

   表2 参数配置说明

   参数	配置示例	说明
   输入参数	定义以下输入参数，单击，添加参数。 count，类型为“String”，表示产品数量。 class类型为“String”，表示产品等级。 voucher类型为“String”，表示优惠比例。 productmodel类型为“String”，表示产品类别。	配置大模型处理需要的输入参数值， 这些值会动态添加到提示词中，默认设置的输入参数名为“query”。

2. 配置“大模型”节点，该节点将从用户输入中提取并解析问题，并用JSON格式输出。
   单击“大模型”节点，参考图4和表3完成参数配置。

   图4 配置大模型节点
   

   表3 参数配置说明

   参数	配置示例	说明
   模型配置	选择模型为“Kimi-K2”，单击模型配置区域右上角的可设置模型的温度、核采样、历史对话轮数、最大回复长度、重复语句惩罚等参数，本实践保持默认值。	选择模型接入模块已配置的大语言模型。
   输入参数	定义以下输入参数，单击，添加参数。 参数名称为“count”。 类型、值：选择“引用 > count”。count为“开始”节点的输入变量值。 参数名称为“class”。 类型、值：选择“引用 > class”。class为“开始”节点的输入变量值。 参数名称为“voucher”。 类型、值：选择“引用 > voucher”。voucher为“开始”节点的输入变量值。 参数名称为“productmodel”。 类型、值：选择“引用 > productmodel”。productmodel为“开始”节点的输入变量值。	配置大模型处理需要的输入参数值， 这些值会动态添加到提示词中，默认设置的输入参数名为“query”。
   输出参数	单击输出区域右上角的，选择输出格式为“JSON”。单击，添加参数。 定义以下输出参数，其余保持默认值即可。 参数名称为“price_total”，类型为“String”。描述为：汇总价格。 参数名称为“description”，类型为“String”。描述为：计算过程描述。	用于解析大模型节点的输出，并提供给后续节点的输出参数引用。
   系统提示词	输入系统提示词后单击“系统提示词”区域右上角的“”，进行提示词优化。 作为一个产品结算助手，你需要根据客户选择的产品类别（productmodel）、产品等级（class）、产品数量（count）以及优惠比例（voucher）来计算和汇总价格，要参考以下数据进行计算： 1、产品类别（productmodel）分为红茶，绿茶，普洱茶 2、产品等级（class）分为奢华、高级和普通三个级别 3、产品数量（count）需要客户输入整数 4、优惠比例（voucher）为折扣比例，如30%优惠，需要客户付全价的70% 基于以上计算，请结合以下标准进行价格计算 1、红茶，奢华级别，优惠比例{{voucher}}，产品单价5000元人民币 2、红茶，高级级别，优惠比例{{voucher}}，产品单价2000元人民币 3、红茶，普通级别，优惠比例{{voucher}}，产品单价600元人民币 4、绿茶，奢华级别，优惠比例{{voucher}}，产品单价3000元人民币 5、绿茶，高级级别，优惠比例{{voucher}}，产品单价1000元人民币 6、绿茶，普通级别，优惠比例{{voucher}}，产品单价300元人民币 7、普洱茶，奢华级别，优惠比例{{voucher}}，产品单价6000元人民币 8、普洱茶，高级级别，优惠比例{{voucher}}，产品单价3000元人民币 9、普洱茶，普通级别，优惠比例{{voucher}}，产品单价1000元人民币 约束条件 1、上述所有参数和变量均使用string类型，不可以使用其它类型 2、上述计算请提供详细计算过程，并对计算过程进行输出，输出为： {"description":"计算过程"}	配置输入给大模型的提示词，系统级提示词，用于指导模型按要求进行回复。支持使用{{variable}}格式引用当前节点输入参数中已定义好的参数。最终替换后的内容会传递给模型。
   用户提示词	输入如下内容 {{count}} {{class}} {{voucher}} {{productmodel}}	配置输入给大模型的提示词，用户级提示器，作为当前用户问题的输入。配置提示词时，支持使用{{variable}}格式引用当前节点输入参数中已定义好的参数。最终替换后的内容会传递给模型。

3. 配置“结束”节点，输出最终结果。
   单击“结束”节点，如图5配置输入参数和回复。

   图5 配置结束节点
   

   表4 参数配置说明

   参数	配置示例	说明
   输入参数	定义以下输入参数。 参数名称为result，类型为引用，值为引用大模型节点的输出。 参数名称为“result”。 类型、值：选择“引用 > price_total”。price_total为“大模型”节点的输出变量值。 参数名称为“description”。 类型、值：选择“引用 > description”。description为“大模型”节点的输出变量值。	输入参数支持引用和输入两种类型，输入参数需要在指定回复的文本框中以{{variable_name}}的形式进行插入才能返回。
   输出参数	-	输出参数将以变量形式返回，支持引用和输入两种类型。
   指定回复	计算过程描述： {{description}} 汇总价格：{{result}}	可以在文本框中编辑指定的回复内容，支持在文本中以{{variable_name}}的形式插入输入参数返回或直接返回输入参数。工作流的最终运行结果将按照指定回复中的内容返回。指定回复中不能插入输出参数。

   配置完成后的工作流如图6所示。

   图6 产品结算工作流全景图
   

调试工作流

1. 编排工作流完成后，在工作流编排界面单击右上角。
2. 在对话框中直接与工作流进行交互，实时观察其执行过程和响应效果，并根据需要对配置进行优化和调整。

   检查节点设置是否有误，常见节点报错可参考应用开发常见问题进行解决。

   图7 试运行配置
   
   图8 试运行
   

3. 在试运行过程中，可以单击右上角查看调试结果，包括运行结果与调用详情。
   图9 运行结果
   
   图10 调用详情
   
   必要时也可以针对工作流中的某个节点单独进行调试，以保证节点的成功运行。以调试“大模型”节点为例。

   1. 在工作流编排页面，单击“大模型”节点的“”，进入节点的调试页面。
   2. 在节点的“配置信息”输入请求参数的值，单击“开始运行”。
      图11 配置节点调试任务
      
   3. 单节点调试成功后，将在该节点显示“运行成功”字样及其运行时间。
      图12 单节点调试结果
      

发布工作流

1. 工作流试运行成功后，在工作流编排页面，单击右上角“提交版本”。
2. 输入版本号与版本描述，如图13所示。
   图13 发布工作流
   

相关文档

• 编排工作流时，画布相关的详细操作介绍，请参见创建工作流。
• 在创建和运行工作流时，可能会遇到的常见问题，请参见《常见问题》。