MongoDB와 Mem0을 통합하기

add()

add() 메서드는 대화에서 사실을 추출하여 메모리 문서로 컬렉션에 쓰기 (write)합니다. 개체에 대해 의미적으로 동등한 메모리가 이미 존재하는 경우, 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 벡터 검색 인덱스를 대상으로 시맨틱 검색을 실행하고, 쿼리 문자열과 가장 관련이 높은 메모리를 반환합니다.

다음 예시는 특정 사용자의 메모리에서 가장 관련있는 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() 메서드는 텍스트의 각 버전과 이벤트 유형을 포함하여 단일 메모리에 대한 편집 이력을 반환합니다. Mem0은 이 기록을 MongoDB에서가 아니라 로컬 SQLite 데이터베이스에 저장합니다. Mem0이 해당 데이터베이스를 쓰기 (write) 위치를 변경하려면 구성 사전에서 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() 메서드는 다음 조치를 실행합니다.

• MongoDB 컬렉션 및 그의 MongoDB 벡터 검색 및 MongoDB Search 인덱스를 삭제합니다.

• 로컬 기록 데이터베이스를 초기화합니다.

• 컬렉션과 인덱스를 초기 상태로 다시 만들어내다.

하나의 객체를 하나씩 삭제하는 delete_all() 방법 대신 이 방법을 사용하여 모든 메모리를 지우세요.

m.reset()

reset() 매개변수를 받지 않습니다. 및 이 Memory 인스턴스를 통해 Mem0이 저장한 모든 메모리를 삭제합니다.

close()

close() 메서드는 Mem0이 이력 데이터베이스에 대한 로컬 SQLite 연결을 해제합니다. 이 방법은 사용자의 MongoDB 연결에 영향을 주지 않습니다.

m.close()

close() 어떤 매개변수도 허용하지 않습니다. Mem0은 Memory 인스턴스를 컨텍스트 관리자로 사용하는 경우 자동으로 호출합니다.