2.6.0 SDK 侧迭代增量
| 版本 | 2.6.0 |
|---|
| 源 tag / 仓库 | v2.6.0 @ git@code.alipay.com:obai/appbase.git |
| 本迭代源 commit | 8c9beb4713496d051a477f03fd843365145d3b86 |
| 上一迭代源 commit | a8f36502c065a69bff2b7e564eedfae08bc22aad(tag v2.5.0) |
| SDK 管线 tag | agentbase-sdks v2.6.0(https://code.alipay.com/obai/agentbase-sdks/releases/v2.6.0) |
| 生成日期 | 2026-09-14 |
首次迭代说明:sdks/zh-CN/ 由本迭代首次产出(35 个文件全量首产;en-US、ja-JP 为骨架态,目录不存在)。服务版本 2.6.0(APP_VERSION_STABLE),Migration V53。
交付坐标(本迭代实际发布面)
| 语言面 | 形态 | 精确坐标 |
|---|
| JavaScript — web | npm(远程 registry) | appbase-web-sdk@22.8.0 |
| JavaScript — node | npm(远程 registry) | appbase-node-sdk@22.4.0 |
| JavaScript — console | npm(远程 registry) | appbase-console-sdk@1.16.0 |
| Java — server / console | Release ZIP 附件 + SHA256SUMS(双层 sha256sum -c) | io.agentbase:agentbase-java-sdk:2.6.0 / io.agentbase.console:agentbase-console-java-sdk:2.6.0 |
| Python — server | 2.6.0 源码版本登记 / 当前发布面 wheel | 2.6.0 源码版本 15.4.0(无可证可安装产物,见证据缺口);示例页按 agentbase-sdks v2.7.0 wheel 书写 |
| Go | 2.6.0 无交付(该面自 2.7.0 起) | 示例页按 agentbase-sdks v2.7.0 module ZIP 书写 |
契约与能力增量
- Custom OAuth2:
OAuthProvider.CustomOauth2 内置配置型 Provider(Web/Node),免新增服务端 Provider 类。 - 三级用量:Console
listUsageAggregates()(account / organizations / projects);Server/Web getUsageAggregates 固定最近 30 个 UTC 日,quantity=null 不作 0。 - 富文档 RAG:Knowledge Bases 摄取 PDF、Office、表格、MinerU 与图片资产及可选图片理解;Python 15.4.0 补齐 Knowledge Bases 调用面(canonical 声明,产物未验证,见证据缺口)。
- VectorsDB:
createSearch()(vector / fulltext / hybrid + weights)与 createTextEmbeddings(2.6.0 SDK 源码确认)。 - Observability:
createIngestion()(单批 1–100、HTTP 207 逐项 errors[])、createOtelTraces()(/observability/otel/v1/traces,源码确认)、listLogs()。 - 组织项目治理:
listInactiveByOrganization / batchReleaseByOrganization / listDeletionsByOrganization / restoreDeletionByOrganization 与 Client.setOrganization(client-web / server-nodejs / server-java 源码确认存在)。 - TablesDB:
aggregateRows / updateColumnComment(Node);列内联校验、索引禁系统字段;Schema 版本与回滚(createSchemaVersion(migration/baseline)/ getSchemaVersion / listSchemaVersions / rollbackSchemaVersion,2.6.0 SDK 源码确认;回滚仅切生效指针,不执行物理 DDL);JsonTable 与表模式转换为 2.7 起,不在本迭代。 - AI Gateway:新统一 AI 数据面(Gateway / Target / Tool / Consumer / Policy / MCP / A2A),与 LLM Gateway 并存,Key 与路径不互换。
- Schema 迁移:激活前校验物理结构,失败保留原 active。
- Memory:初始化有界重试、范围删除与写入串行、quota 条件更新、身份与 revision 绑定更严格。
- 安全默认值:Function API Key 禁 query string 传递;Function/Site 受限身份运行;远程 Avatar/Favicon/Screenshot 默认收紧。
- Agent Runtime:2.6.0 五个生成 SDK 均无
AgentRuntime service(server-nodejs scopes 含 agent-runtime.execute 枚举),经 Console 消费。 - SQL Proxy:
Sql.query/execute 仅 Console SDK 提供;Console SQL 页不再展示 MySQL wire 凭据。
sdks/ 文档自身增删改
- 首次生成:
sdks/zh-CN/ 43 个文件全量首产——根 3(integration.md/environment.md/troubleshooting.md)+ account/ 2 + organization/ 3 + project/ 22 + SDK 轴 9(client-sdk/web.md;server-sdk/ 与 console-sdk/ 各 nodejs.md / java.md / python.md / go.md)+ examples/ 4(javascript.md、java.md、python.md、go.md)。 - 功能点清单与
sdks/AGENTS.md「首版待产出集」一致,无裁剪;SDK 轴按语言一文件(原 index.md 结构取消,规则同步修订于 sdks/AGENTS.md / README.md),语言间同构的功能面导航以各轴 nodejs.md 为 canonical、其他语言页链接之并只写语言差异;examples/ 覆盖当前支持的全部四个语言面,其中 python、go 的安装坐标与调用写法按 skills/ob-agentbase/references/server-sdks 同源书写(v2.7.0 发布面,见证据缺口)。 - 逐语言状态:zh-CN 全量;en-US / ja-JP 未产出(骨架态),事实源为中文同名文件。
证据缺口
- Release
v2.6.0 页面需登录,未能在线核对附件清单与 npm 双面 dist-tag;Java 附件名与 GAV 依据 agentbase-sdks tests/sdk-regression 与主仓 sdks/README.md 口径书写。 - Python 15.4.0 Knowledge Bases surface 为
skills/ob-agentbase/references/release-2.6.0.md 声明,本环境无可安装产物可验。 - python.md / go.md 以 skills 参考页(v2.7.0 发布面)为 canonical:2.6.0 Release 无 Python 可安装产物、无 Go 交付,两页页首已显式标注坐标版本,未伪造 2.6.0 制品事实。
- skills 侧注记:
skills/ob-agentbase 现钉 2.7.0(框架前迁移内容);其 references/release-2.6.0.md 作为本迭代 canonical 历史差异页使用,本迭代不回写 skills(历史只增不改)。