更新时间:2025-09-15 GMT+08:00
分享

调试工作流

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

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

前提条件

创建工作流

试运行工作流(必选)

  1. 工作流编排完成后,单击右上角“试运行”,在对话框中输入问题,等待返回试运行结果。

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

    • 文本输入:在对话输入框输入对话后按Enter键或单击,查看应用响应结果。
    • 语音输入:全局配置中开启语音交互功能时,用户可以通过语音进行输入。该功能支持多种语言(如中文、英文等),并提供语音识别、错误纠正和实时反馈等功能。
      • 首次使用语音输入须开通系统麦克风、扬声器权限,可在权限申请弹窗一键开通。
      • 语音超过60秒,弹窗提示语音输入时长最长为60秒,取消语音输入状态,用户需重新录入。
    • 文件输入:用户可以通过上传文件进行提问,支持对文件进行解析,并根据文件内容和问题生成准确的答案。
      • 支持上传image、audio、excel、csv、docx等格式的文件。
      • 最多支持上传10个文件。
    图1 试运行工作流
    • 调试结果支持朗读功能,单击,应用将按照设置的音色将文字转换成语音播放。
    • 单击试运行页面左下角,一键清除试运行界面内容。

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

    如果试运行失败,常见报错与解决方案请详见工作流常见问题
    图2 调试结果示例
    • 单击调用详情页面中的按钮可查看列表调用链。
    • 单击调用详情页面中的按钮可查看火焰图调用链。
    • 支持在调用链管理页面中,查看该调用链的详细信息,具体操作请参见使用过滤器筛选信息

调试单节点

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

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

    图3 编写输入参数内容

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

    运行成功,节点处也将显示“运行成功”字样。
    图4 单节点调试运行成功示例

相关文档