2.8.0 SDK 侧迭代增量
| 版本 | 2.8.0 |
|---|---|
| 源 tag / 仓库 | v2.8.0 @ git@code.alipay.com:obai/appbase.git(peeled commit ea835e462085decbbf49ab7fd6a0e99928be72a9,tag 即 release-2.8.0 尖端) |
| 本迭代源 commit | ea835e462085decbbf49ab7fd6a0e99928be72a9 |
| 上一迭代源 commit | 34b7c8633813a8fe75cc58e8348bd4a9efdd0e21(release-2.7.0 分支尖端) |
| SDK 管线 tag | agentbase-sdks 远端可解析 tag / release 终态为 v2.8.0(peeled bee2b1e9000f821917022023b59b649056c15bad;release id 906「Agentbase SDK 2.8.0」,2026-09-19T15:47:34Z 发布,经 antcode CLI 实查——六 ZIP + SHA256SUMS + build.json + delivery.json 九附件);npm 六坐标 2.8.0(delivery.json 实查:public 三包 + 内部 @alipay/ 三包,全部 2.8.0,npm_selected=2.8.0,provenance policy bound) |
| 生成日期 | 2026-09-20 |
服务版本单次 bump 2.7.2 → 2.8.0(无 2.7.x 中间 cut),Migration V54 → V55。Server spec open-api3-latest-server.json paths 762 → 783(+21 / -0,agentbase-sdks v2.7.0 与 v2.8.0 双 tag 对比实测)。
交付坐标(本迭代实际发布面)
| 语言面 | 形态 | 精确坐标 |
|---|---|---|
| JavaScript — web | npm(远程 registry,public + internal 双面) | agentbase-web-sdk@2.8.0(内部 @alipay/agentbase-web-sdk@2.8.0) |
| JavaScript — node | npm(同上) | agentbase-node-sdk@2.8.0(内部 @alipay/agentbase-node-sdk@2.8.0) |
| JavaScript — console | npm(同上) | agentbase-console-sdk@2.8.0(内部 @alipay/agentbase-console-sdk@2.8.0) |
| Java — server / console | Release ZIP 附件 + SHA256SUMS(双层 sha256sum -c) | io.agentbase:agentbase-java-sdk:2.8.0 / io.agentbase.console:agentbase-console-java-sdk:2.8.0(release 终态 v2.8.0)(Java 11 source/target 不变) |
| Python — server / console | Release ZIP 附件(wheel + sdist + 内层 SHA256SUMS,离线 pip 安装) | agentbase-python-sdk 2.8.0 / agentbase-console-python-sdk 2.8.0(release 终态 v2.8.0) |
| Go — server / console | Release ZIP 附件(模块源码树 + 内层 SHA256SUMS,replace 消费) | module agentbase-go-sdk / agentbase-console-go-sdk(go 1.22.5+,零第三方依赖) |
本迭代起生成 SDK 完全由 agentbase-sdks 仓承载(appbase monorepo 内生成树已删除,PR 640);build.json 实查 source_tag=v2.8.0、source_commit=ea835e46…(与 appbase tag 同 commit)、四族 families=npm/java/python/go 全部 built。
契约与能力增量
知识库版本管理(Server spec +17 端点,Node/Java/Python/Go Server SDK 新增版本方法面):
listVersions/createVersion(工作副本:sourceVersionId+expectedSourceVersionRevision+expectedBindingRevision+ label/description/retryOf,返回KnowledgeBaseWorkingCopyOperation)/getVersion/deleteVersion(不可逆异步删除,返回KnowledgeBaseVersionDeleteOperation)/publishVersion/getVersionReadiness/rollbackVersion/sealVersion;采纳与操作查询:listVersionAdoptions/createVersionAdoption/cancelVersionAdoption/getVersionAdoption、listWorkingCopyOperations/getWorkingCopyOperation/cancelWorkingCopyOperation/getVersionDeleteOperation。批量删除文档:deleteDocuments({knowledgeBaseId, documentIds, versionId?})(DELETE /knowledgebases/{knowledgeBaseId}/documents,单批最多 50,成功 204,按序删除、失败仅重试仍存在者)。Observability 评估:
discoverEvalMcpTools(gatewayId, gatewayKeyId)(POST /observability/evals/mcp/tools,发现评估可用的只读 MCP 工具;scopeobservability.evals.write);评估技能(Evaluation Skills)管理、评估范围圈定(按类型与名称规则)、多评估器任务与 ATIF 轨迹持久化。AI Gateway:
testToolConnection(POST /ai-gateway/tool-connections/{id}/test,连通性测试与诊断);逻辑模型挂载listLogicalModelMounts/replaceLogicalModelMounts(GET|PUT /ai-gateway/resources/logical-models/{id}/mounts,替换为全量语义);模型路由提升为项目级作用域;提供者头配置(customHeaders/forwardHeaderAllowlist,V55落库);护栏回滚与私有端点。存储:桶
clientFileListing参数(创建/更新;默认 true;false 时仅授权管理客户端可列文件,上传与公开文件链接访问不变)。JsonTable / SQL Proxy:required 预检保持、整表原子性、复合索引成员属性过滤独立 JOIN、大整数跨端精度、JSON null 不进全文物化、nullable/unsigned 契约保留。
PowerContext(Console 面):托管上下文配置与就绪探测(项目侧栏入口随部署开关灰度,无新 Server SDK service)。
计量:metering rollups 性能与运行韧性优化、队列重试上限、失败任务存储加固。
sdks/ 文档自身增删改
全树坐标上刷:npm 三包
@2.7.2→@2.8.0;Release URL 与 ZIP 文件名v2.7.0/2.7.0→v2.8.0/2.8.0;Java GAV / Python 包版本 →2.8.0;integration.md版本事实表与双路径钉值改写(npm 发布面 2.8.0 / ZIP release 终态 v2.8.0,服务 2.8.0、MigrationV55)。功能点更新:新增
knowledge-base/versions.md(版本管理方法面 + 各语言调用页签);knowledge-base/documents.md新增「批量删除文档(2.8.0)」小节;observability/overview.md新增 2.8.0 评估 MCP 工具发现小节;models-ai-gateway/ai-gateway.md补工具连接连通性测试与逻辑模型挂载。逐语言状态:zh-CN 上刷;en-US / ja-JP 未产出(骨架态),事实源为中文同名文件。
证据缺口
Release 六 ZIP 坐标、SHA256 摘要与 npm 六坐标 integrity 均取自 release 附件
SHA256SUMS/build.json/delivery.json(antcode CLI 实查下载);未另行对本机做制品下载后的逐字节复核(生成流程以发布报告为事实源)。tests/sdk-regression运行结果未在线核对(无 CI 读权限),族覆盖以仓内目录结构与 build.json families 字段为准。npm registry
latestdist-tag 未做npm view实查(delivery.json的npm_selected=2.8.0与registry: public/internal字段为坐标依据)。