将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 Vector Search索引运行语义搜索，并返回与查询字符串最相关的记忆。

以下示例在特定用户的记忆中搜索五个最相关的结果：

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()

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 Vector Search 和MongoDB Search 索引

• 重置本地历史数据库

• 从头开始重新创建集合及其索引

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

m.reset()

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

close()

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

m.close()

close() 不接受任何参数。如果您使用 Memory实例作为上下文管理器，则 Mem0 会自动调用它。