Integrar MongoDB com Mem0

add()

O método add() extrai fatos de uma conversa e os grava em sua coleção como documentos de memória. Se uma memória semanticamente equivalente já existe para a entidade, Mem0 atualiza essa memória em vez de criar um documento duplicado.

O exemplo a seguir passa uma conversa para o método add() e define o escopo da memória resultante para um usuário específico:

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

O método get() recupera um único documento de memória pelo seu valor de ID sem executar uma pesquisa vetorial.

O exemplo a seguir recupera uma memória diretamente pelo seu 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'}

O parâmetro memory_id é obrigatório e aceita o valor id do documento de memória a ser recuperado. Se não houver memória com esse ID, o método get() retornará None.

search()

O método search() executa uma pesquisa semântica no índice de pesquisa vetorial do MongoDB e retorna as memórias que são mais relevantes para uma string da query.

O exemplo a seguir pesquisa as memórias de um usuário específico pelos cinco resultados mais relevantes:

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

O método get_all() retorna os documentos de memória armazenados para uma determinada entidade sem executar uma pesquisa semântica. Utilize este método para exibir o histórico de memória completo de uma entidade.

O exemplo a seguir retorna e imprime todas as memórias de um usuário específico:

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

O método update() substitui o texto de um documento de memória existente. Mem0 recalcula o embedding a partir do novo texto e atualiza o documento no local.

O exemplo a seguir substitui o texto de uma memória existente:

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

Delete()

O método delete() exclui um único documento de memória da sua coleção.

O exemplo a seguir exclui uma memória pela sua ID:

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

O parâmetro memory_id é obrigatório e aceita o valor id do documento de memória a ser excluir.

delete_all()

O método delete_all() exclui todos os documentos de memória para uma determinada entidade da sua coleção.

O exemplo a seguir exclui todas as memórias para um usuário específico:

m.delete_all(user_id="alice")

histórico()

O método history() retorna o histórico de edições para uma única memória, incluindo cada versão do texto e o tipo de evento. Mem0 armazena este histórico em um banco de dados SQLite local em vez de no MongoDB. Para alterar onde o Mem0 grava esse banco de dados, defina a chave history_db_path no seu dicionário de configuração.

O exemplo a seguir recupera e imprime o histórico de edições para uma memória:

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.

O parâmetro memory_id é obrigatório e aceita o valor id do documento de memória cujo histórico você deseja recuperar.

reset()

O método reset() executa as seguintes ações:

• Exclui sua coleção do MongoDB e seus índices de pesquisa vetorial do MongoDB e do MongoDB Search

• Redefine o banco de dados de histórico local

• Recria a coleção e seus índices do zero

Use este método para limpar todas as memórias em vez de usar o método delete_all() para exclui-las uma entidade por vez.

m.reset()

reset() não aceita nenhum parâmetro e exclui todas as memórias que Mem0 armazenou por meio desta instância Memory.

close()

O método close() libera a conexão SQLite local que o Mem0 usa para o banco de dados de histórico. Este método não afeta sua conexão com o MongoDB.

m.close()

close() não aceita parâmetros. Mem0 chamar automaticamente se você usar a instância Memory como um gerenciador de contexto.