Anthropic 記憶儲存 API 切換分頁與路徑語義，舊游標及查詢參數可能失效

Anthropic 已讓 Claude Managed Agents 的記憶儲存端點採用 `agent-memory-2026-07-22` 行為。核心變更落在 `GET /v1/memory_stores/{id}/memories`：伺服器改以穩定但不由用戶指定的順序回傳結果，`order_by` 與 `order` 會被忽略；`depth` 只能省略或設為 0、1；`path_prefix` 必須以斜線結尾，並按完整路徑區段比對，不再當作任意子字串搜尋。

這些限制會直接影響記憶同步器。舊版游標不能沿用到新語義，遷移時必須從第一頁重新掃描；若應用同時送出新舊 beta 標頭，API 會回傳 400。Anthropic 的 Python、TypeScript、Go、Java、Ruby、PHP、C# 與 CLI SDK 已改送新標頭，但自行覆寫 `betas`、手寫 HTTP 客戶端或透過代理閘道呼叫的系統仍需人工檢查。工程團隊還應驗證目錄列舉、增量同步、刪除偵測及重試後去重，而不能只確認請求成功。

記憶儲存本身是工作區範圍的文字文件集合，可在建立 session 時掛載至 `/mnt/memory/`，並設定唯讀或讀寫權限。這使代理能跨 session 保留偏好與專案知識，卻也擴大信任邊界。近期研究顯示，已被植入記憶檔案的提示注入可影響後續 session，且攻擊成功率會隨模型、目標與互動順序大幅變化。因此新版確定性列舉有利於稽核和同步，卻沒有解決內容可信度問題。部署者下一步應把記憶寫入視為具權限的狀態變更，加入來源標記、版本審查、唯讀掛載與異常修改告警。