Human Input 节点：将人工判断引入自动化工作流
文章分类：Release
摘要：Dify v1.13.0 正式发布 Human Input 节点。该功能将人工审核无缝嵌入自动化工作流，支持自定义表单、多路径分支与超时策略。让 AI 与人工高效协作，轻松实现复杂业务审批与决策。
工作流已从简单的“一键运行到底”流水线，演进至今日人机协同的核心枢纽。
过去，人们总假设工作流会从头跑到尾，中间绝不暂停。但现实中并非如此。内容团队需要在发布前审核 AI 生成的草稿。客服团队需要将边缘案例转交真人处理。许多业务流程也必须有专人签字确认，才能继续推进。
核心逻辑很明确：自动化能搞定大部分工作，但关键决策仍需人工介入。
Dify v1.13.0 正式引入 Human Input 节点，精准解决这一痛点。现在，人机交接已成为工作流的原生能力。
The Human Input Node
Human Input 是一个可直接拖拽到工作流画布上的节点。当执行流到达此处时，流程会自动暂停，并向指定人员发送表单。接收者查看信息、填写字段并点击决策按钮后，工作流便会沿对应分支继续运行。
与外挂独立的审批系统不同，Human Input 将“等待人工”的概念深度融入工作流底层。它与 LLM 节点、Knowledge Retrieval 节点一样，属于一等公民组件。拖入画布、连线配置、按需排布即可。
Configuration
配置 Human Input 节点主要关注三项内容：
Delivery Method（交付方式）
该设置决定表单如何送达指定人员。系统提供两种选项，适配不同场景：
- Web App：表单直接显示在应用界面内，当前用户可即时响应。适用于无需他人介入的场景，例如发布前审核 AI 内容，或在流程中途补充信息。
- Email：通过邮件将表单发送给指定人员。适用于操作者与决策者分离的场景。例如，处理敏感数据时，需经理审批后方可返回结果。支持自定义邮件主题与正文，并可添加工作区成员或外部邮箱作为收件人。
无论选择哪种方式，表单在收到首次回复后自动关闭，工作流随即恢复运行。
Form Content（表单内容）
表单是接收者实际查看和交互的界面，包含内容区域与决策按钮两部分。
内容区域支持 Markdown 语法，并可引用上游变量展示动态数据，例如用户原始提问或 LLM 生成的回答。
如需收集输入，按 ⌘/（Windows 为 Ctrl/）插入输入框。表单中会渲染为可编辑文本框。插入时命名该字段，该名称即可作为下游节点可调用的输出变量。
输入框支持预填。例如，直接填入 LLM 的草稿，方便接收者就地修改。也可留空，让接收者从头填写，例如撰写修改意见。
决策按钮定义接收者的下一步操作。你可自由设置按钮数量与标签。每个按钮对应一条分支，工作流将按点击结果走向指定路径。
上图展示了一个销售数据分析场景。用户提问后，LLM 生成分析报告，Human Input 节点暂停流程等待确认。
常规查询，操作者可通过 Web App 直接确认。若数据敏感需经理审批，则改用 Email 发送。
表单会并列展示用户提问与分析结果。接收者可留下备注，随后选择以下操作之一：
- Confirm（确认）：分析无误，数据可安全共享。将结果返回给请求者。
- Regenerate（重新生成）：将修改意见发回 LLM，生成全新分析。
- Forward（转发）：转交同事补充意见。
接收者点击按钮时，所有输入框的内容会作为变量随路径传递。例如点击“Regenerate”，修改意见将直接作为上下文传入下游的 LLM 节点。
Timeout Policy（超时策略）
人工响应往往存在延迟。你可设置等待时长，超时后工作流自动结束。或配置专用的超时分支优雅处理，例如发送提醒或将任务转交他人。
Walkthrough
接下来，我们通过一个完整示例，从头到尾演示 Human Input 的实际运作。
场景：企业销售数据分析。用户查询销售数据，LLM 生成报告。因数据敏感，返回前需经理审批。经理可批准、要求重做，或转交同事。若无人及时响应，任务将自动升级至备用审批人。
Data Prep and Analysis（数据准备与分析）
User Input 节点收集查询语句，例如“展示北美地区上月的销售表现”。Knowledge Retrieval 从销售知识库检索相关数据，LLM 1 生成分析报告。
分析已完成，但包含敏感数据，不能直接返回给用户。需先经过审批。
Human Input 1：经理审批
LLM 输出结果后，工作流在此暂停，等待经理处理。交付方式设为 Email，支持自定义主题、正文与收件人。审批人收到邮件后，点击链接即可打开表单。
表单会展示用户查询与 LLM 分析结果。底部设有评论输入框，供审批人留下反馈。该字段将作为输出变量，供下游节点调用。
系统预设了三个决策按钮：Confirm（批准）、Regenerate（要求修改）与 Forward（转交），分别对应独立分支。超时时间设为 3 天；若无人响应，请求将自动转发。
Branch Handling（分支处理）
-
分支 1：Confirm → Answer 1
审批通过。直接将 LLM 1 的分析报告返回给用户。 -
分支 2：Regenerate → LLM 2 → Answer 2
审批人在评论框填写修改意见并点击 Regenerate。LLM 2 会接收原始查询、数据、历史分析及评论变量，基于反馈生成全新结果。
- 分支 3：Forward / Timeout → Human Input 2
无论经理主动转交，还是触发超时，流程将进入第二轮审批，并邮件通知另一位同事。此次仅保留两个选项：Confirm 与 Decline，强制做出最终决定。
- Confirm → Answer 1：批准，返回结果。
- Decline / Timeout → Answer 3：拒绝或超时。返回提示：“无法完成请求，请联系管理员。”
该示例涵盖了最常见的审批模式：直接审批、带反馈的重生成、人工转交以及超时兜底。在实际使用中，你可自由调整分支数量与路由逻辑，以匹配业务需求。
Wrapping Up
Human Input 直击业务痛点。你不再需要为单一审批步骤单独搭建系统。人机协同的闭环现已完整嵌入工作流内部。
如果你正期待这一功能，欢迎升级至 v1.13.0 并亲自体验。我们非常期待在社区听到你的反馈。