更新时间:2026-01-16 GMT+08:00
分享

产品结算工作流

前提条件

准备工作

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

操作流程

操作步骤

说明

创建工作流

通过填写必要的工作流基本信息,创建一个对话型的知识问答助手工作流。

编排工作流

配置意图识别节点、大模型节点、提问器节点、判断节点、消息节点以及结束节点,以形成一个完整的工作流应用。

调试工作流

输入信息并运行工作流,查看大模型的响应结果,优化配置,确保工作流的正确性和有效性。同时,可以查看详细的调试结果和调用详情。

发布工作流

调试成功后可以发布工作流,发布后可在“发布管理”页面查看API调用接口信息。

创建工作流

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

    表1 参数说明

    参数名称

    示例

    说明

    展示名称

    产品结算

    在工作流应用界面中展示名称不允许重复,支持中英文、数字、下划线、中划线和空格,长度2~64个字符,且名称首尾不能有空格。

    英文名称

    charge

    输入内容只能包含英文字母、数字、下划线,并以字母开头,长度2~64个字符,且名称不能以下划线收尾。

    描述

    产品结算

    描述工作流的功能,直观呈现给用户,长度0~256个字符。

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

编排工作流

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

图1 节点的重命名、复制、删除操作
  1. 配置“开始”节点。

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

    图2 配置开始节点
    表2 参数配置说明

    参数

    配置示例

    说明

    输入参数

    定义以下输入参数,单击,添加参数。

    • 默认参数名称为“query”,类型为“String”,表示用户输入的内容。
    • count,类型为“String”,表示产品数量。
    • class类型为“String”,表示产品等级。
    • voucher类型为“String”,表示优惠比例。
    • productmodel类型为“String”,表示产品类别。

    配置大模型处理需要的输入参数值, 这些值会动态添加到提示词中,默认设置的输入参数名为“query”

  2. 配置“大模型”节点,该节点将从用户输入中提取并解析问题,并用JSON格式输出。

    单击“大模型”节点,参考图3表3完成参数配置,单击“确定”。
    图3 配置大模型节点
    表3 参数配置说明

    参数

    配置示例

    说明

    模型配置

    选择模型为“DeepSeek-V3”,单击模型配置区域右上角的可设置模型的温度、核采样、历史对话轮数、最大回复长度、重复语句惩罚等参数,本实践保持默认值。

    选择模型接入模块已配置的大语言模型。

    输入参数

    定义以下输入参数,单击,添加参数。

    • 参数名称为“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)分为redtea,greentea,puertea 
    2、产品等级(class)分为 奢华、高级和普通三个级别 
    3、产品数量(count)需要客户输入整数 
    4、优惠比例(voucher)为折扣比例,如30%优惠,需要客户付全价的70%  
    
    基于以上计算,请结合以下标准进行价格计算 
    1、redtea,奢华级别,优惠比例{{voucher}},产品单价5000元人民币 
    2、redtea,高级级别,优惠比例{{voucher}},产品单价2000元人民币 
    3、redteat,普通级别,优惠比例{{voucher}},产品单价600元人民币 
    4、greentea,奢华级别,优惠比例{{voucher}},产品单价3000元人民币 
    5、greentea,高级级别,优惠比例{{voucher}},产品单价1000元人民币 
    6、greenteat,普通级别,优惠比例{{voucher}},产品单价300元人民币 
    7、puertea,奢华级别,优惠比例{{voucher}},产品单价6000元人民币 
    8、puertea,高级级别,优惠比例{{voucher}},产品单价3000元人民币 
    9、puerteat,普通级别,优惠比例{{voucher}},产品单价1000元人民币   
    
    约束条件 
    1、上述所有参数和变量均使用string类型,不可以使用其它类型 
    2、上述计算请提供详细计算过程,并对计算过程进行输出,输出为: {"description":"计算过程"}

    配置输入给大模型的提示词,系统级提示词,用于指导模型按要求进行回复。支持使用{{variable}}格式引用当前节点输入参数中已定义好的参数。最终替换后的内容会传递给模型。

    用户提示词

    输入如下内容

    {{count}} 
    {{class}} 
    {{voucher}} 
    {{productmodel}}

    配置输入给大模型的提示词,用户级提示器,作为当前用户问题的输入。配置提示词时,支持使用{{variable}}格式引用当前节点输入参数中已定义好的参数。最终替换后的内容会传递给模型。

  3. 配置“结束”节点,输出最终结果。

    1. 连接“知识检索”节点到“结束”节点。
    2. 单击“结束”节点,如图4配置输入参数和回复。
      图4 配置结束节点
      表4 参数配置说明

      参数

      配置示例

      说明

      输入参数

      定义以下输入参数。

      参数名称为result,类型为引用,值为引用大模型节点的输出。

      • 参数名称为“result”。

        类型、值:选择“引用 > price_total”。price_total为“大模型”节点的输出变量值。

      • 参数名称为“description”。

        类型、值:选择“引用 > description”。description为“大模型”节点的输出变量值。

      输入参数支持引用和输入两种类型,输入参数需要在指定回复的文本框中以{{variable_name}}的形式进行插入才能返回。

      输出参数

      -

      输出参数将以变量形式返回,支持引用和输入两种类型。

      指定回复

      计算过程描述: 
      {{description}} 
      汇总价格:{{result}}

      可以在文本框中编辑指定的回复内容,支持在文本中以{{variable_name}}的形式插入输入参数返回或直接返回输入参数。工作流的最终运行结果将按照指定回复中的内容返回。指定回复中不能插入输出参数。

调试工作流

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

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

    试运行界面支持文本输入、文件输入和语音输入:
    • 文本输入:在对话输入框输入对话后按Enter键或单击,查看应用响应结果。
    • 语音输入:全局配置中开启语音交互功能时,用户可以通过语音进行输入。该功能支持多种语言(如中文、英文等),并提供语音识别、错误纠正和实时反馈等功能。
      • 首次使用语音输入须开通系统麦克风、扬声器权限,可在权限申请弹窗一键开通。
      • 语音超过60秒,弹窗提示语音输入时长最长为60秒,取消语音输入状态,用户需重新录入。
    • 调试结果支持朗读功能,单击,应用将按照设置的音色将文字转换成语音播放。
    • 单击试运行页面左下角,一键清除试运行界面内容。
    • 文件输入:请参考开始节点配置参数,可增加“文件”“文件数组”类型,并在试运行界面中上传文件。
    图5 试运行

  3. 在试运行过程中,可以单击右上角查看调试结果,包括运行结果与调用详情。

    图6 运行结果
    图7 调用详情
    必要时也可以针对工作流中的某个节点单独进行调试,以保证节点的成功运行。以调试“大模型”节点为例。
    1. 在工作流编排页面,单击“大模型”节点的“”,进入节点的调试页面。
    2. 在节点的“配置信息”输入请求参数的值,单击“开始运行”。
      图8 配置节点调试任务
    3. 单节点调试成功后,将在该节点显示“运行成功”字样及其运行时间。
      图9 单节点调试结果

发布工作流

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

    图10 发布工作流

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

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

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

相关文档

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

相关文档