Skip to content
工作流测试调试与智能体插件调用
功能概述
工作流支持在编辑器中直接试运行，并通过调试面板查看每个节点的执行情况。验证通过后，可以把工作流配置为大模型智能体插件，让智能体在对话中调用。 
试运行前提
试运行前请确认：
- 工作流已完成节点连接
- 开始节点输入字段已配置
- 必填输入已填写或能在试运行参数中填写
- 选择器节点已配置条件和否则分支
- 推送节点的 Webhook、请求体等配置已补齐
- 页面 WebSocket 已连接
如果 WebSocket 未连接，试运行抽屉会提示当前无法开始试运行。
发起试运行
- 打开工作流编辑器
- 点击底部工具栏的「试运行」
- 在试运行参数抽屉中填写开始节点输入
- 点击「开始试运行」
- 打开「调试」面板查看执行结果
如果开始节点没有配置输入参数，试运行抽屉会提示「开始节点未配置输入参数」。这种工作流仍可运行，但无法从外部传入动态数据。
调试面板
点击底部工具栏的「调试」可以打开调试面板。调试面板包含：
1. 执行摘要
顶部展示本次试运行状态、耗时和 testRunId。
常见状态包括：
- RUNNING：正在执行
- SUCCESS：执行成功
- FAILED：执行失败
- DISCONNECTED：WebSocket 断开导致中断
2. 调试记录
如果存在多次试运行记录，可以通过下拉框切换查看历史记录。
3. 执行列表
左侧展示本次执行经过的节点。每个节点会显示：
- 节点名称
- 节点类型
- 执行状态
- 执行耗时
点击某个节点可以查看节点详情。
4. 节点详情
右侧展示当前节点的详细信息：
- 输入：节点执行时接收到的数据
- 输出：节点执行后产生的数据
- 日志：节点执行过程中的日志
- 分支轨迹：选择器等分支节点的命中情况
- 错误信息：节点失败时的错误原因
常见调试问题
节点提示未连接
说明节点没有任何连线。请检查该节点是否应该连接到上游或下游节点。
工作流存在环路
说明节点连接形成了循环。工作流不允许出现环路，请调整连线方向。
输入变量未定义
说明当前节点引用了不可用变量。请确认该变量来自上游节点，并且上游节点已经连接到当前节点之前。
选择器没有命中预期分支
请检查：
- 条件变量是否选择正确
- 变量类型是否正确
- 操作符是否适合当前变量类型
- 比较值是否和实际输入一致
- 前面的条件是否已经提前命中
推送失败
请检查：
- Webhook 或请求 URL 是否正确
- 请求头和请求体格式是否符合外部接口要求
- 网络是否能访问目标地址
- 是否需要鉴权
- 是否开启了忽略异常
配置为大模型智能体插件
工作流验证通过后，可以在大模型智能体中配置为插件。
使用步骤
- 进入大模型智能体配置页面
- 打开插件相关配置
- 点击新增或编辑插件
- 插件类型选择「工作流」
- 在「工作流」下拉框中选择已有工作流
- 如需新建，点击「新增工作流」
- 如需调整，点击「编辑工作流」
- 填写插件名称和描述
- 填写插件提示词
- 配置执行中语音
- 查看输入字段和输出字段
- 保存插件和智能体配置
插件字段说明
类型
选择「工作流」后，插件会绑定一个工作流，并展示该工作流的输入输出字段。
名称
插件名称用于标识能力。建议使用动宾结构，例如“查询通话详情”“推送客户意向”。
描述
描述会帮助智能体判断什么时候使用插件。建议写清楚：
- 这个插件能做什么
- 什么情况下应该调用
- 需要哪些输入
- 会返回什么结果
工作流
选择要绑定的工作流。选择后，系统会读取该工作流的开始节点输入字段和结束节点输出字段。
插件提示词
插件执行完成后补充给模型的提示词。可以说明模型应该如何使用工作流返回结果。
例如：
text
请根据工作流返回的通话分析结果，总结客户意向、关键信息和下一步跟进建议。执行中语音
插件执行期间播报给用户的等待语音。建议简短自然。
例如：
text
我正在查询相关信息，请稍等。输入字段
输入字段来自工作流开始节点。字段名、类型、是否必填和描述会展示在插件配置中。
输出字段
输出字段来自工作流结束节点。智能体会根据这些字段理解工作流返回的数据。
插件调用建议
- 插件描述要具体：不要只写“工作流插件”，应说明业务能力。
- 开始节点输入不要过多：输入越多，智能体越难稳定补齐。
- 结束节点输出要结构化：字段名和描述应便于模型理解。
- 执行中语音要短：避免用户等待时听到过长播报。
- 先试运行再绑定：确认工作流能独立运行，再交给智能体调用。
- 绑定后做文本测试和语音测试：确保智能体能在真实对话中正确触发插件。