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 値によって 1 つのメモリ ドキュメントを検索します。

以下の例では、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()

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() メソッドは、コレクションから 1 つのメモリ ドキュメントを削除します。

次の例では、メモリを 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 がそのデータベースを書き込み (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()

reset() メソッドは、次のアクションを実行します。

• MongoDB コレクション、およびその MongoDB ベクトル検索インデックスおよび MongoDB Search インデックスを削除します。

• ローカル履歴データベースをリセットする

• コレクションとそのインデックスをゼロから再作成します。

すべてのメモリーをクリアするには、delete_all() メソッドを使用していちえンティティずつ削除するよりも、このメソッドを使用します。

m.reset()

reset() パラメータを受け取りません。そして、この Memory インスタンスを介して Mem0 が保存したすべてのメモリを削除します。

close()

close() メソッドは、Mem0 が履歴データベース用に使用するローカル SQLite 接続を解放します。このメソッドはユーザーの MongoDB 接続に影響しません。

m.close()

close() パラメータを受け入れません。Mem0 が、Memory インスタンスをコンテキスト マネージャーとして使用する場合、自動的に呼び出します。