wehub-resource-sync
d0e4308def
Validate YAML Workflows / Validate YAML Configuration Files (push) Has been cancelled
115 lines
2.7 KiB
Markdown
Executable File
115 lines
2.7 KiB
Markdown
Executable File
# Human 节点
|
|
|
|
Human 节点用于在工作流执行过程中引入人工交互，允许用户在 Web UI 中查看当前状态并提供输入。这种节点会阻塞工作流执行，直到用户提交响应。
|
|
|
|
## 配置项
|
|
|
|
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|
|
|------|------|------|--------|------|
|
|
| `description` | text | 否 | - | 显示给用户的任务描述，说明需要人工完成的操作 |
|
|
|
|
## 核心概念
|
|
|
|
### 阻塞等待机制
|
|
|
|
当工作流执行到 Human 节点时：
|
|
1. 工作流暂停，等待人工输入
|
|
2. Web UI 显示当前上下文和任务描述
|
|
3. 用户在界面中输入响应
|
|
4. 工作流继续执行，将用户输入传递给下游节点
|
|
|
|
### 与 Web UI 交互
|
|
|
|
- Human 节点在 Launch 界面以对话形式呈现
|
|
- 用户可以查看之前的执行历史
|
|
- 支持附件上传（如文件、图片）
|
|
|
|
## 何时使用
|
|
|
|
- **审核确认**：让人工审核 LLM 输出后继续
|
|
- **修改意见**：收集用户对生成内容的修改建议
|
|
- **关键决策**：需要人工判断才能继续的分支
|
|
- **数据补充**：需要用户提供额外信息
|
|
- **质量把关**：在关键节点引入人工质检
|
|
|
|
## 示例
|
|
|
|
### 基础配置
|
|
|
|
```yaml
|
|
nodes:
|
|
- id: Human Reviewer
|
|
type: human
|
|
config:
|
|
description: 请审阅上述内容，如满意请输入 ACCEPT，否则输入修改意见。
|
|
```
|
|
|
|
### 人机协作循环
|
|
|
|
```yaml
|
|
nodes:
|
|
- id: Article Writer
|
|
type: agent
|
|
config:
|
|
provider: openai
|
|
name: gpt-4o
|
|
api_key: ${API_KEY}
|
|
role: 你是一位专业作家，根据用户要求撰写文章。
|
|
|
|
- id: Human Reviewer
|
|
type: human
|
|
config:
|
|
description: |
|
|
请审阅文章：
|
|
- 满意结果请输入 ACCEPT 结束流程
|
|
- 否则输入修改意见继续迭代
|
|
|
|
edges:
|
|
- from: Article Writer
|
|
to: Human Reviewer
|
|
- from: Human Reviewer
|
|
to: Article Writer
|
|
condition:
|
|
type: keyword
|
|
config:
|
|
none: [ACCEPT]
|
|
case_sensitive: false
|
|
```
|
|
|
|
### 多阶段审核
|
|
|
|
```yaml
|
|
nodes:
|
|
- id: Draft Generator
|
|
type: agent
|
|
config:
|
|
provider: openai
|
|
name: gpt-4o
|
|
|
|
- id: Content Review
|
|
type: human
|
|
config:
|
|
description: 请审核内容准确性，输入 APPROVED 或修改意见。
|
|
|
|
- id: Final Reviewer
|
|
type: human
|
|
config:
|
|
description: 最终确认，输入 PUBLISH 发布或 REJECT 驳回。
|
|
|
|
edges:
|
|
- from: Draft Generator
|
|
to: Content Review
|
|
- from: Content Review
|
|
to: Final Reviewer
|
|
condition:
|
|
type: keyword
|
|
config:
|
|
any: [APPROVED]
|
|
```
|
|
|
|
## 最佳实践
|
|
|
|
- 在 `description` 中清晰说明期望的操作和关键词
|
|
- 使用条件边配合关键词实现流程控制
|
|
- 考虑添加超时机制避免工作流无限等待
|