搭建产品采购工作流

前提条件

• 已搭建搭建产品筛选工作流。
• 已搭建搭建产品结算工作流。

准备工作

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

创建工作流

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

   表1 参数说明

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

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

编排工作流

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

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

1. 配置“开始”节点。
   单击“开始”节点，该节点已默认配置query参数，表示用户输入的内容。当前场景下无需新增参数。

   图3 配置开始节点
   

2. 配置“工作流”节点，该节点添加产品筛选工作流，用于提取产品信息，包括产品数量、品类、等级和折扣率。
   1. 单击“大模型”节点右上角的“”，选择删除，删除大模型节点。
   2. 单击“添加节点”，选择“工作流”。
   3. 在“添加工作流”页面单击“产品筛选”右边的。
      图4 添加工作流
      
   4. 单击产品筛选工作流节点，参考图5和表2完成参数配置。
      图5 产品筛选
      

      表2 工作流节点配置说明

      参数名称	配置示例	参数说明
      输入参数	默认参数名称为“query”。 类型、值：选择“引用 > query”。query为“开始”节点的中间变量值。	工作流节点的输入结构取决于子工作流定义的输入结构，不支持自定义设置 在工作流节点中您需要为输入参数指定数据来源，支持设置为固定值或引用上游节点的输出参数。
      输出参数	默认即可	工作流节点的输出结构取决于子工作流定义的输出结构，不支持自定义设置。 response_content为工作流固定输出参数。
      异常处理	默认即可	支持对节点的异常（如超时、调用失败等情况）进行处理，包括超时时间、重试次数、异常处理方式。 “超时时间”：支持用户配置超时时间，取值范围0.1~900，默认900。 “重试次数”：工作流节点不支持重试。 “异常处理方式”：配置异常处理方式。 中断流程：节点发生异常后，直接中断流程，不再运行后续节点。 返回设定内容：节点发生异常后，工作运行不会中断，用户可自定义设置需要返回的输出字段内容，必须是输出参数中已定义的字段，且格式为合法的JSON格式。 执行异常流程：节点发生异常后，工作流不会中断，而是会执行异常处理流程。用户可以在该运行异常的节点前新增节点，并为新增的异常分支配置相应的处理流程。

3. 配置“提问器”节点，该节点用于询问用户是否确认产品信息，并可对产品信息进行修改。
   1. 单击“添加节点”，选择“提问器”，添加“提问器”节点至编排页面，连接产品筛选“工作流”节点和“提问器”节点。
   2. 单击“提问器”节点，参考图6和表3完成参数配置。
      图6 配置提问器节点
      

      表3 参数配置说明

      配置类型	参数名称	示例	参数说明
      模式偏好	-	速度优先	效果优先：效果优先模式下，会开启时间增强和反思功能，提参成功率更高，时延会增加。 速度优先：速度优先模式下时延最低，提参成功率可能无法保障，速度优先模式下不开启时间增强和反思功能。
      模型配置	模型选择	选择模型为“DeepSeek-V3”，单击模型配置区域右上角的“”可设置模型的温度、核采样、最大回复长度参数，本实践保持默认值。	选择执行此节点的模型，支持设置模型在此节点中的生成多样性等参数配置，使模型效果更符合你的预期。 提问器模型用于接收用户自然语言，提取用户配置的输出参数，效果优先时还用于提取结果反思和纠正。
      参数配置	输入参数	单击“”，添加参数。 定义以下输出参数，其余保持默认值即可。 参数名称为“count”。 类型、值：选择“引用 > count”。count为产品筛选“工作流”节点的输出变量值。 参数名称为“class”。 类型、值：选择“引用 > class”。class为产品筛选“工作流”节点的输出变量值。 参数名称为“voucher”。 类型、值：选择“引用 > voucher”。voucher为产品筛选“工作流”节点的输出变量值。 参数名称为“productmodel”。 类型、值：选择“引用 > productmodel”。productmodel为产品筛选“工作流”节点的输出变量值。	设置需要添加到问题中的参数，参数值可以引用前置节点的输出参数，或设置为固定文本内容，可引用多个参数。
      	输出参数	定义以下输出参数，单击，添加参数。 参数名称为“count”， 展示名称为“产品数量”， 类型为“String”。 参数名称为“class”， 展示名称为“产品等级”， 类型为“String”。 参数名称为“voucher”， 展示名称为“优惠比例”， 类型为“String”。 参数名称为“productmodel”， 展示名称为“产品类型”， 类型为“String”。	该参数用于解析大模型节点的输出，并提供给后续节点的输出参数引用，支持多参数提取。
      问题配置	问题	产品数量:{{count}} 产品分级:{{class}} 优惠比例:{{voucher}} 产品类型:{{productmodel}} 请确认上述信息是否修改，如确认请输入"确认"，如修改请提供修改要求	该参数将在对话框中原样呈现给用户。如未配置此处，将由大模型根据输出参数描述，自动生成包含所有问题关键词的一个问题。
      	最大回复轮数	10	该参数用于设置与模型的最大交互次数，超过最大回复轮数还没有提取到参数则跳出提问器。
      高级配置	允许用户退出交互	开启	开启后，如果用户在与提问器的对话交互中，表达“中止对话”类的意图，系统会自动结束当前提问，并跳转至结束节点。
      	输出参数确认	开启	开启后，如果用户希望提问器参数提取完毕后进行用户确认，则开启此功能。
      	提取约束	默认即可	提供大模型额外的约束信息，用于更准确的提取参数，例如指定被提取参数的格式要求。 当单击图标时，填写“模板名称”、选择“行业”和“标签”后，可将提示词创建成模板并保存到提示词。 当单击图标时，可对系统提示词进行智能优化。 当单击图标时，系统会弹出“选择提示词”窗口，可在“提示词广场”或“组件库提示词”页签中进行选择。
      	追问模式	默认即可	追问模式用来配置，在多次交互过程中，系统返回的参数追问语句生成模式。 默认：使用默认内置追问模板生成追问语句，每次追问内容相同。 智能追问：使用大模型生成语义良好，表达丰富的追问语句，每次追问内容丰富多变。 自定义追问：按照自定义模板配置生成追问语句。‘{unextracted_cn_field_names}’不可修改或删除。每次追问内容相同。
      	追问显示枚举值	默认即可	开启后，如果参数设置了枚举值校验，将在提问器的追问中，提示设定的参数可选枚举值。
      	示例配置	默认即可	给大模型一段预期的参数提取示例，增强大模型对参数提取场景的理解。

4. 配置“提问器”节点，该节点用于询问用户是否需要进行价格计算。
   1. 单击“添加节点”，选择“提问器”，添加“提问器”节点至编排页面，连接“提问器”节点和“提问器_1”节点。
   2. 单击“提问器_1”节点，参考图7和表4完成参数配置。
      图7 配置提问器节点
      

      表4 参数配置说明

      配置类型	参数名称	示例	参数说明
      节点名称	-	默认即可。	只允许输入字母、数字、下划线，且不能以数字开头。 通过单击图标，可修改意图识别节点名称。 通过单击图标，可重命名意图识别节点名称，复制一个意图识别节点或删除意图识别节点。
      模式偏好	-	速度优先	效果优先：效果优先模式下，会开启时间增强和反思功能，提参成功率更高，时延会增加。 速度优先：速度优先模式下时延最低，提参成功率可能无法保障，速度优先模式下不开启时间增强和反思功能。
      模型配置	模型选择	选择模型为“DeepSeek-V3”，单击模型配置区域右上角的“”可设置模型的温度、核采样、最大回复长度参数，本实践保持默认值。	选择执行此节点的模型，支持设置模型在此节点中的生成多样性等参数配置，使模型效果更符合你的预期。 提问器模型用于接收用户自然语言，提取用户配置的输出参数，效果优先时还用于提取结果反思和纠正。
      参数配置	输入参数	单击“”，添加参数。 定义以下输出参数，其余保持默认值即可。 参数名称为“count”。 类型、值：选择“引用 > count”。count为“提问器”节点的输出变量值。 参数名称为“class”。 类型、值：选择“引用 > class”。class为“提问器”节点的输出变量值。 参数名称为“voucher”。 类型、值：选择“引用 > voucher”。voucher为“提问器”节点的输出变量值。 参数名称为“productmodel”。 类型、值：选择“引用 > productmodel”。productmodel为“提问器”节点的输出变量值。	设置需要添加到问题中的参数，参数值可以引用前置节点的输出参数，或设置为固定文本内容，可引用多个参数。
      	输出参数	-	该参数用于解析大模型节点的输出，并提供给后续节点的输出参数引用，支持多参数提取。
      问题配置	问题	产品数量:{{count}} 产品分级:{{class}} 优惠比例:{{voucher}} 产品类型:{{productmodel}} 是否需要为您提供成本计算？	该参数将在对话框中原样呈现给用户。如未配置此处，将由大模型根据输出参数描述，自动生成包含所有问题关键词的一个问题。
      	最大回复轮数	默认即可	该参数用于设置与模型的最大交互次数，超过最大回复轮数还没有提取到参数则跳出提问器。
      高级配置	允许用户退出交互	默认即可	开启后，如果用户在与提问器的对话交互中，表达“中止对话”类的意图，系统会自动结束当前提问，并跳转至结束节点。
      	输出参数确认	默认即可	开启后，如果用户希望提问器参数提取完毕后进行用户确认，则开启此功能。
      	提取约束	默认即可	提供大模型额外的约束信息，用于更准确的提取参数，例如指定被提取参数的格式要求。 当单击图标时，填写“模板名称”、选择“行业”和“标签”后，可将提示词创建成模板并保存到提示词。 当单击图标时，可对系统提示词进行智能优化。 当单击图标时，系统会弹出“选择提示词”窗口，可在“提示词广场”或“组件库提示词”页签中进行选择。
      	追问模式	默认即可	追问模式用来配置，在多次交互过程中，系统返回的参数追问语句生成模式。 默认：使用默认内置追问模板生成追问语句，每次追问内容相同。 智能追问：使用大模型生成语义良好，表达丰富的追问语句，每次追问内容丰富多变。 自定义追问：按照自定义模板配置生成追问语句。‘{unextracted_cn_field_names}’不可修改或删除。每次追问内容相同。
      	追问显示枚举值	默认即可	开启后，如果参数设置了枚举值校验，将在提问器的追问中，提示设定的参数可选枚举值。
      	示例配置	默认即可	给大模型一段预期的参数提取示例，增强大模型对参数提取场景的理解。

5. 配置“意图识别”节点，该节点负责根据用户输入判断是否需要进行价格计算，并根据判断结果执行相应的处理流程。
   1. 单击“添加节点”，选择“意图识别”，添加“意图识别”节点至编排页面，连接“提问器_1”节点和“意图识别”节点。
   2. 单击“意图识别”节点，参考图8和表5完成参数配置。
      图8 配置意图识别节点
      

      表5 参数配置说明

      参数	配置示例	说明
      节点名称	单击节点名称，修改节点名称为“意图识别”。	只允许输入字母、数字、下划线，且不能以数字开头。 通过单击图标，可修改意图识别节点名称。 通过单击图标，可重命名意图识别节点名称，复制一个意图识别节点或删除意图识别节点。
      模型配置	Kimi-K2 单击模型配置区域右上角的可设置模型的温度、核采样等参数，本实践保持默认值。	用于配置进行意图识别的大模型，可选择平台已接入的任一模型。
      输入参数	填写以下输入参数，单击，添加参数。 参数名称固定为“input”。 类型、值：选择“引用 > USER_RESPONSE”。USER_RESPONSE为“提问器_1”节点的输出变量值。	参数名称：默认名称input，为固定值，不可编辑。 类型、值：支持“引用”和“输入”两种类型。 引用：支持用户选择工作流中已包含的前置节点的输出变量值和全局配置中的记忆变量。 输入：支持用户自定义取值。
      意图配置	单击“意图配置”展开，通过单击“添加意图”，增加意图1： 是 说明： 其他意图，大模型闲聊，默认存在，不需要添加。	用于配置相关意图关键字信息，用户可以添加意图，意图类别默认为意图1、意图2...，意图数量最多为20个。 在意图输入框中输入意图描述信息，描述信息为针对该类别的描述语句或者关键词，也将作为大模型进行推理和分类的依据。 其他意图：用于控制用户输入意图无法识别的场景，如果推理分析后无法匹配预定义的意图分类，会默认走其他意图对应分支执行后续流程。
      高级配置	-	高级可选配置项，提供进阶开发者修改提示词，如果不配置将会使用系统默认值。 提示词：提示词的撰写可能影响到意图识别节点的准确性。 历史对话轮次：选择是否打开历史对话引用功能，默认为0即不会引用对话历史，配置N轮即可记录N轮对话的内容。 辅助识别：开启辅助识别后，优先通过知识库分类样例的精确匹配进行意图识别，提升意图识别节点的分类能力。
      输出参数	保持默认	输出参数为判断节点最后一轮的输出。

6. 配置“工作流”节点，该节点添加产品结算工作流，用于产品价格计算。
   1. 单击“添加节点”，选择“工作流”。
   2. 在“添加工作流”页面单击“产品结算”右边的。
      图9 添加工作流
      
   3. 连接“意图识别”节点的“是”分支和产品结算“工作流”节点，如图10所示。
      图10 连接“意图识别”节点和产品结算“工作流”节点
      
   4. 单击产品结算工作流节点，参考图11和表6完成参数配置。
      图11 产品结算
      

      表6 工作流节点配置说明

      参数名称	配置示例	参数说明
      输入参数	定义以下输出参数，单击，添加参数。 默认参数名称为“query”。 类型、值：选择“引用 > USER_RESPONSE”。USER_RESPONSE为“提问器_1”节点的输出变量值。 参数名称为“count”。 类型、值：选择“引用 > count”。count为“提问器”节点的输出变量值。 参数名称为“class”。 类型、值：选择“引用 > class”。class为“提问器”节点的输出变量值。 参数名称为“voucher”。 类型、值：选择“引用 > voucher”。voucher为“提问器”节点的输出变量值。 参数名称为“productmodel”。 类型、值：选择“引用 > productmodel”。productmodel为“提问器”节点的输出变量值。	工作流节点的输入结构取决于子工作流定义的输入结构，不支持自定义设置 在工作流节点中您需要为输入参数指定数据来源，支持设置为固定值或引用上游节点的输出参数。
      输出参数	默认即可	工作流节点的输出结构取决于子工作流定义的输出结构，不支持自定义设置。 response_content为工作流固定输出参数。
      异常处理	默认即可	支持对节点的异常（如超时、调用失败等情况）进行处理，包括超时时间、重试次数、异常处理方式。 “超时时间”：支持用户配置超时时间，取值范围0.1~900，默认900。 “重试次数”：工作流节点不支持重试。 “异常处理方式”：配置异常处理方式。 中断流程：节点发生异常后，直接中断流程，不再运行后续节点。 返回设定内容：节点发生异常后，工作运行不会中断，用户可自定义设置需要返回的输出字段内容，必须是输出参数中已定义的字段，且格式为合法的JSON格式。 执行异常流程：节点发生异常后，工作流不会中断，而是会执行异常处理流程。用户可以在该运行异常的节点前新增节点，并为新增的异常分支配置相应的处理流程。

7. 配置“消息”节点，该节点将产品价格计算结果发送给用户。
   1. 单击“添加节点”，选择“消息”，添加“消息”节点至编排页面，连接产品结算工作流节点和“消息”节点。
   2. 单击“消息”节点，参考图12和表7完成参数配置。
      图12 配置消息节点
      

      表7 参数配置说明

      参数	配置示例	说明
      输入参数	定义以下输入参数，单击可添加参数。 参数名称为“totalprice”。 类型、值：选择“引用 > response_content”。response_content为“产品结算”节点的输出变量值。	参数名称：只允许输入字母、数字、下划线，且不能以数字开头。 类型、值：支持“引用”和“输入”两种类型。 引用：支持用户选择工作流中已包含的前置节点的输出变量值和全局配置中的记忆变量。 输入：支持用户自定义取值。
      指定回复	展示给前端的消息内容，支持通过“{{}}”引用输入参数变量。 整体价格计算如下： {{totalprice}}	可撰写指定的回复信息，并支持以{{参数名称}}的形式插入变量。回复信息将在工作流执行到该节点时发送给用户。

8. 配置“结束”节点，输出最终结果。
   1. 连接“消息”节点、“意图识别”节点的“其他意图”分支到“结束”节点。
   2. 单击“结束”节点，如图13配置输入参数和回复。
      图13 配置结束节点
      

      表8 参数配置说明

      参数	配置示例	说明
      输入参数	单击输出区域右上角的。单击，添加参数。 定义以下输出参数，其余保持默认值即可。 “result”类型为“输入”。描述为：流程结束。	输入参数支持引用和输入两种类型，输入参数需要在指定回复的文本框中以{{variable_name}}的形式进行插入才能返回。
      输出参数	-	输出参数将以变量形式返回，支持引用和输入两种类型。
      指定回复	{{result}}	可以在文本框中编辑指定的回复内容，支持在文本中以{{variable_name}}的形式插入输入参数返回或直接返回输入参数。工作流的最终运行结果将按照指定回复中的内容返回。指定回复中不能插入输出参数。

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

      图14 产品采购工作流全景图
      

调试工作流

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

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

   图15 试运行1
   
   图16 试运行2
   

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

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

发布工作流

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

相关文档

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