跳转至

Note 画布批注与便签注释节点

节点核心功能 (What is it?)

Note 节点允许创作者在工作流画布的任意区域添加说明性便签与图文注释。它不参与任何实际的数据流运算与逻辑操作，纯粹用于在画布拓扑中进行可视化说明、流程架构标注以及团队协作沟通。

典型适用场景 (When would I use it?)

在以下情况下使用 Note 节点：

  • 详细阐述工作流中某个特定子模块或功能区块的业务逻辑；
  • 为复杂节点或需要特定输入格式的算子附上使用提示与参数配置备忘；
  • 在将工作流分享给团队其他成员或开源社区时，提供清晰的上手操作指引；
  • 标记 TODO 待办项、算法调优建议或版本迭代记录。

使用指南 (How to use it)

基础配置流程 (Basic Setup)

  1. 在工作流画布中添加 Note 节点。
  2. 在 note 参数框中输入任意多行说明文本或 Markdown 排版内容。
  3. 将该便签节点拖拽并放置在需要解释的目标算子节点附近。

参数输入插槽 (Parameters)

  • note：用于在画布上展示的便签文本内容（string，默认为空字符串，支持自适应多行录入）。

典型工作流示例 (Example)

在智能体节点旁边添加一条关于如何使用 prompt_context 上下文变量的便签指引：

  1. 在工作流画布中添加一个 Note 节点。
  2. 将该 Note 便签拖拽到 Agent 节点的右上方。
  3. 在 note 文本框中填入以下指引内容： 
    若要使用 prompt_context 动态提示词插值：
1. 创建一个新的 KeyValuePair 节点；
2. 设置 key 为 "style"，value 为 "haiku"（俳句风格）；
3. 将生成的字典输出连接至 Agent 的 prompt_context 插槽；
4. 在 Agent 的 prompt 中使用 {{ style }} 占位符进行动态替换。
示例 Prompt:
"请以 {{style}} 的语言风格为我讲解滑板运动的核心要领"
  4. 将便签摆放在一目了然的位置，方便后续快速查阅与维护。

关键技术特性 (Important Notes)

  • 物理换行忠实保留：输入框内的所有回车换行符均会被 100% 忠实保留在画布便签卡片上；
  • 全字符集与富文本兼容：支持任意合法的字符串内容，无字符长度上限限制；
  • 纯注释零开销：不消耗任何运行时显存或计算资源，在工作流打包与推理执行时会被引擎自动透明忽略。

常见问题与已知局限 (Common Issues)

  • 字体与排版样式：当前版本暂未提供便签字体字号（Font Size）的自定义缩放滑块；
  • 背景颜色定制：当前版本便签卡片的背景底色由系统主题统一管控，暂不支持单独设置便签高亮背景色。