pin

Mem0 のピン留め

メモリをピン留めして優先度を高く設定し、削除されないように保護します。

実行

手順 1：メモリを見つける

ユーザーは検索クエリまたはメモリ ID を指定します。

メモリ ID の場合：

• ID を指定して get_memory を呼び出します。

検索クエリの場合：

• クエリと filters={"AND": [{"user_id": "<id>"}, {"app_id": "<pid>"}]}、top_k=5 を指定して search_memories を呼び出します。
• 内容のプレビュー付きで番号付きリストを表示します。
• 「ピン留めするメモリはどれですか？番号を入力してください。」と尋ねます。

手順 2：現在の内容を読み取る

選択したメモリ ID を指定して get_memory を呼び出します。次の情報を保存します。

• original_text — メモリのテキスト内容
• original_metadata — 既存の metadata 辞書

手順 3：ピン留めする

MCP の update_memory ツールが受け付けるのは memory_id、text、source のみで、metadata パラメーターは受け付けません。ピン留めするには、テキストにピンマーカーを追加します。

pinned_text = "[PINNED] " + original_text if not original_text.startswith("[PINNED]") else original_text
update_memory(memory_id=<selected_id>, text=pinned_text)

新しいメモリの場合（まだ保存されていないテキストをユーザーがピン留めしたい場合）：

1. 次の内容で add_memory を呼び出します。
   • text="[PINNED] <the user's text>"
   • user_id=<active_user_id>
   • app_id=<active_project_id>
   • metadata={"pinned": true, "type": "decision", "confidence": 1.0}
   • infer=False
2. 応答には event_id が含まれます。get_event_status(event_id=<event_id>) を一度呼び出してメモリ ID を取得し、その後、確認します。

手順 4：確認する

Pinned: "<memory content, first 80 chars>"
Memory ID: <id>

内容が 80 文字を超える場合にのみ ... を追加します。

ピン留めを解除する

ユーザーが「ピン留めを解除」と言った場合：

1. get_memory を呼び出して現在の内容を読み取ります。
2. テキストからピンマーカーを削除します。

   unpinned_text = original_text.removeprefix("[PINNED] ")
   update_memory(memory_id=<id>, text=unpinned_text)
   

3. Unpinned: "<content>..." と出力します。