知识和数据节点

本分类包含应用/用户变量、知识库和长期记忆三类能力。知识库适合公共资料，变量适合确定性状态，长期记忆适合与用户或业务主体关联的跨会话信息。

变量赋值节点

变量赋值节点为允许写入的应用变量或用户变量设置新值。

每条赋值规则包括左侧目标变量和右侧值。右侧可以是固定值，也可以引用开始节点、上游节点或系统上下文。目标变量与来源类型必须兼容。

用户变量写入前要确认用户身份；应用变量可能被多个运行实例共享，涉及计数和并发更新时不能假定“读取后再写入”天然原子。

知识库写入节点

知识库写入节点把一个 File 类型文件写入指定知识库。当前一个节点只选择一个目标知识库；旧文档中的 String 和 Array<Object> 直写方式不适用于当前编辑器。

配置	说明
知识库	选择当前空间可写入的文本知识库
knowledge	待写入的文件或上游文件变量
解析策略	可配置精准解析、图片提取、图片 OCR 和表格提取等能力
分段策略	设置分隔符、单段最大 Token 和重叠比例

输出包含 documentId、fileName、fileUrl。后续需要更新或删除文档时，应保存 documentId，不要只依赖文件名定位。

写入成功只代表文档已提交并获得资源信息；大文件的解析、分段和索引可能仍需时间。立即检索前应考虑索引状态。

查看知识库写入节点完整配置说明 →

知识库检索节点

知识库检索节点根据输入 Query，从选定知识库召回最匹配的内容。

配置步骤

1. 选择一个或多个当前空间可用的知识库。
2. 将用户问题或上游改写后的 Query 映射到输入。
3. 配置召回数量、最低相关度及当前界面提供的检索策略。
4. 单节点试运行，检查片段内容是否足以支持下游模型回答。

当前结果以 outputList 返回，每项至少包含召回内容 output 和文档标识 documentId。没有命中时返回空列表，下游应准备“不知道”或转人工等兜底。

不要把召回片段未经筛选地全部塞给模型；召回过多会增加上下文和成本，最低相关度过低会引入无关内容。

查看知识库检索节点完整配置说明 →

知识库删除节点

知识库删除节点根据单个 String 类型的 documentID，从一个资源库知识库中删除指定文档。

输入为目标知识库和 documentID，输出 isSuccess 表示操作是否成功。当前节点不会从多个检索结果中自动取第一项；文档 ID 应来自知识库写入、经过明确选择的检索结果或受控业务记录。

删除属于高风险操作。执行前确认知识库、文档 ID 和权限范围；不要根据用户自由输入直接执行删除。当前企业知识库没有文档删除接口，不能作为本节点目标。

查看知识库删除节点完整配置说明 →

长期记忆写入节点

长期记忆写入节点把结构化对话消息写入一个资源库记忆库，让后续流程可以检索用户偏好或已经确认的业务事实。

输入	类型与说明
记忆库	选择当前空间可用的一个资源库记忆库
messageList	Array<Object> 消息列表，每项包含 String 类型的 role 和 content

建议按 user 与 assistant 的实际对话顺序写入，并确保执行上下文绑定了正确用户或业务主体。当前前端不校验角色枚举，仍应使用 user、assistant、system 标准值。节点输出 isSuccess。

不应写入密钥、身份证件、支付信息等不适合长期保存的数据。写入前可先经过内容提取，只保留确有长期价值的事实。

查看长期记忆写入节点完整配置说明 →

长期记忆检索节点

长期记忆检索节点根据 query，从一个资源库记忆库中查找相关的历史记忆。

输入	说明
记忆库	选择一个资源库记忆库作为检索范围
query	String 检索问题，可使用固定值或上游变量
limit	Integer 最大返回数量，当前默认值为 20

输出 outputList，每项包含 String 类型的记忆内容 output 和时间字段 date。当前节点不会自动总结结果；检索结果应作为模型参考，而不是未经校验的最终事实，与当前用户输入冲突时要设计确认逻辑。

查看长期记忆检索节点完整配置说明 →

常见问题

为什么旧文档中的“变量节点”和“长期记忆节点”不在目录中？

当前添加节点面板已经隐藏这两个旧兼容节点。新流程应使用 变量赋值、长期记忆写入、长期记忆检索；已有流程中的旧节点仍可能被编辑器加载，但不作为新建入口介绍。