Integre o MongoDB com o Mem0

add()

O método add() extrai fato de uma conversa e os grava em sua collection como documentos de memória. Se já existir uma memória semanticamente equivalente para a entidade, Mem0 atualizará essa memória em vez de criar um documento duplicado.

O exemplo a seguir passa uma conversa para o método add() e tem 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 por seu valor de ID sem executar uma pesquisa vetorial.

O exemplo a seguir recupera uma memória diretamente por 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 é exigido 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 MongoDB Vector Search e retorna as memória que são mais relevantes para uma string de query.

O exemplo a seguir pesquisa nas memória de um usuário específico os 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. Use este método para exibir o histórico completo da memória de uma entidade.

O exemplo a seguir retorna e imprime todas as memória 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 a incorporação 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 collection.

O exemplo a seguir exclui uma memória por seu 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 excluído.

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 recordações para um usuário específico:

m.delete_all(user_id="alice")

histórico()

O método history() retorna o histórico de edição para uma única memória, incluindo cada versão do texto e o tipo de evento . O Mem0 armazena esse 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ção de 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 é exigido e aceita o valor id do documento de memória cujo histórico você deseja recuperar.

reiniciar()

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

• Exclui sua coleção do MongoDB e seus índices do MongoDB Vector Search 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ória s em vez de usar o método delete_all() para excluí-las uma entidade de cada vez.

m.reset()

reset() não aceita nenhum parâmetro e exclui todas as memória que Mem0 armazenou através desta instância do Memory.

close()

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

m.close()

close() não aceita nenhum parâmetro. Mem0 chama isso automaticamente se você usar a instância Memory como gerenciador de contexto.