尚无译文的页面会以英语打开,并标注为英语。
此机器翻译生成后,英文原文已更新。请阅读英文页面以获取当前说明。
本页由机器从英文原文翻译,内容以英文原文为准。 Machine-translated from the English page, which is authoritative.
AI agent 的长期记忆与共享记忆
Loom 是一个自托管的 MCP 服务器和 HTTP API,为 AI agent 提供可共享的长期记忆:一个 agent 在某次会话中保存的事实,可以被下一次会话、另一个 agent,或在控制台查看的人找到。本页介绍其工作方式以及从哪里开始。
你能获得什么
- 每个键在命名空间中对应一条声明。
memory.set保存一条事实;memory.get按键读回;memory.search和loom_search按语义查找。命名空间是共享的单位:默认情况下,每个成员都可以读取其中的每一行。 记忆 - 可以更正的记忆。 每次修改都会生成带有历史记录的新版本。规范化之后相同的事实会合并到已存储的行中,换一种说法表达的同一事实会作为重复项存储,相互矛盾的内容会被标记等待审核,对已固定事实的写入会被拒绝。 冲突与拒绝 · 历史与来源
- 会弃权的搜索。 当没有任何结果达到相似度下限时,
memory.search会返回abstain=true和一个原因代码,并将每个较弱的命中标记为below_threshold;loom_search则会丢弃这些命中。搜索与提问 - 为你的编码 agent 提供长期记忆,并在 agent 之间共享。 Claude Code 和 Codex 插件会在会话开始时加载相关上下文,并在会话运行时捕获会话内容。Cursor、GitHub Copilot、Gemini CLI、Cline、Kilo Code、OpenCode、goose、Zed 和其他 MCP 客户端可以连接到同一个服务器,同一命名空间下的 agent 可以找到其他 agent 在其中保存的事实。 连接编码 agent · MCP 客户端
- 与所涉代码关联的记忆。 编码 agent 的经验会跟随其所指的定义,经历重命名和编辑,并在 agent 阅读该代码时出现。关联到代码的记忆
- 为你自己的 agent 提供按用户划分的记忆。 Python 和 TypeScript SDK 按终端用户写入和读取记忆。你的第一个 agent
实测结果
在 100 个成对的 LongMemEval-S 问题上,使用相同的 gpt-5 读取模型,基于 Loom 检索到的记忆给出的答案得分为 94%,而基于完整历史的得分为 90%,读取模型的提示 token 减少了 91%(不含构建记忆的一次性成本);准确率的差异在统计上不显著。
使用与不使用 Loom
记住你阅读偏好的研究助手
完成快速开始后,通过控制台的客户端设置连接 Claude Desktop 或 Cursor。这些工具可与原生 LLM 配合使用:由你的聊天应用提供调用它们的模型。
- 对助手说:“使用
loom_memory_set将我的研究偏好保存在example/research/source-policy下:在我的阅读列表中包含经过同行评审的论文。” - 检查工具响应中是否包含
memory_id。在控制台中打开 Memories,确认值和写入者。如果工具拒绝了写入,请先解决其报告的问题再继续。 - 开始一个新的聊天。对助手说:“使用
loom_memory_get读取example/research/source-policy,然后告诉我哪些来源应该放进我的阅读列表。”检查工具是否返回found: true以及你保存的偏好。 - 完成后,让助手删除该示例键,然后确认控制台不再将其列为有效记忆。
第二个聊天在没有第一个聊天记录的情况下读取了已存储的偏好。这检验的是持久化和客户端接入是否正常,并不检验助手能否评判论文或回答研究问题。如需对论文本身进行搜索,请使用文档搜索。
开始
快速开始会启动本地环境,并通过 HTTP、Python 和 MCP 保存第一条记忆。Loom 不适用的情况介绍了进程内记忆库更合适的场景。
本页中的一些 op 在状态页上被标记为实验性。
使用 Microsoft Agent Framework 上下文提供程序,可在运行前召回用户事实,并在运行后记录对话。
将 Claude API 记忆工具的文件树存储在 Loom 中,使命名空间内的 agent 可以共享其内容。
将 OpenAI Agents 会话历史保存在 Loom 中,以便在多次 agent 运行和交接之间保持。
对于可视化工作流,n8n 节点可将 AI Agent 连接到 Loom 的对话历史、持久记忆和知识搜索。