chore: import upstream snapshot with attribution
Validate YAML Workflows / Validate YAML Configuration Files (push) Has been cancelled
Validate YAML Workflows / Validate YAML Configuration Files (push) Has been cancelled
This commit is contained in:
Executable
+114
@@ -0,0 +1,114 @@
|
||||
# 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` 中清晰说明期望的操作和关键词
|
||||
- 使用条件边配合关键词实现流程控制
|
||||
- 考虑添加超时机制避免工作流无限等待
|
||||
Reference in New Issue
Block a user