跳到主要内容

记忆与个性化 🧠

Experimental Feature

Memory 系统目前处于 Beta / Experimental 阶段。不同模型在存储和检索信息时可能表现不一致，存储格式未来也可能变化。

OPL 数据空间内置了一套较完整的记忆系统，允许模型跨会话记住关于你的事实、偏好和上下文。

随着 Native Tool Calling 的引入，这套系统已经从“被动注入上下文”升级为由模型主动管理的“长期记忆”。

工作原理​

记忆系统会保存一些关于你的信息片段，例如“我更喜欢用 Python 做后端”或“我住在维也纳”。这些记忆有两种使用方式：

1. 手动管理（设置）​

用户可以前往以下位置手动添加、编辑或删除记忆：

设置 > Personalization > Memory

2. 原生记忆工具（Agentic Mode）​

当你使用启用了 Native Function Calling（Agentic Mode） 的模型时，高质量模型可以通过 5 个内建工具自主管理记忆。有关管理员如何配置这些系统级工具，可参阅 Central Tool Calling Guide。

适合记忆管理的模型

自主记忆管理更适合 GPT-5、Claude 4.5+、Gemini 3+ 这类前沿模型。它们更擅长判断哪些事实值得保存，以及何时回忆相关内容。较小的本地模型往往不擅长做出恰当的记忆选择。

  • add_memory：允许模型在对话中主动保存刚学到的新事实。
  • search_memories：允许模型在记忆库中搜索相关上下文。结果会返回每条记忆的唯一 id，并可指定返回条数，默认是 5。
  • replace_memory_content：允许模型使用 id 更新或纠正某条已有记忆。
  • delete_memory：允许模型根据 id 删除不再相关或已经不正确的记忆。
  • list_memories：允许模型列出当前用户的全部记忆，包括内容与时间戳。

新记忆系统的优势​

  • 主动学习：你不必手动录入偏好；模型可以在对话中说“我会记住你在 UI 项目中偏好 dark mode”，然后后台调用 add_memory。
  • 上下文检索：如果对话转到几个月前提过的话题，模型可以使用 search_memories 在“脑中搜索”相关细节。
  • 动态纠正：如果模型记错了内容，可以用 replace_memory_content 修正，而不是重复创建类似记忆。
  • 清理过期信息：模型可以使用 delete_memory 删除陈旧或不再相关的事实。
  • 完整可见性：借助 list_memories，模型可以查看所有已知内容，并发现空缺或矛盾。
  • 用户仍保留控制权：虽然模型能添加记忆，但最终控制仍在用户手里。模型添加的每条记忆都可以在 Personalization 设置中审查和删除。

启用记忆工具​

  1. 管理员启用：先确保管理员已在全局打开 Memory 功能，且你拥有相应权限。
  2. Native Mode（Agentic Mode）：在模型高级参数中启用 Native Function Calling（管理员面板 > 设置 > Models > Model Specific 设置 > Advanced Parameters）。
  3. 建议使用高质量模型：若要更可靠地使用这组能力，建议选用推理能力较强的前沿模型，例如 GPT-5、Claude 4.5 Sonnet、Gemini 3 Flash、MiniMax M2.5 等。
  4. 按模型启用分类开关：在 Workspace > Models > Edit > Builtin Tools 中确认 Memory 分类对该模型已启用（默认开启）。
中央工具文档

关于全部内建 agentic 工具（包括 memory、web search、knowledge base）及其配置方式，请参考 Native/Agentic Mode Tools Guide。

管理员控制项​

管理员可以完全控制 Memory 功能，包括全局禁用，或者只授权给特定角色/用户组。

全局开关​

Memory 可在实例级整体开关。关闭后，所有用户的 “Personalization” 标签页都会被隐藏，相关 API 端点也会被阻止。

  • Admin UI: 管理员面板 > 设置 > 通用 > Features > Memories
  • Environment Variable: ENABLE_MEMORIES（默认：True）

细粒度权限​

管理员也可以在权限界面按角色或用户组控制 Memory 访问。

隐私与安全​

记忆数据会保存在你的 OPL 数据空间本地数据库中，并且默认只作用于当前用户账户，不会自动共享给其他用户。你也可以随时清空自己的整个记忆库。