产品筛选工作流

前提条件

• 已实名认证的华为账号或IAM用户。
• 已购买Versatile智能体平台。

准备工作

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

操作流程

创建工作流

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

   表1 参数说明

   参数名称	示例	说明
   展示名称	产品筛选	在工作流应用界面中展示名称不允许重复，支持中英文、数字、下划线、中划线和空格，长度2~64个字符，且名称首尾不能有空格。
   英文名称	productselect	输入内容只能包含英文字母、数字、下划线，并以字母开头，长度2~64个字符，且名称不能以下划线收尾。
   描述	产品筛选	描述工作流的功能，可直观呈现给用户，长度0~256个字符。

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

编排工作流

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

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

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

   图2 配置开始节点
   

2. 配置“提问器”节点，该节点负责从用户输入中提取产品信息。
   1. 单击“添加节点”，选择“提问器”，添加“提问器”节点至编排页面，连接“提问器”节点和“开始”节点。
   2. 单击“提问器”节点，参考图3和表2完成参数配置，单击“确定”。
      图3 配置提问器节点
      

      表2 参数配置说明

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

3. 配置“大模型”节点，该节点将从用户输入中提取并解析问题，并用JSON格式输出。
   1. 单击“添加节点”，选择“大模型”，添加“大模型”节点至编排页面，连接“大模型”节点和“提问器”节点。
   2. 单击“大模型”节点，参考图4和表3完成参数配置，单击“确定”。
      图4 配置大模型节点
      

      表3 参数配置说明

      参数	配置示例	说明
      模型配置	选择模型为“DeepSeek-V3”，单击模型配置区域右上角的可设置模型的温度、核采样、历史对话轮数、最大回复长度、重复语句惩罚等参数，本实践保持默认值。	选择模型接入模块已配置的大语言模型。
      输入参数	定义以下输入参数，单击，添加参数。 参数名称为“query”。 类型、值：选择“引用 > USER_RESPONSE”。USER_RESPONSE为“提问器”节点的输入变量值。	配置大模型处理需要的输入参数值， 这些值会动态添加到提示词中，默认设置的输入参数名为“query”。
      输出参数	单击输出区域右上角的，选择输出格式为“JSON”。单击，添加参数。 定义以下输出参数，其余保持默认值即可。 “count”类型为“String”。描述为：产品数量。 “class”类型为“String”。描述为：产品等级。 “voucher”类型为“String”。描述为：优惠比例。 “productmodel”类型为“String”。描述为：产品类型。	用于解析大模型节点的输出，并提供给后续节点的输出参数引用。
      系统提示词	输入系统提示词后单击“系统提示词”区域右上角的“”，进行提示词优化。 作为一名产品营销助手，请根据客户输入筛选出以下4个条件 1、productmodel：包括redtea、greentea、puertea三种产品类型，没有输入时保持为空值"" 2、class：分为奢华、高级和普通三个级别，其它类型保持为空值"" 3、count：输入产品数量 4、voucher：为折扣比例，使用xx%表示，100>xx>0，没有输入时，保留为空值""	配置输入给大模型的提示词，系统级提示词，用于指导模型按要求进行回复。支持使用{{variable}}格式引用当前节点输入参数中已定义好的参数。最终替换后的内容会传递给模型。
      用户提示词	输入如下内容 {{query}}	配置输入给大模型的提示词，用户级提示器，作为当前用户问题的输入。配置提示词时，支持使用{{variable}}格式引用当前节点输入参数中已定义好的参数。最终替换后的内容会传递给模型。

4. 配置“结束”节点，输出最终结果。
   1. 连接“知识检索”节点到“结束”节点。
   2. 单击“结束”节点，如图5配置输入参数和回复。
      图5 配置结束节点
      

      表4 参数配置说明

      参数	配置示例	说明
      输入参数	单击“”，添加参数。 定义以下输入参数，其余保持默认值即可。 参数名称为“count”。 类型、值：选择“引用 > count”。count为“大模型”节点的输出变量值。 参数名称为“class”。 类型、值：选择“引用 > class”。class为“大模型”节点的输出变量值。 参数名称为“voucher”。 类型、值：选择“引用 > voucher”。voucher为“大模型”节点的输出变量值。 参数名称为“productmodel”。 类型、值：选择“引用 > productmodel”。productmodel为“大模型”节点的输出变量值。	输入参数支持引用和输入两种类型，输入参数需要在指定回复的文本框中以{{variable_name}}的形式进行插入才能返回。
      输出参数	单击“”，添加参数。 定义以下输出参数，其余保持默认值即可。 参数名称为“count”。 类型、值：选择“引用 > count”。count为“大模型”节点的输出变量值。 参数名称为“class”。 类型、值：选择“引用 > class”。class为“大模型”节点的输出变量值。 参数名称为“voucher”。 类型、值：选择“引用 > voucher”。voucher为“大模型”节点的输出变量值。 参数名称为“productmodel”。 类型、值：选择“引用 > productmodel”。productmodel为“大模型”节点的输出变量值。	输出参数将以变量形式返回，支持引用和输入两种类型。
      指定回复	产品数量：{{count}} 产品等级：{{class}} 优惠比例：{{voucher}} 产品类型：{{productmodel}}	可以在文本框中编辑指定的回复内容，支持在文本中以{{variable_name}}的形式插入输入参数返回或直接返回输入参数。工作流的最终运行结果将按照指定回复中的内容返回。指定回复中不能插入输出参数。

调试工作流

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

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

   

   试运行界面支持文本输入、文件输入和语音输入：

   • 文本输入：在对话输入框输入对话后按Enter键或单击，查看应用响应结果。
   • 语音输入：全局配置中开启语音交互功能时，用户可以通过语音进行输入。该功能支持多种语言（如中文、英文等），并提供语音识别、错误纠正和实时反馈等功能。
     • 首次使用语音输入须开通系统麦克风、扬声器权限，可在权限申请弹窗一键开通。
     • 语音超过60秒，弹窗提示语音输入时长最长为60秒，取消语音输入状态，用户需重新录入。

   • 调试结果支持朗读功能，单击，应用将按照设置的音色将文字转换成语音播放。
   • 单击试运行页面左下角，一键清除试运行界面内容。
   • 文件输入：请参考开始节点配置参数，可增加“文件”或“文件数组”类型，并在试运行界面中上传文件。
   图6 试运行
   

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

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

发布工作流

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

3. 发布完成后跳转至“发布管理”页面，也可通过左侧导航栏中选择“开发中心 > 应用管理 > 单智能体应用”，单击目标应用，进入应用主页面，单击右上角“发布管理”按钮，可进入发布管理页面。

   在发布管理页面，网页发布渠道的操作列单击“发布”按钮后将出现“立即访问”、“复制链接”、“重新生成”文字按钮。这里可以通过两种方式访问工作流应用的网页应用链接，同时支持重新生成发布链接。

   图12 发布工作流
   
   • 立即访问：单击当前页面的“立即访问”按钮，可立即进入网页版应用。
     图13 立即访问网页应用
     
   • 复制链接：单击当前页面的“复制链接”按钮，可直接复制网页URL嵌入或分享到其他应用场景。
     图14 复制工作流应用访问地址
     
   • 重新生成：重新生成工作流应用发布链接。

相关文档

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