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 兼容说明。
2026-10-22 知识库单库检索参数与响应字段勘误
本节补齐 v2.10.0 已实现但 REST 参考漏列的 POST /knowledgebases/{knowledgeBaseId}/search 契约,不新增服务端接口或行为:
- 补录
useKnowledgeGraph、useWiki、graphOptions、wikiOptions、allowDegraded与versionId,并注明开关默认值和版本选择语义。 - 补充增强能力
capabilities/degradedCapabilities、resolvedVersionId以及结果来源字段,便于调用方识别索引结果与降级状态。allowDegraded默认true;若调用方要求增强检索失败时整体失败,应传false。 - 删除单库和跨库示例中的
recallLimit: 0。显式值必须在 1–100 且不小于limit;跨库检索还要求不小于所选知识库数量。使用服务端默认召回宽度时应省略该字段。 - SDK 与 Skill 指引同步更正降级默认值。
来源固定为 appbase v2.10.0@0a5d23f9349028496286572fd43117aa6f8fce0a 的单库 Search 与跨库 Searches routes、search services / augmented search service,以及 agentbase-sdks v2.10.0@394f2a53dacfc2494f1f3e71082d9f09b9734ff1 的 Server OpenAPI spec、Node service 和 result model。对应的 API 参考、SDK 指引和 Skill 指引仅更新 zh-CN;本地文档一致性和目标页面渲染结果登记在任务证据中,未执行在线检索。
2026-10-23 Functions 部署与执行列表契约补充
固定服务来源 appbase v2.10.0@0a5d23f9349028496286572fd43117aa6f8fce0a:Functions Deployments Create、JavaJarArtifact、DeploymentSizeLimit、Executions XList 与 ExecutionReadGuard;SDK 对照 agentbase-sdks v2.10.0@394f2a53dacfc2494f1f3e71082d9f09b9734ff1 Node Functions。
补齐普通执行列表的 path / pathMatch / method,注明 Node xpath 与 Web 列表访问边界;澄清 JAR Main-Class、Index.java 兼容字段、大小上限、分片一致性及异步接收不等于激活或执行成功。接口本身未改变,历史条目保留;没有建立 appbase/docs 自动复制链路。
2026-10-22 基于 release-2.10.2 基准的全量 REST API 参考文档升级
- 源码基准与版本钉:参照
https://code.alipay.com/obai/appbase?ref=release-2.10.2(0983b818445bcf261f54c41984ff0d66832ec201)核对全部服务端 Controller 与路由定义,文档发布版本固定为 v2.10.0(2.10.0),冻结基线提交0a5d23f9349028496286572fd43117aa6f8fce0a与 SDK 发布证据保持不变。 - 全量 25 篇 API 文档生产级深化:将
apis/zh-CN/下全部 25 篇 REST API 参考手册统一升级为包含## 服务与资源边界、## 认证与权限、## 端点总览、## 端点详解的完整生产级规格说明(单篇均>= 6000字节),补齐请求/响应 JSON Schema、枚举约束、幂等键与版本并发控制(If-Match/If-None-Match/expectedConfigVersion)、可执行cURL示例与错误码排查表。 - 新增与强化的核心端点文档:在
apis/zh-CN/knowledge-base/overview.md与apis/zh-CN/models-ai-gateway/overview.md中完整补充项目级词库 API(/v1/lexicons、/v1/lexicons/{lexiconId}/entries、/v1/knowledgebases/{knowledgeBaseId}/lexicons)与项目级 Agent Runtime 工作台 API(/v1/agent-runtime/project/config、/v1/agent-runtime/project/lexicons、/v1/agent-runtime/project/threads、/v1/agent-runtime/project/runs)。
- 文档创建/更新定位规则勘误:非空documentTag与空subProductId组合仍派生首段;更新清空独立字段后,有效读取可回退已有标签首段。sectionCode仅创建支持,更新参数表无此字段。