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()

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() メソッドは、テキストの各バージョンやイベントタイプなど、1 つのメモリの編集履歴を返します。 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 値を受け入れます。

delete()

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

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

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

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

このメソッドを使用してすべてのメモリをクリアし、delete_all() メソッドを使用して一度に 1 つのエンティティを削除します。

m.reset()

reset() はパラメータを受け入れず、Mem0 がこの Memoryインスタンスを通じて保存したすべてのメモリを削除します。

close()

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

m.close()

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