2.7.0 SDK 侧迭代增量
| 版本 | 2.7.0 |
|---|---|
| 源 tag / 仓库 | v2.7.0 @ git@code.alipay.com:obai/appbase.git(peeled commit 7a557ac5affe318bcc00bd57496fea8d49ccb65c) |
| 本迭代源 commit | 34b7c8633813a8fe75cc58e8348bd4a9efdd0e21(release-2.7.0 分支尖端) |
| 上一迭代源 commit | 8c9beb4713496d051a477f03fd843365145d3b86(tag v2.6.0) |
| SDK 管线 tag | agentbase-sdks 远端可解析 tag / release 终态为 v2.7.0(https://code.alipay.com/obai/agentbase-sdks/releases/v2.7.0,六 ZIP + 外层 SHA256SUMS,经 antcode CLI 实查);release-2.7.0 分支经三次 SDK cut,npm 三面 latest=2.7.2(registry dist-tags release-2.7.1 / release-2.7.2 实查存在),但 v2.7.1 / v2.7.2 的 tag 与 release 均未推送(远端无 tag、.release-state/ 无 2.7.2 条目),Java / Python / Go ZIP 制品因此钉 v2.7.0 |
| 生成日期 | 2026-09-18 |
服务版本线在 release-2.7.0 分支上经 APP_VERSION_STABLE 2.7.0 → 2.7.1 → 2.7.2(后两次为 SDK release cut bump),Migration V54。Server spec open-api3-latest-server.json paths 496 → 551(+55 / -0)。
交付坐标(本迭代实际发布面)
| 语言面 | 形态 | 精确坐标 |
|---|---|---|
| JavaScript — web | npm(远程 registry) | agentbase-web-sdk@2.7.2(2.7.0 起由 appbase-web-sdk 改名,版本体系统一到服务版本号;registry 已核 latest=2.7.2) |
| JavaScript — node | npm(远程 registry) | agentbase-node-sdk@2.7.2(由 appbase-node-sdk 改名) |
| JavaScript — console | npm(远程 registry) | agentbase-console-sdk@2.7.2(由 appbase-console-sdk 改名) |
| Java — server / console | Release ZIP 附件 + SHA256SUMS(双层 sha256sum -c) | io.agentbase:agentbase-java-sdk:2.7.0 / io.agentbase.console:agentbase-console-java-sdk:2.7.0(release 终态 v2.7.0)(Java 11 source/target 不变) |
| Python — server / console | Release ZIP 附件(wheel + sdist + 内层 SHA256SUMS,离线 pip 安装) | agentbase-python-sdk 2.7.0 / agentbase-console-python-sdk 2.7.0(release 终态 v2.7.0)(2.7.0 起首次有可安装制品,2.6.0 缺口关闭) |
| Go — server / console | Release ZIP 附件(模块源码树 + 内层 SHA256SUMS,replace 消费) | module agentbase-go-sdk / agentbase-console-go-sdk(2.7.0 起首次交付,要求 go 1.22.5+,零第三方依赖) |
契约与能力增量
JS 包改名与版本统一:
appbase-*-sdk→agentbase-*-sdk,三包版本统一到 2.7.x(2.6 线旧包名停在22.8.0/22.4.0/1.16.0,不混用)。Agent Runtime(项目级):Server spec 新增 29 个
/agent-runtime/端点(AgentVersion config/gateway/models/readiness/skills、Run 创建/取消/事件/消息/模型调用/工具消息、Thread 与 context-compactions、Agent evaluations);Web / Node / Python / Go / Java 均新增AgentRuntimeservice(2.6 时五个 SDK 无该 service,仅 Console 消费)。Knowledge Wiki 与 GraphRAG:新增 26 个知识库端点——Wiki 页面/版本/恢复、提案接受、冲突解决、推荐上限、重置、export-to-memory;GraphRAG 图浏览(graph/entities/community-reports);索引治理(index-capabilities 含 clear、index-operations 含 cancel)。摄取侧新增 Excel 工作表解析与图片增强、嵌入输入限制、索引输出语言配置。
Custom OAuth2:内置 Gitee 提供商接入;Console 登录测试支持自定义 Scope 且 Scope 隔离强化。
AI Gateway:凭据治理、工具审批与托管模板(credential governance / tool approvals / managed templates)。
Observability:Agent 轨迹评估完成(数据集评估支持 Agent 目标)、监控面板与 Function 指标;OpenCode 摄取修复(丢事件、轨迹身份、消息角色归一化)。
Memory:有界 session context 推断。
TablesDB / JsonTable:JsonTable 索引字段必填约束放宽(required-only 更新直达适配层,混合放宽被拒);Schema 回滚期间保持 collection 一致性。
组织治理与用量:组织用量聚合过滤删除态项目、消除 legacy N+1;团队 owner membership 用户标识 404 修复。
回归:
tests/sdk-regression在release-2.7.0分支尖端(2.7.2 cut,34b7c863…)覆盖 console-web / nodejs / java / python / go 五族(2.6.0 无 python / go 族)。
sdks/ 文档自身增删改
integration.md重写:两条接入路径改为「npm 三包(新包名 @2.7.2)+ 非 npm 六 ZIP(Java/Python/Go × Server/Console,钉 v2.7.0 release 终态)」;新增改名说明、双钉值说明与六 ZIP 制品表;删除 2.6.0 的 Python/Go 无交付缺口说明。全树坐标上刷:
appbase-*-sdk@22.x/1.16.0→agentbase-*-sdk@2.7.2(npm 三包),Release URL 统一指向 v2.7.0 release(终态),Java GAV2.6.0→2.7.0;examples/python.md/examples/go.md安装块补齐 Console 侧 ZIP(原仅 Server 侧,Console wheel / module 无 canonical 下载命令),事实源小节同步到 appbasev2.7.0/ agentbase-sdksv2.7.0(ZIP)与 npm2.7.2(JS)。功能点更新:
agent-runtime.md重写为项目级 API + 各语言 SDK service;新增knowledge-base/wiki.md(Wiki / GraphRAG / 索引治理);knowledge-base/overview.md、documents.md补摄取增强与索引配置;account/authentication.md补 Gitee 与自定义 Scope;observability/、models-ai-gateway/ai-gateway.md、databases/overview.md、memory/、usage.md按本迭代行为变化增补;examples/javascript.md增补 Agent Runtime 与 Knowledge Wiki 示例。逐语言状态:zh-CN 全量上刷;en-US / ja-JP 未产出(骨架态),事实源为中文同名文件。
证据缺口
agentbase-sdks Release 面经 antcode CLI 实查:仅
v2.6.0/v2.7.0两条 release(后者七附件:六 ZIP + 外层SHA256SUMS);.release-state/仅2.6.0.env/2.7.0.env/2.7.1.build.json/2.7.1.env,无 2.7.2 条目,v2.7.1/v2.7.2tag 未推送——故 ZIP 坐标不钉 2.7.x 补丁线。npm 三面 latest=2.7.2 已经 registry 实查(npm view)。tests/sdk-regression的运行结果未在线核对(无 CI 读权限),族覆盖以仓内目录结构为准。