子场景3：客服支持工作流

前提条件

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

准备工作

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

操作流程

创建工作流

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

   表1 参数说明

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

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

编排工作流

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

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

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

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

      表2 参数配置说明

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

3. 配置“意图识别”节点，该节点负责判断用户输入的问题属于服务支持类还是投诉类，并根据判断结果执行相应的处理流程。
   1. 单击“添加节点”，选择“意图识别”，添加“意图识别”节点至编排页面，连接“意图识别”节点和“开始”节点。
   2. 单击“意图识别”节点，参考图4和表3完成参数配置，单击“确定”。
      图4 配置意图识别节点
      

      表3 参数配置说明

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

4. 配置“消息”节点，当意图识别为服务支持类时，执行该消息节点分支，向用户发送服务支持类回复消息。
   1. 单击“添加节点”，选择“消息”，添加“消息”节点至编排页面，连接“消息”节点和“意图识别”节点。
   2. 单击“消息”节点，参考图5和表4完成参数配置，单击“确定”。
      图5 配置消息节点
      

      表4 参数配置说明

      参数	配置示例	说明
      输入参数	定义以下输入参数，单击可添加参数。 参数名称为“query”。 类型、值：选择“引用>USER_RESPONSE”。USER_RESPONSE为“提问器”节点的输出变量值。	参数名称：只允许输入字母、数字、下划线，且不能以数字开头。 类型、值：支持“引用”和“输入”两种类型。 引用：支持用户选择工作流中已包含的前置节点的输出变量值和全局配置中的记忆变量。 输入：支持用户自定义取值。
      指定回复	展示给前端的消息内容，支持通过“{{}}”引用输入参数变量。 好的，已经了解您的要求：{{query}}，我们尽快安排人员处理！	可撰写指定的回复信息，并支持以{{参数名称}}的形式插入变量。回复信息将在工作流执行到该节点时发送给用户。

5. 配置“消息”节点，当意图识别为投诉类时，执行该消息节点分支，向用户发送投诉类回复消息。
   1. 单击“添加节点”，选择“消息”，添加“消息”节点至编排页面，连接“消息”节点和“意图识别”节点。
   2. 单击“消息”节点，参考图6和表5完成参数配置，单击“确定”。
      图6 配置消息节点
      

      表5 参数配置说明

      参数	配置示例	说明
      节点名称	单击节点名称旁边的“”，修改节点名称为“消息_1”，并单击名称后的“”。	只允许输入字母、数字、下划线，且不能以数字开头。 通过单击图标，可修改节点名称。 通过单击图标，可重命名节点名称，复制一个节点或删除节点。
      输入参数	定义以下输入参数，单击可添加参数。 参数名称为“query”。 类型、值：选择“引用>USER_RESPONSE”。USER_RESPONSE为“提问器”节点的输出变量值。	参数名称：只允许输入字母、数字、下划线，且不能以数字开头。 类型、值：支持“引用”和“输入”两种类型。 引用：支持用户选择工作流中已包含的前置节点的输出变量值和全局配置中的记忆变量。 输入：支持用户自定义取值。
      指定回复	展示给前端的消息内容，支持通过“{{}}”引用输入参数变量。 已了解您的诉求：{{query}}，我们马上派人处理！	可撰写指定的回复信息，并支持以{{参数名称}}的形式插入变量。回复信息将在工作流执行到该节点时发送给用户。

6. 配置“结束”节点，输出最终结果。
   1. 连接“消息”节点、“意图识别”节点、“消息_1”节点到“结束”节点。
   2. 单击“结束”节点，如图7配置输入参数和回复。
      图7 配置结束节点
      

      表6 参数配置说明

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

调试工作流

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

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

   

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

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

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

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

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

发布工作流

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

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

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

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

相关文档

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