2.10.0 Memory API 文档修订
| 项目 | 说明 |
|---|---|
| 服务版本 | 2.10.0 |
| 范围 | 仅 Memory;不声明本仓其他功能已同步整版。 |
| SDK 安装版本 | Memory 专项验证与示例固定使用 agentbase-node-sdk@2.9.0;通用接入的 2.10.0 发布事实另见产品维护记录。 |
| 日期 | 2026-10-16 |
| 服务事实来源分支 | release-2.10.0(固定快照,后续分支移动不改变本记录) |
| 本迭代源 commit | 611a92b4853f3eea6c3ae83d2a0ec3b0480bd582(最终正文契约核对、定向单元测试及测试机部署共同使用) |
| 上一迭代源 commit | ebae954094883b847bf582cfbe9fbe58ae0a7499(上一版已登记的 v2.9.0,未用后查分支尖端替代) |
| 文档基线 commit | bbc80703db6f868846a3121c0938bbc4b4cd3bb7(开始任务时冻结的 origin/master;本任务目标按用户要求为 v2.10.0) |
| SDK 事实快照 | v2.9.0@58840fd6446526e832a050717419dc60522defc1(SDK 管线,不是服务快照) |
新增端点与能力
Memory 写入/搜索补充 media,写入、导入、画像与蒸馏补充可选 pipelineId;当前 SDK 不发送未声明参数,使用 HTTP 接入。项目管理与人工确认继续在 Console 使用,不混为普通项目 API Key 面。
变更端点
校正记忆写入、批次结果、搜索嵌套结构、统一召回、画像 profileExtraction、知识列表、导入导出与上下文治理的请求/响应;保留原 54 项业务操作覆盖面。参数、版本和逐项失败处理以当前契约为准。
废弃端点
旧 Resource/claim/项目绑定初始化流程从接入路径移除。项目禁用使用 enabled=false,永久删除项目 Memory 不是解绑。
文档变化
54 项业务操作保留原路径,重新核对必填参数、默认值、响应字段及 curl 请求。补充异步状态、CAS、幂等、媒体限制、渐进式检索、反馈归因与权限边界;纠正导出任务标识及其 job 包装,直接编码数据由同步导出查询返回。Memory 的 DELETE 正文和分页约定补充到认证通则。
完整复核进一步校正主动删除:status=forgotten 不表示只保留逻辑标记,2.10.0 会删除记录和检索数据,保留来源及审计;知识遗忘与单条记忆删除的语义分开说明。普通 create/update 不绕过已遗忘内容保护,重新学习需要显式 reRemember 与新幂等键。
产品操作见 Memory 手册,SDK 用户流程见 SDK 文档记录,接口见 API 参考。
证据与语言状态
仅修订 zh-CN Memory 文档,其他功能与 en-US/ja-JP 未在本任务更新。54 项操作及请求示例通过参数、认证头、必填输入与条件约束检查;代码围栏、JSON 与 shell 语法检查通过。文档工具 77 项测试通过,HTML 构建与本地链接检查通过。本专项示例安装仍为 2.9.0,后续 SDK 2.10.0 发布事实见产品维护记录;未进行在线接口或真实模型回归。
固定来源与发布证据
服务与文档基线同 产品维护记录。SDK 2.9.0 的固定管线提交、Release id 1300、build.json / delivery.json / SHA256SUMS 入口,以及本轮 registry 版本与 integrity 查询结果统一登记于 SDK 发布证据的“固定来源与发布证据”节。本轮没有重新审计六个 SDK 归档的完整内容;没有新 SDK 发布声明,也没有在线故障注入。
审查勘误:errorCode 在写入结果、任务、actions 与 fallback 中均为可省略字符串;失败、部分失败示例与固定 DTO 核对。Skill 的完整接入材料随 ZIP 自包含交付,新增打包链接边界与响应类型回归检查。
2026-10-19 通用发布与兼容补充
非 Memory 通用文档对应服务发布源 0a5d23f9349028496286572fd43117aa6f8fce0a,SDK 发布 v2.10.0 / revision 394f2a53dacfc2494f1f3e71082d9f09b9734ff1,制品六个 npm 坐标与六个 ZIP 的实际证据见 automation/release-evidence/2.10.0.json 发布索引。本页前文保留 Memory 专项 2.9 SDK 的历史验证边界,不把发布证明当在线全量兼容验收。当前适用范围见 Skill 的 references/compatibility.md 兼容说明。