试运行、对话调试与校验

自动保存只保存草稿，不代表流程可运行或已经发布。调试应覆盖单节点、完整流程和真实调用方三个层级，并保留实际节点状态、输入输出和调用链证据。

调试前准备

1. 确认顶部已经完成自动保存，避免测试到旧草稿。
2. 检查开始节点输入、结束节点输出和主路径连线。
3. 使用脱敏样本，不在测试参数中放真实密钥或用户隐私。
4. 为测试准备最小合法输入、边界输入和预期失败输入。
5. 外部资源节点确认当前账号与空间具有访问权限。

单节点测试

节点卡片上的 测试节点 适合隔离外部依赖和参数映射问题。测试时检查：

• 实际输入是否来自预期变量，空值与类型是否正确。
• 插件、模型、HTTP、数据库和知识库是否返回真实结果。
• 响应字段是否与节点声明的输出一致。
• 超时、鉴权失败、限流和非成功状态是否提供可见错误。
• 写入、更新或删除类节点是否只影响预期测试数据。

单节点通过不代表流程通过。条件分支、循环作用域和上游数据只有在全流程执行时才能完整验证。

普通工作流试运行

点击画布底部 试运行，右侧按开始节点定义生成输入表单，也可以切换到 JSON 模式输入结构化数据。

图 1：普通工作流试运行。执行后应查看实际经过的节点、最终输出和运行日志。

建议按以下顺序验证：

1. 用最小合法输入跑通主路径。
2. 核对条件分支是否命中预期路径。
3. 打开关键节点检查输入、输出、耗时和错误详情。
4. 核对结束节点返回是否符合对外契约。
5. 测试空值、非法枚举、超长文本、空数组、外部超时和权限不足。
6. 含问答节点时，按页面提示提交回答并确认流程能继续。

对话流调试

对话流通常需要先关联智能体或低代码应用，由调用方提供角色、会话和应用上下文。配置首轮输入后，进入对话调试并连续发送多轮消息。

图 2：对话流调试入口。未关联智能体或应用、必填输入缺失时，问题面板会阻止启动。

对话流需要额外验证：

• 首轮消息、连续追问、省略表达和话题切换。
• 会话历史读取范围、裁剪策略和角色消息顺序。
• 新会话是否与上一轮调试隔离。
• 不同用户、渠道和会话之间是否严格隔离。
• 会话与消息的创建、修改、查询和删除是否作用于正确主体。
• 问答节点、工具调用和最终回复能否在多轮过程中继续推进。

校验与问题面板

编辑器会检查节点配置和变量引用。常见问题包括：

类型	典型问题	处理方式
连线	节点未连接、路径无法到达结束节点	补齐连线或删除无效暂存节点
变量	来源不存在、字段路径错误、类型不匹配	回到来源节点核对实际输出和作用域
必填配置	未选模型、插件工具、知识库、数据库或子流程	重新选择当前空间可用资源
表达式	URL、JSON、提示词或条件表达式无效	使用实际样本验证解析结果
对话能力	未关联智能体/应用，角色或会话配置缺失	完成关联并重新创建调试会话
安全权限	资源无权限、鉴权过期、跨用户数据访问	修正授权与隔离规则，不绕过校验

页面未阻止发布，不等于问题可以忽略。暂存节点也应明确标注或移除，避免后续维护者误认为它属于主流程。

建议测试矩阵

场景	至少覆盖
正常输入	最小合法值、典型值、最大合理数据量
缺失输入	可选字段缺失、必填字段缺失、对象缺少子字段
类型边界	空字符串、零、负数、空数组、非法时间、错误文件类型
外部依赖	超时、限流、鉴权失败、资源下线、响应结构变化
分支与循环	每个分支、兜底分支、零次/一次/多次循环、最大批次
数据写入	重复请求、部分失败、幂等、用户与渠道隔离
对话流	新会话、多轮追问、历史裁剪、跨会话隔离

查看日志与定位失败

修复问题时优先保留以下证据：

• 本次运行使用的输入和运行时间。
• 实际经过的节点与失败节点。
• 失败节点收到的输入、返回的错误和状态码。
• 上游节点实际输出与变量映射。
• 调用的资源版本、权限主体和外部请求标识。

不要用无限重试、吞掉错误或无证据的兜底分支掩盖根因。修复后使用相同输入复测，再补一组能防止回归的边界输入。

发布前完成条件

• 问题面板没有未处理的阻断项。
• 单节点和完整流程都使用真实依赖验证过。
• 成功路径、关键异常路径和边界输入均符合预期。
• 开始/结束节点契约与调用方一致。
• 日志没有新增敏感信息泄露。
• 对话流已经完成多轮与隔离验证。

相关页面

• 配置节点与变量
• 发布、协作与运行