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 인덱스 대해 시맨틱 검색 실행하고 쿼리 문자열과 가장 관련성이 높은 메모리를 반환합니다.

다음 예시 특정 사용자의 기억에서 가장 관련성이 높은 5개의 결과를 검색합니다.

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은 이 기록을 MongoDB 가 아닌 로컬 SQLite 데이터베이스 에 저장합니다. 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() 어떤 매개변수도 허용하지 않습니다. Mem0은 Memory 인스턴스 컨텍스트 관리자로 사용하는 경우 자동으로 호출합니다.