Dify 使用技巧与注意事项

本文档记录在使用 Dify 过程中发现的重要技巧、陷阱和注意事项。


🔄 工作流相关

⚠️ 子工作流引用更新问题

问题描述

当修改了被引用的子工作流后,调用该子工作流的父工作流不会自动使用最新版本,仍然运行的是旧版本。

具体案例

  • 某个子工作流中设置了 1000 字的限制
  • 修改子工作流,去掉了 1000 字限制
  • 父工作流调用该子工作流时,发现仍然有 1000 字的限制

解决方案

需要在父工作流中:

  1. 删除对该子工作流的引用
  2. 重新添加该子工作流的引用

这样才能使用子工作流的最新版本。

注意事项

  • ❌ 直接修改子工作流不会自动更新到父工作流
  • ✅ 必须删除引用后重新添加才能生效
  • 💡 建议在修改子工作流后,检查所有引用该子工作流的父工作流
  • 💡 如果有多个父工作流引用了该子工作流,需要逐一更新

最佳实践

  1. 修改子工作流前,先记录哪些父工作流引用了它
  2. 修改完成后,逐一更新所有引用
  3. 测试验证每个父工作流是否使用了最新版本

📝 工作流开发

参数限制

  • 文本参数默认可能有字符限制(如 1000 字)
  • 修改限制时注意更新所有引用位置

🔧 自定义工具

详见 Dify自定义工具格式说明


📊 工作流配置

详见 文生图工作流说明


📅 更新记录

  • 2025-12-31:添加子工作流引用更新问题说明