literal.md

Literal 节点

Literal 节点用于输出固定的文本内容。当节点被触发时，它会忽略所有输入，直接输出预定义的消息。

配置项

字段	类型	必填	默认值	说明
content	text	是	-	输出的固定文本内容，不能为空
role	string	否	user	消息角色：user 或 assistant

核心概念

固定输出

Literal 节点的特点：

• 忽略输入：不管上游传入什么内容，都不影响输出
• 固定内容：每次执行都输出相同的 content
• 角色标记：输出消息带有指定的角色标识

消息角色

• user：表示这是用户发出的消息
• assistant：表示这是助手（AI）发出的消息

角色设置会影响下游节点对消息的处理方式。

何时使用

• 固定提示注入：向流程中注入固定的指令或上下文
• 测试调试：使用固定输入测试下游节点
• 默认响应：在特定条件下返回固定消息
• 流程初始化：作为工作流的起点提供初始内容

示例

基础用法

nodes:
  - id: Welcome Message
    type: literal
    config:
      content: |
        欢迎使用智能助手！请描述您的需求。
      role: assistant

注入固定上下文

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

条件分支中的固定响应

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]

测试用途

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 以确保下游节点正确处理消息