Dify智能体开发：调试节点简介

Workflow / Chatflow 类型应用通常包含多个节点，每个节点互有关联。若要确保应用整体运行正常，需要确认每个节点的输入输出符合预期。

调试节点功能可以帮助开发者检测应用是否按照设计预期提供服务，提前发现并解决潜在问题，避免在生产环境中出现错误。

调试节点分为单步调试和逐步执行两种方法。

单步调试

方法简介

单步调试允许你对工作流内的特定节点进行独立测试，无需执行整个工作流。它可以帮助开发者在应用内添加新节点时验证其功能、排查特定节点的错误以及测试节点对不同输入的响应。

操作步骤

1. 在工作流编辑界面选择需要调试的节点
2. 在节点的设置页内填写输入变量
3. 点击执行按钮触发节点运行
4. 查看节点的输出结果及运行状态

示例

在工作流内添加 HTTP 节点，为验证该节点能否正确获取并处理 API 响应，你可以使用单步调试功能模拟节点的实际工作状态，确保能够正确向下游节点传递数据。

调试完成后，你可以“上次运行”页查看当前节点的运行状态、查看输入/输出、元数据信息。如遇报错，可通过报错信息快速排查错误，避免单个节点运行异常而导致整体运行失败。

回答、结束节点不支持单步调试。

逐步执行

方法简介

工作流的运行依赖于数据能够正确地从一个节点流转到下一个节点。若工作流较为复杂，该过程容易出错，常见问题包括：

• 数据格式不匹配（如文本传给了需要数字的节点）
• 变量配置错误
• JSON 数据解析失败
• 变量路径引用错误

逐步执行节点的调试方法能够帮助开发者在复杂的工作流应用内快速排查错误。

调试节点时，节点的输出变量将会被缓存至变量检查内。开发者可以直接在“变量检查”内修改变量，快速修改上游变量内的数据，验证不同数值对于下游节点的影响，

该方法适用于测试多个相互依赖的节点组合。

运行节点后，系统会自动将输出数据保存到”变量检查”视图中。你可以使用以下方法排除潜在问题：

1. 查看实际数据：对比节点输出的数据是否符合预期
2. 修改测试数据：直接在视图内修改变量值，测试对后续节点的影响
3. 验证数据流转：确认数据能正确传递到下游节点

操作步骤

1. 在调试模式中运行应用
2. 点击应用底部的变量检查，查看变量缓存
3. 定位需要调试的节点，查看它引用了哪个变量
4. 在变量检查内修改该变量的值，重新运行节点
5. 比对运行效果

示例

假设存在一个工作流：数据获取(A 节点) → 数据处理(B 节点) → 结果展示(C 节点)。

B 节点的功能完全依赖于 A 节点的输出数据，并且不同的数据将影响 B 节点的运行情况。

运行 A 节点后的输出变量值将保存至“变量检查”内。开发者可以修改“变量检查”内的数据，验证对于 B 节点的影响而无需手动再次运行 A 节点。

逐步执行过程中，你可以观察局部工作流的运行情况，基于结果及时调整节点的配置、数据流向和处理逻辑，确保工作流的效率和准确性。

查看节点运行记录

每个节点运行完成后都会生成操作记录，点击节点详情页中的 Last run 进行查看。

如需查看应用整体的运行历史，详细说明请参考运行历史。

《CDA数据分析师技能树系列图书》系统整合数据分析核心知识，从基础工具（如Python、SQL、Excel、Tableau、SPSS等）到机器学习、深度学习算法，再到行业实战（金融、零售等场景）形成完整体系。书中结合案例讲解数据清洗、建模、可视化等技能，兼顾理论深度与实操性，帮助读者构建系统化知识框架。同时，内容紧跟行业趋势，涵盖大数据分析、商业智能、ChatGPT与DeepSeek等前沿领域，还配套练习与项目实战，助力读者将知识转化为职场竞争力，是数据分析师从入门到进阶的实用参考资料。