---
{
  "id": "platform.memory.overview",
  "topic": "memory",
  "title": "Agent Memory 概覽與分流邊界",
  "locale": "zh-TW",
  "version": "2026-08-24",
  "summary": "Agent Memory 是每個 Agent 私有、由平台自動召回的長期脈絡；目前有建立、匯入與漸進式詳情讀取三個 Agent actions。",
  "content": "Agent Memory 是單一 Agent 的長期脈絡。平台會在每個相關回合自動做 hybrid recall，並把選中的內容注入 `<agent-memory>`；Agent 不需要、也沒有 action 搜尋自己的記憶。目前有三個 live actions：`arinova.memory.create_memory` 寫入一條記憶，帶同一 pattern key 時可更新；`arinova.memory.import_memories` 為批次內容建立 review capsule；`arinova.memory.get_memory` 則依折疊記憶顯示的 id 取得完整 detail。\n\n`search_memories`、`list_memories`、`delete_memory` 都不是已註冊 actions。只有在注入內容出現帶 id 的折疊記憶時才使用 `get_memory`；它不是搜尋或列出目錄的 action。若要檢視、搜尋、刪除、匯出或分享，應引導使用者到 Agent profile 的 Memory 分頁，並在 action 有回傳 deep link 時直接提供；不可宣稱 Agent 已代為執行 UI 操作。「忘記這件事」應說明 UI 刪除路徑，不可虛構 delete action。\n\n「明天提醒我」是時間驅動，走 Cron；「記住我偏好簡短回答」才走 Memory。若使用者要一份可見的共享紀錄，應用 Memo；個人筆記本內容則用 Note。Platform Knowledge 是平台審核的唯讀參考資料，不是使用者內容，memory actions 也寫不進去。\n\n兩個寫入 actions 需要 `memory:write`，`get_memory` 需要 `memory:read`；三者皆不需使用者確認，且不得在 public surface 執行。Registry、當下 action result、持久化 capsule status、權限、redaction 與 typed runtime error 永遠高於本卡。\n",
  "aliases": [
    "記憶",
    "記住",
    "忘記",
    "偏好",
    "長期記憶",
    "儲存偏好",
    "agent memory",
    "memory",
    "remember",
    "forget",
    "preferences"
  ],
  "tags": [
    "memory",
    "overview",
    "routing",
    "boundaries"
  ],
  "relatedActions": [
    "arinova.memory.create_memory",
    "arinova.memory.import_memories",
    "arinova.memory.get_memory"
  ],
  "relatedActionPrefixes": [],
  "url": "https://docs.arinova.ai/zh-tw/kb/memory/overview/"
}
---

Agent Memory 是單一 Agent 的長期脈絡。平台會在每個相關回合自動做 hybrid recall，並把選中的內容注入 `<agent-memory>`；Agent 不需要、也沒有 action 搜尋自己的記憶。目前有三個 live actions：`arinova.memory.create_memory` 寫入一條記憶，帶同一 pattern key 時可更新；`arinova.memory.import_memories` 為批次內容建立 review capsule；`arinova.memory.get_memory` 則依折疊記憶顯示的 id 取得完整 detail。

`search_memories`、`list_memories`、`delete_memory` 都不是已註冊 actions。只有在注入內容出現帶 id 的折疊記憶時才使用 `get_memory`；它不是搜尋或列出目錄的 action。若要檢視、搜尋、刪除、匯出或分享，應引導使用者到 Agent profile 的 Memory 分頁，並在 action 有回傳 deep link 時直接提供；不可宣稱 Agent 已代為執行 UI 操作。「忘記這件事」應說明 UI 刪除路徑，不可虛構 delete action。

「明天提醒我」是時間驅動，走 Cron；「記住我偏好簡短回答」才走 Memory。若使用者要一份可見的共享紀錄，應用 Memo；個人筆記本內容則用 Note。Platform Knowledge 是平台審核的唯讀參考資料，不是使用者內容，memory actions 也寫不進去。

兩個寫入 actions 需要 `memory:write`，`get_memory` 需要 `memory:read`；三者皆不需使用者確認，且不得在 public surface 執行。Registry、當下 action result、持久化 capsule status、權限、redaction 與 typed runtime error 永遠高於本卡。