2.10.0 Memory SDK 使用文档修订
| 项目 | 说明 |
|---|---|
| 服务版本 | 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、手工保存记忆到创建 API Key、安装 SDK 的接入顺序,移除旧资源与绑定初始化流程。
增加完整 Node.js 示例,按用户行为覆盖创建、读回、列表、搜索、召回、版本更新和遗忘;补充异步轮询及逐项失败处理。
修正各语言操作卡的 CAS 版本、批量删除返回类型、exportId、画像消息输入、蒸馏证据与幂等键、上下文治理参数。
保留既有 6 类语言页签。2.9.0 SDK 尚未声明 media/pipelineId 的方法参数,使用 HTTP;项目生命周期和人工确认由 Console 管理。
完整复核纠正处理方式、主动删除和防止重新写入已遗忘内容的说明。演示正文包含每次操作标记,异步示例打印 jobId 和逐项结果,说明独立脚本的准备与续查方式;不再把控制台列表描述为可编辑。
跨页同步 Java、JavaScript 示例:Java 使用实际的类型化参数签名,JavaScript 先完成直写再检索,统一召回显式传 scope/userId。画像操作卡先提交提取,已有画像的读取、来源查询及重建独立执行,避免新项目先读画像即失败。
产品操作见 Memory 手册,示例见 SDK 接入与记忆操作。完整 HTTP 契约变化见 API 文档记录。
证据与语言状态
仅修订 zh-CN Memory 文档,其他功能与 en-US/ja-JP 未在本任务更新。实际安装 2.9.0 SDK 的模拟传输验证覆盖完整流程、连续两轮新演示、6 张操作卡的 22 次调用、批量删除失败中止,以及异步成功/超时/部分失败/失败分支;Java/Python/Go 操作卡核对签名、参数与枚举。文档工具 77 项测试通过,HTML 构建与本地链接检查通过。
本节记录的是原 Memory 专项的 SDK 2.9.0 验证;后续 SDK 2.10.0 发布与通用安装坐标已由本迭代基线登记,见产品维护记录。模拟测试不代表在线接口或真实模型质量验证。
固定来源与发布证据
服务与文档基线同 产品维护记录,截图及 Console 实操也使用该页登记的同一部署 commit;SDK 模拟传输验证不代表在线模型回归。SDK 2.9.0 的既有发布核验见 上一版交付记录。本轮重新查询 SDK v2.9.0 Release(id 1300,九附件),以及已存在的 build.json、delivery.json、SHA256SUMS 元数据;没有重新审计六个归档的完整内容。
本轮 registry 查询返回 agentbase-node-sdk@2.9.0,tarball 为 https://registry.npmmirror.com/agentbase-node-sdk/-/agentbase-node-sdk-2.9.0.tgz,dist.integrity 为 sha512-B4ZdbxRhPP7AL1xWc18Vlz+FcAULA14N7Yr8mQSk7jVunlPZfGLs/ChaXi8oYvNMa9VbGGxvSvNoID3u1rD3BA==。本任务使用该精确安装版本,未把服务 2.10.0 的更新写成 SDK 2.10.0 发布。
审查勘误: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 通用语言示例版本钉修正
zh-CN/examples/javascript.md的三个 npm 坐标已从 2.9.0 更新到已发布的 2.10.0;zh-CN/examples/java.md的 Server / Console ZIP、GAV 依赖与下载说明已更新到 release v2.10.0。Java 示例中识别出的 20 个服务调用按 agentbase-sdks
v2.10.0(394f2a53dacfc2494f1f3e71082d9f09b9734ff1)源码核对参数个数;修正TablesDB.create、Storage.createBucket/createFile、KnowledgeBases.create/createIngestion、Moderation.createConfig与Memory.create。Memory 调用另按签名顺序补入pipelineId与media。本轮为源码核对,不代表 Java 示例已通过发行 JAR 编译或在线服务验证。JavaScript 配额与用量示例按 agentbase-sdks
v2.10.0源码修正:项目配额改用 ConsoleProjects(Server NodeProjects不含该方法);组织用量改用单独导出的Organizations服务(sdk.forConsole未暴露该属性)。另补充 Client WebAccount的账号级 quota 能力,与 Console/Server 的项目级和账号级边界分开说明。同步更正 Client/Console/Server SDK 导航及限额、用量页。Node.js SDK 的
InputFile仅通过agentbase-node-sdk/file子路径导出,主入口未导出该类;已修正示例、Storage、Functions、Deployment 和 Sites 指南中的 import。另修正 JS 示例把getFileDownload当 URL/重定向使用、给Sites.createVariable传入 SDK 未接受的variableId。依据packages/sdks/server-nodejs/package.json、src/index.ts、src/inputFile.ts、src/services/storage.ts与src/services/sites.ts源码核对;本次不代表 npm 制品编译验证。当前发行坐标、registry integrity 与 ZIP 摘要以
automation/release-evidence/2.10.0.json为准。Memory 专项完整 Node.js 流程仍保留 SDK 2.9.0 的历史模拟测试证据;该证据范围不扩展为服务 2.10.0 的完整在线兼容结论,见skills/ob-agentbase/references/compatibility.md。
2026-10-22 KnowledgeBases SDK 示例边界与 Wiki 并发版本
agentbase-web-sdk的 KnowledgeBases 服务除 Yuque OAuth 会话外,还提供当前用户已授权语雀个人文档 URL 导入;浏览器端仍不提供知识库检索、Wiki、GraphRAG 或索引治理方法。已据此收窄 JavaScript 示例的客户端/服务端能力说明。修正 Node.js Wiki 恢复、提案采纳、冲突解决和删除示例:
contentRevision是数值,写操作前从当前页面重新读取该值;并将提案、冲突处理标明为按场景选择的独立操作。删除示例明确为可选破坏性操作。依据 agentbase-sdks
v2.10.0@394f2a53dacfc2494f1f3e71082d9f09b9734ff1的 client-web/server-nodejs 生成服务签名和 appbasev2.10.0@0a5d23f9349028496286572fd43117aa6f8fce0a的 Wiki 路由核对;本次为源码契约检查,不代表 SDK 制品编译或在线 Wiki 操作验证。
2026-10-22 TablesDB 建表索引示例修正
JavaScript 示例的
TablesDB.createTable索引定义补充必填的attributes,使title_idx明确关联title列。Java 示例的
DatabaseIndexDefinition同样补充.setAttributes(List.of("title"));服务 Validator 要求每个索引提供非空列键数组,缺失时建表请求会返回参数错误。依据 agentbase-sdks
v2.10.0@394f2a53dacfc2494f1f3e71082d9f09b9734ff1的DatabaseIndexDefinition类型、Server Node 服务签名与 appbase v2.10.0 TablesDB create route 核对;本次为源码静态检查,不代表执行了建表请求或 SDK 制品编译。
2026-10-22 Java Functions 异步执行轮询示例
修正
examples/java.md与functions.md的 Java 示例:显式使用async=true,并从返回的Execution读取functionId和 execution ID 调用getExecution。原注释把async=false的同步示例描述成异步轮询,且引用了未定义的两个变量。依据 agentbase-sdks
v2.10.0@394f2a53dacfc2494f1f3e71082d9f09b9734ff1的Functions.createExecution/getExecution签名与Execution模型,以及 appbasev2.10.0@0a5d23f9349028496286572fd43117aa6f8fce0a的 Functions Executions 创建/查询路由核对;本次为源码静态检查,不代表 JAR 编译或在线函数执行。
2026-10-22 Java Storage / Functions 示例导入
examples/java.md的 Storage / Functions 代码块补齐Storage、Functions、InputFile、Execution、ExecutionMethod与ID的显式 imports,避免读者单独复制该节时遇到符号无法解析。导入包名依据 agentbase-sdks
v2.10.0@394f2a53dacfc2494f1f3e71082d9f09b9734ff1对应 Java 类型的声明核对;本次为源码静态检查,不代表发行 ZIP 编译验证。
2026-10-22 Java 示例事实源版本校正
examples/java.md底部的事实源列表从 v2.7.0 更新为 appbase 与 agentbase-sdks v2.10.0,并固定对应的源提交与 release revision;本修订纠正事实源标注,不改变示例能力范围。Java Storage / Functions 代码块已使用摘要匹配 v2.10.0 发布索引的 Server SDK ZIP,在 JDK 11 环境下通过离线编译;不代表其他 Java 代码块均已编译或在线运行。
2026-10-22 Java Server 示例编译勘误
按 v2.10.0 Server SDK 发布 JAR 修正错误处理示例的异常类名为
AgentbaseException,并为 Sites 示例补充具体 enum 与 service imports。本次基于发布制品的局部编译用于核对 Java 方法/类型签名,不代表在线请求或所有语言 SDK 的集成验收。
2026-10-22 Console Java 认证与治理示例勘误
Console Java 初始化改为
setCookie加载完整 Session Cookie,或单独选择短期 JWT;移除不存在的setSession和通用 Console Key 优先推荐。异常类名改为io.agentbase.console.exceptions.AgentbaseException。修正
Projects.create示例缺少末尾powercontextEnabled参数;更正“Java 无配额/限频方法”的旧结论,说明/quota-limits与/limits方法已提供、响应为Object,字段和权限仍以配额功能页为准。将聚合用量与旧
/project/usage的 Client 上下文分开,旧接口示例显式提供起止日期;API Key 创建结果不再写入终端日志。同步更新 Skill Java Console reference。使用摘要匹配发布索引的 Server/Console Java ZIP,在 JDK 11、断网条件下编译受影响的 20 个片段(Java 综合示例 10、Console Java 5、用量 2、Skill 初始化/异常/用量 3);编译包装只补 imports、方法体与外部 ID/Client 占位变量。未发起真实 API 请求,未据此宣称所有 SDK 语义或语言均已验收。
2026-10-22 示例闭环与 Console 权限补正
Java/JavaScript TablesDB 示例补齐必填布尔列
done及写入值,使后续过滤、聚合与 SQL 使用的列和建表定义一致。配额/限频页的 REST 示例改用
console上下文与完整 Console Session Cookie;补充/limits的 owner 权限边界,业务项目 ID 放在 URL 中。移除 Node ServerProjects未提供的限频调用,并同步 Java Console 已提供配额/限频方法的说明。同一固定 v2.10.0 服务/SDK 来源核对;定向回归覆盖管理请求头、SDK 方法面和建表列消费者,Java 20 片段重新离线编译通过。未扩大为在线 API 验收。
2026-10-22 账号 Key 身份绑定与 Skill 配额一致性
账号配额说明按实际身份模型区分项目 Key、账号 Key 与用户 Session/JWT;新增独立 Node Account 示例,显式装载
console上下文、账号 Key 和所属用户X-Appwrite-User,禁止混装 Session/JWT。同步 Skill Node reference 的能力表和 quota/ratelimit 段:移除不存在的 Server Projects 调用,项目管理链接至 Console 示例。账号级方法存在不代表普通项目 Key 可调用。
固定服务来源
v2.10.0@0a5d23f9349028496286572fd43117aa6f8fce0a的 scopes、resources 与 Account QuotaLimits,SDK 来源v2.10.0@394f2a53dacfc2494f1f3e71082d9f09b9734ff1的 Client/Account/Projects。持久检查覆盖账号 Key/用户头与禁止混凭据;保留缺头、项目 Key 误用的负对照,不宣称在线鉴权验收。
2026-10-22 配额参考链接目标同步
Console Skill 的配额速查与综合限频说明移除遗留的 Node Server
Projects.getLimits/updateLimits推荐,统一为 Node Consoleclient.call;补充 Console 用户凭据及/limits的 owner / 管理员条件。修正范围包含 Node Skill 的直接链接目标;定向回归同步检查入口和引用页,保留原失败记录。事实来源仍为上述固定 v2.10.0 SDK/服务提交,未进行在线权限验收。
2026-10-22 Skill 主入口配额方法面统一
Skill 总纲、GUIDE、部署包选型和 Java Server 说明统一项目配额/限频的 Console 方法与身份边界,清除遗留的 Node Server 项目管理推荐;Node Server Account 的账号级能力保持独立说明。
同一方法契约的当前非历史 Skill/SDK/API 文档已做全量文本检索,持久检查覆盖根入口、能力表、操作步骤和直接引用页;历史 release/changelog 不回写,不扩展其他专题审计。
2026-10-23 Functions 使用流程补充
按 appbase v2.10.0@0a5d23f9349028496286572fd43117aa6f8fce0a 的 docs/products/v2.10.x/functions/、Functions 路由与 ExecutionReadGuard,以及 agentbase-sdks v2.10.0@394f2a53dacfc2494f1f3e71082d9f09b9734ff1 的 Node Functions/枚举/package exports,补充 Java 17 预构建 JAR 和路径/方法筛选示例。
当前 SDK 直接使用
createDeployment与ArtifactMode.Javajar,不沿用来源教程中 SDK 2.9.0 的低层兼容上传调用;InputFile保持从/file导入。Node 参数
xpath映射 HTTPpath,明确分页、查询串和 waiting/processing 边界。Web 不可调用执行列表/路径列表,按 ID 查询单条 execution 仍按原权限处理。部署示例默认不激活,依次检查 ready、当前 deploymentId 和真实执行;JAR 大小受独立上限与套餐共同限制。SDK 示例验证只覆盖本地已发布包的导出与请求契约,不声明业务环境在线部署成功。两仓独立维护,无自动同步。
Functions 路径参数勘误
Node.js 与 Web SDK 对象参数使用 xpath,由 SDK 序列化为 HTTP path。统一触发执行、执行路径查询及 Skill 中的旧示例,避免路径被忽略或缺少必填参数;发布包的原文示例模拟传输验证覆盖这些调用,不代表在线函数执行验收。
2026-10-22 基于 release-2.10.2 基准的全量多语言 SDK 开发指南升级
源码基准与制品版本钉:参照
https://code.alipay.com/obai/appbase?ref=release-2.10.2(0983b818445bcf261f54c41984ff0d66832ec201)与agentbase-sdksv2.10.0(revision394f2a53dacfc2494f1f3e71082d9f09b9734ff1),文档发布版本与全部 SDK 包坐标严格保持为 2.10.0(agentbase-node-sdk@2.10.0、agentbase-web-sdk@2.10.0、agentbase-console-sdk@2.10.0等)。全量 51 篇 SDK 指南生产级重构:将
sdks/zh-CN/下全部 51 篇开发指南升级为包含 SDK 选型矩阵(Server / Client / Console SDK)、安装与客户端初始化、多语言<Tabs groupId="sdk-language">完整可运行代码(Node.js / Web / Python / Java / Go / REST)、参数与返回值契约、异步轮询及异常处理最佳实践的生产级指南(单篇均>= 6000字节)。知识库、词库(Lexicon)与 AI 网关接入示例补齐:在
sdks/zh-CN/knowledge-base/overview.md、sdks/zh-CN/models-ai-gateway/与sdks/zh-CN/observability/overview.md中补充基于 DashScope 模型(qwen-plus、text-embedding-v3、qwen3.7-text-rerank)的端到端混合检索、Lexicon 词典绑定、网关调用与可观测性上报实战示例。整合勘误:Search 的四个增强/答案参数仅属于 createSearch;跨库示例删除不支持参数,元数据过滤使用 logic/conditions 并说明库级覆盖兜底。返回模型与发布 SDK 对齐;显式 rerankProviderRef 与 rerankModel 均保留调用失败语义。
Search 五语言及 Python 文档上传入口统一合法定位值:子产品仅字母或数字,定位标识章节段仅数字、末段 32 位十六进制。补持久正反例,发布 Node 包检查同时验证定位格式,避免仅传输成功被误认为服务接受。
文档创建/更新能力汇总勘误:sectionCode仅创建支持;更新通过documentTag/subProductId维护定位。API与Skill同步,已发布Skill差异页只追加勘误,不回写原文。