SDK 사용법

SDK 사용법

파이썬/타입스크립트 SDK는 MemoryClient(플랫폼 API) 기준으로 동작해요. 먼저 설치해요.

pip install mem0ai

클라이언트를 만들고 메모리를 저장·검색해요.

from mem0 import MemoryClient
client = MemoryClient(api_key="m0-your-api-key")

주요 메서드는 다음과 같아요.

  • add(messages, user_id=..., agent_id=..., run_id=..., metadata=..., infer=True): 메모리 저장. infer=False면 추론 없이 원문 그대로 저장.
  • search(query, filters=..., top_k=..., rerank=..., threshold=...): 메모리 검색. filters={"user_id": "..."}로 사용자/에이전트 범위를 좁혀요.
  • get() / get_all(): 메모리 조회. get_all은 user_id, agent_id, app_id, run_id 중 하나 이상을 필터로 요구해요.
  • update(): 메모리 수정.
  • delete() / deleteAll(): 메모리 제거.
  • history(): 메모리 변경 이력.

v3부터는 엔티티 ID(user_id, agent_id, run_id)를 최상위 파라미터가 아니라 filters 안에 넣는 방식으로 바뀌었어요. 검색 시 반드시 스코프 필터를 지정해서 서로 다른 사용자·에이전트·세션의 메모리가 섞이지 않게 해요. Mem0 동작에 LLM이 필요하고 기본은 OpenAI의 gpt-5-mini지만 다양한 LLM을 지원해요.

더 알아보기