跳到主要内容

记忆写入节点

将指定内容写入 AI 应用关联的记忆库中,实现长期记忆的持久化存储。

该节点需要在 AI 应用中关联当前流程并配置记忆库才能正常工作。

一、应用场景

  • 用户偏好沉淀:在对话过程中,将 LLM 提取出的用户偏好(如饮食习惯、沟通风格、常用地址等)写入记忆库,后续轮次通过"记忆检索"节点召回,实现个性化服务。
  • 对话摘要归档:在对话结束时,将本轮对话的关键内容或 LLM 生成的摘要写入记忆库,形成跨会话的长期记忆。
  • 知识动态补充:将流程执行过程中产生的新知识(如查询结果、计算结论、外部 API 返回的信息)写入记忆库,使记忆库持续丰富。
  • 操作日志记录:将用户的关键操作或决策写入记忆库,形成可检索的操作历史。

二、添加记忆写入节点

在画布中点击前一节点右侧的 ,在节点列表中选择记忆写入节点完成添加。

三、节点配置详解

1. 输入变量

输入变量用于为写入标题和写入内容中的 {{变量名}} 占位符提供实际值。

  • 左侧输入框:填写变量名(与标题/内容中 {{变量名}} 对应)。
  • 右侧下拉框:选择来源节点和字段,仅支持 stringnumber 类型的变量。
  • 变量来源必须是当前节点之前的串行节点,不能引用并行或后续节点的输出。
  • 输入变量为可选配置,若标题和内容中不包含变量占位符,可不配置。

2. 写入标题

设置写入记忆库的文档标题。

  • 支持直接输入固定文本。
  • 支持通过 {{变量名}} 引用输入变量,按下 / 可快捷选择变量。
  • 留空时自动生成标题,格式为"节点名称-时间戳"。

3. 写入内容

设置写入记忆库的文档正文内容,节点会将该内容向量化后存入记忆库。

  • 支持直接输入固定文本。
  • 支持通过 {{变量名}} 引用输入变量,按下 / 可快捷选择变量。
  • 写入内容不能为空,否则校验不通过。

4. 输出变量

记忆写入节点执行成功后输出以下变量:

字段名类型说明
documentIdstring写入记忆库后生成的文档 ID,可用于追踪或后续操作

5. 配置示例

假设需要将 LLM 节点生成的对话摘要写入记忆库:

  1. 添加输入变量:变量名 summary,来源选择 LLM 节点的 result
  2. 写入标题填写:对话摘要-{{summary}} 或留空让系统自动生成。
  3. 写入内容填写:{{summary}}

执行后,LLM 生成的摘要文本将作为一条新记忆存入记忆库,后续可通过"记忆检索"节点检索到该内容。

四、注意事项

该节点必须在 AI 应用中关联流程并配置记忆库后使用。若未配置记忆库,节点执行时将报错:"记忆写入需要关联AI应用并配置记忆库"。

写入记忆库失败时(如记忆库服务不可用),节点将抛出异常,流程中断执行。

写入的内容会经过向量化处理后存入记忆库,因此写入后即可通过"记忆检索"节点进行语义检索。

写入标题和写入内容均支持 {{变量名}} 占位符,运行时会自动替换为输入变量的实际值。若占位符对应的变量未配置或值为空,则替换为空字符串。