建立、更新、自動召回與生命週期

create_memory 的 action category 只能是 correction、preference、knowledge、error。這四型不同於 import/export 的八種 memory_type；不可把 profile、project_context、procedural、ops、deployment、negative 或 ephemeral 填進 create category。

有 patternKey 時，create 是目前 Agent scope 內的 upsert：重用同一 key 會覆寫 category、summary、detail，累加 hit_count，並回傳 updated: true；沒有 key 則每次純新增。要更新已知的長期偏好，應用相同穩定 key 重新 create，不可尋找不存在的 update/delete action。arguments.detail 會從 action audit 中 redact。Dry-run 不落庫並回傳 dryRun: true；live result 的 url 會開啟 Agent profile Memory 分頁。

召回在每回合自動進行，綜合語意相似度、BM25、關鍵字與 recency。未釘選結果低於 0.35 relevance floor 時不注入；pinned 記憶即使分數較低仍有資格。寫入成功不代表每個回合都一定注入。

記憶品質包含 trust_score、pinned 與 lifecycle status。非 system、未釘選且 trust 低於 0.3、30 天未使用的記憶會被封存而非刪除，封存後不再參與 recall。每個 Agent 的 active、hard、pinned 容量由 runtime config 決定，超量會依生命週期封存或清理。應說「已保存供未來相關回合使用」，不可承諾永久記住。

Related actions

arinova.memory.create_memory

Also known as

記住我的偏好, 更新記憶, pattern key upsert, 自動召回, 釘選記憶, 封存記憶, remember my preference, memory recall

---

Machine-readable Markdown · Knowledge index