2.9.0 SDK 侧迭代增量
| 版本 | 2.9.0 |
|---|---|
| 源 tag / 仓库 | v2.9.0 @ git@code.alipay.com:obai/appbase.git(peeled commit ebae954094883b847bf582cfbe9fbe58ae0a7499,tag 即 release-2.9.0 尖端) |
| 本迭代源 commit | ebae954094883b847bf582cfbe9fbe58ae0a7499 |
| 上一迭代源 commit | ea835e462085decbbf49ab7fd6a0e99928be72a9(v2.8.0 tag) |
| SDK 管线 tag | agentbase-sdks 远端可解析 tag / release 终态为 v2.9.0(peeled 58840fd6446526e832a050717419dc60522defc1;release id 1300「Agentbase SDK 2.9.0」,经 antcode CLI 实查——六 ZIP + SHA256SUMS + build.json + delivery.json 九附件);npm 六坐标 2.9.0(delivery.json 实查:public 三包 + 内部 @alipay/ 三包,全部 2.9.0,npm_selected=2.9.0);build.json source_commit 与 appbase tag peeled commit 一致 |
| 生成日期 | 2026-10-12 |
服务版本单次 bump 2.8.0 → 2.9.0(无 2.8.x 中间 cut),Migration V55 → V56。Server spec open-api3-latest-server.json paths 567 → 575(+8 / -0);Console spec 690 → 702(+12 / -0)(agentbase-sdks v2.8.0 与 v2.9.0 双 tag 对比实测)。
交付坐标(本迭代实际发布面)
| 语言面 | 形态 | 精确坐标 |
|---|---|---|
| JavaScript — web | npm(远程 registry,public + internal 双面) | agentbase-web-sdk@2.9.0(内部 @alipay/agentbase-web-sdk@2.9.0) |
| JavaScript — node | npm(同上) | agentbase-node-sdk@2.9.0(内部 @alipay/agentbase-node-sdk@2.9.0) |
| JavaScript — console | npm(同上) | agentbase-console-sdk@2.9.0(内部 @alipay/agentbase-console-sdk@2.9.0) |
| Java — server / console | Release ZIP 附件 + SHA256SUMS(双层 sha256sum -c) | io.agentbase:agentbase-java-sdk:2.9.0 / io.agentbase.console:agentbase-console-java-sdk:2.9.0(release 终态 v2.9.0)(Java 11 source/target 不变) |
| Python — server / console | Release ZIP 附件(wheel + sdist + 内层 SHA256SUMS,离线 pip 安装) | agentbase-python-sdk 2.9.0 / agentbase-console-python-sdk 2.9.0(release 终态 v2.9.0) |
| Go — server / console | Release ZIP 附件(模块源码树 + 内层 SHA256SUMS,replace 消费) | module agentbase-go-sdk / agentbase-console-go-sdk(go 1.22.5+,零第三方依赖) |
契约与能力增量
Functions 执行路径(Server spec +2 端点,Server SDK 新增方法):
listExecutionPaths({ functionId })(GET /v1/functions/{functionId}/execution-paths,去重请求路径分页,字符串升序,返回executionPathList)、listExecutionsByPath({ functionId, path, queries? })(GET /v1/functions/{functionId}/execution-paths/executions,完整路径精确匹配 ≤2048 字符);scopeexecution.read。Web SDK 客户端面被服务端拦截(403general_resource_blocked,按X-AppBase-SDK/X-SDK-Name=web/X-SDK-Platform=client请求头识别)。LLM Gateway 厂商预置目录:
listProviderPresets()(GET /v1/llm-gateway/provider-presets,返回llmGatewayProviderPresetList);providerType扩至 24 个厂商预设类型(新增volcengine、openai-official、anthropic-official等);Provider 契约 +modelMetadata(按模型参数),Model +metadata;预设目录内置 24 厂商 / 313 模型(app/config/llm_gateway_provider_presets.php)。审核二期(Server spec 端点数不变,模型扩展):
moderationConfig+requireManualReviewOnViolation;createConfig/updateConfigmode扩为pre | post | hybrid(post / hybrid 需平台 Admin 开关moderation.phase2.enabled,未开启等同pre);document模型 +moderationStatus(checking / pending / published / quarantined / private_hold / action_error)+moderationJobId+contentVersion;未发布文档读路径对非创建者隐藏、列表total修正;事件发布后按写入类型补发。Observability:
listObservations({ limit?, offset?, from?, to?, type?, name?, level?, traceId?, environment? })(GET /v1/observability/observations,limit1–100,offset 为 limit 整数倍,返回observabilityObservationList);getScoreAnalysis/getScoreQualityDetails/listScoreAnalysisSummaries/triggerScoreAnalyses(单批 ≤100 评分);GET /observability/scores+scoreId查询参数;Metrics 查询 +memoryOnly。评估模板标签 / 版本、RCA 设置(GET|PUT /v1/observability/evals/root-cause-analysis-settings)与执行 retry(POST /v1/observability/evals/jobs/{jobId}/executions/{executionId}/retry)落在 Console API(Console spec),Node Server SDK 本迭代未为后两者提供方法。知识库:KB
create+embeddingDimension(1–65535,探测校验)+tracingEnabled;createSearch/createMultiSearch+answer(答案合成:最多 12 行证据、≤1024 tokens,knowledgeBaseSearchResultList+answer)。Console SDK(console-web / console 各语言包):新增 Observability 服务面(评估模板 CRUD、RCA 设置)与 Functions 执行路径方法,随 2.9.0 发布面同步。
sdks/ 文档自身增删改
全树坐标上刷:npm 三包
@2.8.0→@2.9.0;Release URL 与 ZIP 文件名v2.8.0/2.8.0→v2.9.0/2.9.0;Java GAV / Python 包版本 →2.9.0;integration.md版本事实表与双路径钉值改写(npm 发布面 2.9.0 / ZIP release 终态 v2.9.0,服务 2.9.0、MigrationV56)。功能点更新:
functions.md新增「执行路径查询(2.9.0)」调用卡与 Web SDK 拦截边界;models-ai-gateway/llm-gateway.md补listProviderPresets与厂商预设类型;moderation.md补 mode / requireManualReviewOnViolation;observability/overview.md新增「2.9.0 增量」小节;knowledge-base/overview.md补 embeddingDimension / tracingEnabled / answer。逐语言状态:zh-CN 上刷;en-US / ja-JP 未产出(骨架态),事实源为中文同名文件。
交付核验
2026-10-12 下载并核验 Release 的六个 ZIP 与
SHA256SUMS,逐个校验大小与 SHA-256;build.json、delivery.json及 SDK revision 均绑定 appbasev2.9.0的完整源 commit。npm public / internal 六个
2.9.0包均实查 registry 元数据并下载 tarball,校验 integrity、包名与版本、制品内构建来源;发布坐标和源 commit 一致。构建、制品同步与发布流程成功完成,覆盖 npm、Java、Python、Go。
tests/sdk-regression的在线 API 集成结果尚未核验;制品核验不代表该项测试通过。