wehub-resource-sync
d0e4308def
Validate YAML Workflows / Validate YAML Configuration Files (push) Has been cancelled
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` 以确保下游节点正确处理消息
|