Appearance
为低代码智能体添加记忆
记忆用于保存当前任务状态、结构化业务记录或需要跨对话复用的用户信息。低代码智能体常用的记忆方式包括变量、数据库和记忆库（长期记忆）。
选择记忆方式
编辑页集中提供变量、数据库、长期记忆和文件盒子四类入口。启用前应先区分临时状态、结构化业务数据、跨会话用户信息和用户文件，避免混用。
| 方式 | 数据特点 | 典型用途 |
|---|---|---|
| 变量 | 简单键值，适合在对话或任务中读写 | 用户选择、流程阶段、临时计算结果 |
| 数据库 | 按字段组织，可新增、查询、更新和删除 | 客户记录、订单、任务清单、业务状态 |
| 记忆库（长期记忆） | 面向特定用户沉淀可跨对话召回的信息 | 用户偏好、稳定事实、长期交互习惯 |
知识库保存共享的业务资料；记忆保存与当前用户、会话或业务过程相关的信息。不要用长期记忆替代企业知识库。
变量
变量类型
- 系统变量：由平台提供，例如当前用户、会话或运行环境信息。可用项以编辑器实际显示为准。
- 用户变量：由开发者定义，用于保存业务需要的值。
创建和使用
- 在智能体的记忆或变量区域新增用户变量。
- 设置清晰的变量名、类型、说明和默认值。
- 在提示词、快捷指令、插件参数或工作流输入中引用变量。
- 明确变量在什么条件下写入、更新或清空。
- 在预览区检查变量值是否随对话正确变化。
变量编辑窗口将用户变量与系统变量分区展示。用户变量可填写名称、描述和默认值；系统变量由平台提供、仅可读取，并可按发布渠道决定是否启用。
变量命名应表达业务含义，例如 product_model、service_region，避免使用 value1、temp 等难以维护的名称。
使用注意
- 不要把未验证的用户输入直接作为关键业务参数。
- 默认值与“未填写”应能区分，避免误判。
- 变量类型应与插件、工作流或数据库字段一致。
- 切换智能体模式或发布渠道前，确认变量的可用范围没有变化。
数据库
数据库适合保存需要持续维护和按条件查询的结构化数据。
添加数据库时，可以在资源库中搜索已有数据表，或先新建数据表后再绑定到当前智能体。
创建数据表
- 在资源库或智能体数据库区域创建数据表。
- 设计字段名称、数据类型、是否必填和默认值。
- 设置能够唯一识别记录的字段或业务规则。
- 添加测试数据并验证查询、写入和更新操作。
- 将数据表添加到智能体或相关工作流。
使用数据表
智能体通常通过工作流或数据库相关能力执行以下操作：
- 按条件查询记录。
- 新增业务记录。
- 更新指定字段。
- 删除或停用记录。
- 对数据进行统计或汇总。
执行写入、更新或删除前，应确认目标记录和用户权限。对于不可逆操作，建议增加二次确认或审批步骤。
记忆库与长期记忆
长期记忆用于保存可跨对话使用的用户信息。平台可在后续对话中召回相关记忆，帮助智能体提供更连续、个性化的回复。
添加记忆库
- 在资源库中创建记忆库，或选择已有记忆库。
- 在智能体的记忆区域添加目标记忆库。
- 配置允许记录和召回的内容范围。
- 在提示词或工作流中明确写入与召回条件。
- 使用同一测试用户进行多轮、跨会话验证。
选择长期记忆库时可按创建人筛选、搜索或新建记忆库；点击“添加”后，该记忆库才会与当前智能体建立绑定关系。
记录长期记忆
只记录相对稳定、未来确实有用的信息，例如用户明确表达的语言偏好、常用产品或长期服务需求。临时情绪、一次性任务参数和未经确认的推测不应写入长期记忆。
提示词可以采用以下约束：
text
仅当用户明确表达并确认长期偏好时，才记录长期记忆。
不得根据一次对话推测用户身份、健康状况或其他敏感信息。
新信息与已有记忆冲突时，先向用户确认，再更新旧记忆。召回长期记忆
召回时应根据当前问题选择相关内容，不应把用户的全部记忆无差别注入对话。无关记忆会增加上下文噪声，也可能造成隐私风险。
查看、更新和删除
应定期检查记忆内容，并为用户或管理员提供按权限查看、纠正和删除的方式。错误、过期或用户要求删除的记忆应及时处理。
数据与隐私要求
- 只保存完成任务所必需的数据。
- 明确数据归属、读取范围、保存期限和删除方式。
- 不在提示词、日志或普通变量中保存密钥和访问凭据。
- 敏感操作需要权限校验，必要时增加用户确认。
- 调试数据和生产数据应按环境隔离。
- 发布前验证不同用户之间的数据不会串用。
调试检查
- 新会话开始时，变量和历史状态是否符合预期。
- 同一用户跨会话时，长期记忆是否正确召回。
- 不同用户之间是否严格隔离。
- 数据库查询条件是否准确，写入是否发生重复。
- 冲突信息是否先确认再覆盖。
- 删除或清空操作是否真正生效。
- 切换模式、版本或渠道后，记忆能力是否仍然可用。