联诚天枢AIOS平台

Appearance

在工作流和智能体中使用 ​

当前记忆库有两种主要运行方式：作为项目/智能体的长期记忆资源挂载，或在工作流中通过“长期记忆检索”和“长期记忆写入”节点显式调用。

在项目和智能体中挂载 ​

在智能体编辑器的 编排 > 记忆 > 长期记忆 中选择记忆库。已选资源提供 记忆库设置，可以控制 支持在 Prompt 中调用。

在智能体中挂载长期记忆库

图中标记说明：

  1. 在智能体编排区展开 长期记忆，点击右侧添加按钮选择记忆库。
  2. 确认目标记忆库已出现在资源列表中。截图中的 PLCAgent 是文档演示资源，实际项目应按业务、用户范围和环境选择对应记忆库。
  3. 点击资源卡片上的 记忆库设置，按需开启 支持在 Prompt 中调用。截图中开关已开启。
  • 开启后，项目运行时可以把该记忆库作为 Prompt 可用的长期上下文来源。
  • 关闭后，资源仍可保留在项目配置中，但不应把它视为会自动进入 Prompt 的内容。
  • 开关是具体项目中的资源设置，不等于修改记忆库本身的数据权限。

旧文档中关于“应用不支持记忆库”的限制已不符合当前项目编辑器实现；是否挂载、是否允许 Prompt 调用，应以当前项目资源配置为准。

智能体处理顺序 ​

  1. 从可信会话上下文取得终端用户 ID 和渠道。
  2. 只召回当前任务真正需要的记忆。
  3. 把记忆视为可纠错的上下文，不当作不可质疑的事实。
  4. 高影响信息在使用前再次向用户确认。
  5. 回答完成后，只提取具有长期价值且允许保留的信息。
  6. 写入后记录合适的类型、标签、时间与重要度。

用户偏好可以影响表达方式，但不能绕过权限、审批、安全策略或业务规则。

长期记忆检索节点 ​

工作流编辑器中的 长期记忆检索 节点用于从一个目标记忆库中查找与输入匹配的内容。当前节点只支持选择一个记忆库。

长期记忆检索节点配置

图中标记说明：

  1. 在自动布局后的画布中选中 长期记忆检索 节点，节点卡片会显示记忆库、输入和输出摘要。
  2. 一个检索节点只选择一个目标记忆库。截图绑定 PLCAgent，复制到其他空间后要重新确认资源。
  3. query 描述当前要找的信息，limit 控制最多返回多少条；截图中的问题和默认值 20 仅用于说明字段位置。

输入与输出 ​

名称类型默认值说明
querystring空检索文本，可填写固定值或引用上游变量
limitinteger20最多返回的记忆条数
outputListarray<object>只读输出每项包含 output 和 date

query 应当描述当前任务真正需要的用户信息，而不是把整段系统提示词直接作为查询。limit 不是越大越好；返回过多记录会增加上下文噪声，并放大过期或弱相关信息的影响。

推荐流程：

text
开始节点
  → 整理检索问题
  → 长期记忆检索
  → 检查 outputList
  → 大模型生成回答

长期记忆写入节点 ​

长期记忆写入 节点把多轮消息提交给一个目标记忆库，由记忆服务处理长期信息。

长期记忆写入节点配置

图中标记说明：

  1. 选中 长期记忆写入 节点后，画布卡片会显示目标记忆库、messageList 和 isSuccess。
  2. 写入节点同样只绑定一个目标记忆库；截图中的 PLCAgent 是文档演示资源。
  3. messageList 按 role 和 content 组织对话消息，可以填写固定 JSON，也可以引用上游同结构变量。

输入与输出 ​

名称类型说明
messageListarray<object>消息列表；每项包含字符串字段 role 和 content
isSuccessboolean只读输出，表示本次写入是否成功

默认表单结构包含 user 和 assistant 消息。可使用固定 JSON，也可以引用上游产生的同结构变量。

json
[
  {
    "role": "user",
    "content": "以后给我日报时先列三条结论。"
  },
  {
    "role": "assistant",
    "content": "好的，我会优先输出三条结论。"
  }
]

不要把每段聊天无条件送入写入节点。建议在写入前增加判断或总结步骤，排除一次性指令、验证码、临时情绪、未经确认的敏感推断和无长期价值的闲聊。

推荐流程：

text
对话消息
  → 判断是否有长期价值及授权
  → 生成受控 messageList
  → 长期记忆写入
  → 根据 isSuccess 处理成功或失败

用户与渠道来自哪里 ​

节点面板配置目标记忆库和业务输入；终端用户与渠道由工作流实际运行上下文提供。画布试运行可以验证字段格式，但不能单独证明身份隔离正确。

运行入口必须做到：

  • 用户 ID 由认证后的上下文注入，不信任模型输出或未鉴权请求体。
  • AIOS、API、Chat SDK、Web SDK 使用清晰且稳定的渠道代码。
  • 匿名身份与登录身份切换时，不复用其他真实用户的临时 ID。
  • 缺失用户或渠道上下文时明确失败，不写入共享兜底用户。

组合使用方式 ​

回答前召回 ​

先检索与当前任务相关的偏好、事实或摘要，再让模型结合当前问题回答。对于地址、套餐、联系人等会变化或影响业务决策的信息，应向用户确认后再使用。

会话后写入 ​

在会话完成或关键事件确认后，提取最少、原子化的长期信息写入。成功不等于内容正确，仍需通过详情页抽查类型、渠道和正文。

纠错闭环 ​

当用户否认已召回的信息时，不要只在当前回复中忽略。应把纠错请求送入受控维护流程，定位旧记录，修改或删除后再次检索验证。

调试与验收 ​

至少验证：

  1. 用户 A 无法召回用户 B 的记忆。
  2. 同一用户在不同渠道中的记录符合预期隔离范围。
  3. query 为空、limit 非法或未选择记忆库时，节点给出可见错误。
  4. messageList 不是数组、对象缺少 role/content 时，流程明确失败。
  5. 写入失败后根据 isSuccess 或节点错误进入失败分支，不吞异常、不无证据重试。
  6. 删除或修改记录后，新的检索结果不再返回旧内容。
  7. Prompt 调用开关的开、关状态在实际项目运行中与预期一致。

相关配置可继续阅读工作流节点与变量和管理记忆记录。