---
{
  "id": "platform.memory.create-and-recall",
  "topic": "memory",
  "title": "建立、更新、自動召回與生命週期",
  "locale": "zh-TW",
  "version": "2026-07-25",
  "summary": "Create 使用四種 action category 與可選 pattern-key upsert；detail 會 redact，召回則受相關性與生命週期控制。",
  "content": "`create_memory` 的 action category 只能是 `correction`、`preference`、`knowledge`、`error`。這四型不同於 import/export 的八種 `memory_type`；不可把 `profile`、`project_context`、`procedural`、`ops`、`deployment`、`negative` 或 `ephemeral` 填進 create category。\n\n有 `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 分頁。\n\n召回在每回合自動進行，綜合語意相似度、BM25、關鍵字與 recency。未釘選結果低於 0.35 relevance floor 時不注入；pinned 記憶即使分數較低仍有資格。寫入成功不代表每個回合都一定注入。\n\n記憶品質包含 `trust_score`、pinned 與 lifecycle status。非 system、未釘選且 trust 低於 0.3、30 天未使用的記憶會被封存而非刪除，封存後不再參與 recall。每個 Agent 的 active、hard、pinned 容量由 runtime config 決定，超量會依生命週期封存或清理。應說「已保存供未來相關回合使用」，不可承諾永久記住。\n",
  "aliases": [
    "記住我的偏好",
    "更新記憶",
    "pattern key upsert",
    "自動召回",
    "釘選記憶",
    "封存記憶",
    "remember my preference",
    "memory recall"
  ],
  "tags": [
    "memory",
    "create",
    "recall",
    "lifecycle"
  ],
  "relatedActions": [
    "arinova.memory.create_memory"
  ],
  "relatedActionPrefixes": [],
  "url": "https://docs.arinova.ai/zh-tw/kb/memory/create-and-recall/"
}
---

`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 決定，超量會依生命週期封存或清理。應說「已保存供未來相關回合使用」，不可承諾永久記住。