mirror of
https://github.com/OpenBMB/ChatDev.git
synced 2026-04-25 11:18:06 +00:00
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` 中清晰说明期望的操作和关键词
|
||
- 使用条件边配合关键词实现流程控制
|
||
- 考虑添加超时机制避免工作流无限等待
|