mirror of
https://github.com/OpenBMB/ChatDev.git
synced 2026-04-25 11:18:06 +00:00
141 lines
3.0 KiB
Markdown
Executable File
141 lines
3.0 KiB
Markdown
Executable File
# Literal 节点
|
||
|
||
Literal 节点用于输出固定的文本内容。当节点被触发时，它会忽略所有输入，直接输出预定义的消息。
|
||
|
||
## 配置项
|
||
|
||
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|
||
|------|------|------|--------|------|
|
||
| `content` | text | 是 | - | 输出的固定文本内容，不能为空 |
|
||
| `role` | string | 否 | `user` | 消息角色：`user` 或 `assistant` |
|
||
|
||
## 核心概念
|
||
|
||
### 固定输出
|
||
|
||
Literal 节点的特点：
|
||
- **忽略输入**：不管上游传入什么内容，都不影响输出
|
||
- **固定内容**：每次执行都输出相同的 `content`
|
||
- **角色标记**：输出消息带有指定的角色标识
|
||
|
||
### 消息角色
|
||
|
||
- `user`：表示这是用户发出的消息
|
||
- `assistant`：表示这是助手（AI）发出的消息
|
||
|
||
角色设置会影响下游节点对消息的处理方式。
|
||
|
||
## 何时使用
|
||
|
||
- **固定提示注入**：向流程中注入固定的指令或上下文
|
||
- **测试调试**：使用固定输入测试下游节点
|
||
- **默认响应**：在特定条件下返回固定消息
|
||
- **流程初始化**：作为工作流的起点提供初始内容
|
||
|
||
## 示例
|
||
|
||
### 基础用法
|
||
|
||
```yaml
|
||
nodes:
|
||
- id: Welcome Message
|
||
type: literal
|
||
config:
|
||
content: |
|
||
欢迎使用智能助手！请描述您的需求。
|
||
role: assistant
|
||
```
|
||
|
||
### 注入固定上下文
|
||
|
||
```yaml
|
||
nodes:
|
||
- id: Context Injector
|
||
type: literal
|
||
config:
|
||
content: |
|
||
请注意以下规则：
|
||
1. 回答必须简洁明了
|
||
2. 使用中文回复
|
||
3. 如有不确定，请说明
|
||
role: user
|
||
|
||
- id: Assistant
|
||
type: agent
|
||
config:
|
||
provider: openai
|
||
name: gpt-4o
|
||
|
||
edges:
|
||
- from: Context Injector
|
||
to: Assistant
|
||
```
|
||
|
||
### 条件分支中的固定响应
|
||
|
||
```yaml
|
||
nodes:
|
||
- id: Classifier
|
||
type: agent
|
||
config:
|
||
provider: openai
|
||
name: gpt-4o
|
||
role: 判断用户意图，回复 KNOWN 或 UNKNOWN
|
||
|
||
- id: Known Response
|
||
type: literal
|
||
config:
|
||
content: 我能帮助您完成这个任务。
|
||
role: assistant
|
||
|
||
- id: Unknown Response
|
||
type: literal
|
||
config:
|
||
content: 抱歉，我无法理解您的请求，请换一种方式描述。
|
||
role: assistant
|
||
|
||
edges:
|
||
- from: Classifier
|
||
to: Known Response
|
||
condition:
|
||
type: keyword
|
||
config:
|
||
any: [KNOWN]
|
||
- from: Classifier
|
||
to: Unknown Response
|
||
condition:
|
||
type: keyword
|
||
config:
|
||
any: [UNKNOWN]
|
||
```
|
||
|
||
### 测试用途
|
||
|
||
```yaml
|
||
nodes:
|
||
- id: Test Input
|
||
type: literal
|
||
config:
|
||
content: |
|
||
这是一段测试文本，用于验证下游处理逻辑。
|
||
包含多行内容。
|
||
role: user
|
||
|
||
- id: Processor
|
||
type: python
|
||
config:
|
||
timeout_seconds: 30
|
||
|
||
edges:
|
||
- from: Test Input
|
||
to: Processor
|
||
|
||
start: [Test Input]
|
||
```
|
||
|
||
## 注意事项
|
||
|
||
- `content` 字段不能为空字符串
|
||
- 使用 YAML 多行字符串语法 `|` 便于编写长文本
|
||
- 选择正确的 `role` 以确保下游节点正确处理消息
|