HITL 人工介入#

HITL（Human In The Loop）是 Dify Workflow 中的人工干预机制。当工作流执行到「人工干预」节点时，流程会暂停，等待用户在聊天界面中填写表单并确认后继续执行。

:::tip 版本要求 Dify v1.14.0 及以上版本支持此功能。:::

功能说明#

当工作流运行到人工干预节点时，聊天界面会自动显示一个表单卡片，包含：

• 表单内容：节点中配置的提示文字
• 输入字段：节点中定义的输入变量
• 操作按钮：如「通过」「驳回」等，由工作流配置决定
• 倒计时：剩余有效时间，超时后将无法提交

用户填写表单并点击按钮后，工作流会接收用户的输入并继续执行。

工作流程#

1. 用户在 Dify 后台的 Workflow 中配置「人工干预」节点
2. 用户在聊天界面中触发工作流执行
3. 当工作流运行到人工干预节点时，对话中会显示表单卡片
4. 用户填写输入字段，选择操作（如通过/驳回）
5. 提交后，工作流继续执行后续节点

使用方式#

无需任何额外配置。只要你的 Dify 应用中包含人工干预节点，Dify App Hub 会自动识别并在对话中渲染表单。

注意事项#

• 人工干预节点有有效期（由 Dify 后台配置），超时后表单将不可提交
• 提交后表单状态会锁定，等待工作流响应
• 如果提交失败（如网络异常），表单会显示错误信息，用户可重试
• 页面刷新后，Dify App Hub 会自动恢复中断的工作流状态，表单仍可正常操作