代理工具
Anthropic 記憶儲存 API 切換分頁與路徑語義,舊游標及查詢參數可能失效
Claude Managed Agents 的記憶列表行為已於 7 月 22 日套用新版規則,包括穩定排序、目錄式前綴比對與受限的查詢深度。這不只是 SDK 換標頭;既有同步程式可能遇到 400 錯誤、漏列項目或游標失效。

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,且攻擊成功率會隨模型、目標與互動順序大幅變化。因此新版確定性列舉有利於稽核和同步,卻沒有解決內容可信度問題。部署者下一步應把記憶寫入視為具權限的狀態變更,加入來源標記、版本審查、唯讀掛載與異常修改告警。