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

调试工作流

开发者可以在工作流创建完成后,直接与工作流进行交互,实时观察其执行过程和响应效果,并根据需要对配置进行优化和调整。平台提供的全链路调试功能,允许开发者查看每条用户请求从输入到响应的完整流程,包括意图识别、知识检索等详细信息,从而能够高效定位问题并快速调整配置。

Versatile支持对整个工作流进行调试,也支持对工作流的单个节点进行调试。

前提条件

创建工作流

约束与限制

试运行工作流时,端到端运行时间最长可执行10分钟。

试运行工作流(必选)

  1. 登录Versatile智能体平台,在左侧导航栏“个人空间”区域,选择目标空间。
  2. 单击左侧导航栏开发中心 > 应用管理 > 工作流应用
  3. 在工作流界面中找到目标工作流,并单击进入工作流编排页面。
  4. 试运行工作流。

    在工作流的开始节点中,默认包含一个输入参数query ,用于表示用户在本轮对话中输入的原始内容。您也可以根据需要添加其他参数,以供下游节点使用。因此,试运行工作流分为两种场景:一种是仅使用开始节点的默认输入参数query ,另一种是开始节点用户添加了其他参数。
    • 开始节点默认输入参数query时,工作流编排完成后,单击右上角“试运行”,在对话框中输入问题,等待返回试运行结果。
      图1 试运行工作流
      • 试运行界面支持文本输入、文件输入和语音输入:
        • 文本输入:在对话输入框输入对话后按Enter键或单击,查看应用响应结果。
        • 语音输入:全局配置中开启语音交互功能时,用户可以通过语音进行输入。该功能支持多种语言(如中文、英文等),并提供语音识别、错误纠正和实时反馈等功能。
          • 首次使用语音输入须开通系统麦克风、扬声器权限,可在权限申请弹窗一键开通。
          • 语音超过60秒,弹窗提示语音输入时长最长为60秒,取消语音输入状态,用户需重新录入。
      • 调试结果支持朗读功能,单击,应用将按照设置的音色将文字转换成语音播放。
      • 单击试运行页面左下角,一键清除试运行界面内容。
      • 文件输入:请参考开始节点配置参数,可增加“文件”“文件数组”类型,并在试运行界面中上传文件。
    • 开始节点用户添加了其他参数时,工作流编排完成后,单击右上角“试运行”,在对话框中输入问题,单击“开始运行”,等待返回试运行结果。
      图2 试运行工作流

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

    如果试运行失败,常见报错与解决方案请详见应用开发常见问题
    图3 调试结果示例

调试单节点

以调试“意图识别”节点为例:

  1. 在工作流编排页面,单击意图识别节点的,进入单节点调试页面。
  2. 输入参数内容,单击“开始运行”

    图4 编写输入参数内容

  3. “运行结果”页面,查看当前节点的运行结果。

    运行成功,节点处也将显示“运行成功”字样。

    运行失败,需要根据提示调整节点参数。
    图5 单节点调试运行成功示例

相关文档