集成 MongoDB 与 Mem0

add()

add() 方法从对话中提取事实，并将其作为内存文档写入您的集合。如果对应于该实体的语义相同的记忆已经存在，Mem0 会更新该记忆，而不是创建重复的文档。

以下示例将对话传递给 add() 方法，并将生成的内存范围限定为特定用户：

messages = [
    {"role": "user", "content": "I'm moving to Berlin next month."},
    {"role": "assistant", "content": "I'll remember that you're relocating to Berlin."},
]
result = m.add(messages, user_id="alice")
print(result)

{'results': [{'id': '...', 'memory': 'User is moving to Berlin around September 2026.', 'event': 'ADD'}]}

get()

get() 方法按其 ID 值检索单个内存文档，而不运行向量搜索。

以下示例按其 ID 直接检索内存：

memory = m.get(memory_id="<memory-id>")
print(memory)

{'id': '...', 'memory': 'User is moving to Berlin around September 2026.',
'hash': '...', 'metadata': None, 'score': None, 'created_at': '...',
'updated_at': '...', 'user_id': 'alice', 'attributed_to': 'user'}

memory_id 参数是必需的，并接受用于检索内存文档的 id 值。如果不存在具有该 ID 的内存，则 get() 方法返回 None。

搜索()

search() 方法对 MongoDB 向量搜索索引运行语义搜索，并返回与查询字符串最相关的记忆。

以下示例搜索某个特定用户的记忆，以获取五个最相关的结果：

results = m.search(
    query="Where does Alice live?",
    filters={"user_id": "alice"},
    top_k=5,
)
for mem in results["results"]:
    print(mem["memory"], "- score:", mem["score"])

User is moving to Berlin around September 2026. - score: 0.7043201923370361

get_all()

get_all() 方法返回为给定实体存储的内存文档，而不运行语义搜索。使用此方法显示实体的完整内存历史。

以下示例返回并打印特定用户的所有记忆：

all_memories = m.get_all(filters={"user_id": "alice"})
for mem in all_memories["results"]:
    print(mem["id"], mem["memory"])

<id> User is moving to Berlin around September 2026.

update()

update() 方法替换现有内存文档的文本。Mem0 从新文本重新计算嵌入，并原地更新文档。

以下示例替换现有内存的文本：

m.update(memory_id="<memory-id>", text="Alice relocated to Berlin in July 2025.")

Delete()

delete() 方法从集合中删除单个内存文档。

如下示例按其 ID 删除一个内存：

m.delete(memory_id="<memory-id>")

memory_id 参数是必需的，并接受要删除的内存文档的 id 值。

delete_all()

delete_all() 方法从您的集合中删除给定实体的所有内存文档。

如下示例将删除特定用户的所有记忆：

m.delete_all(user_id="alice")

历史()

history() 方法返回单个内存的编辑历史，包括文本的每个版本和事件类型。Mem0 将此历史记录存储在本地 SQLite 数据库中，而不是在 MongoDB 中。要更改 Mem0 写入该数据库的位置，请在配置字典中设置 history_db_path 密钥。

以下示例检索并打印记忆的编辑历史。

history = m.history(memory_id="<memory-id>")
for entry in history:
    print(entry["event"], entry["old_memory"], entry["new_memory"])

ADD None User is moving to Berlin around September 2026.
UPDATE User is moving to Berlin around September 2026. Alice relocated to Berlin in July 2025.

memory_id 参数是必需的，并接受您要检索其历史的内存文档的 id 值。

reset()

reset() 方法执行以下操作：

• 删除您的 MongoDB 集合及其 MongoDB 向量搜索和 MongoDB Search 索引

• 重置本地历史数据库

• 彻底重建集合及其索引

使用此方法清除所有内存，而不是使用 delete_all() 方法逐个实体删除它们。

m.reset()

reset() 不接受任何参数，并删除 Mem0 通过此 Memory 实例存储的所有内存。

close()

close() 方法释放 Mem0 用于历史数据库的本地 SQLite 连接。这种方法不会影响您的 MongoDB 连接。

m.close()

close() 不接受任何参数。Mem0 会自动调用它，前提是您将 Memory 实例用作上下文经理。