2.10.0 迭代增量与版本记录
| 版本 | 2.10.0 |
|---|---|
| 源 tag / 仓库 | v2.10.0(peeled commit 0a5d23f9349028496286572fd43117aa6f8fce0a)@ git@code.alipay.com:obai/appbase.git |
| 本迭代源 commit | 0a5d23f9349028496286572fd43117aa6f8fce0a(tag 即 release-2.10.0 尖端) |
| 上一迭代源 commit | ebae954094883b847bf582cfbe9fbe58ae0a7499(v2.9.0 tag) |
| 文档基线 commit | 19f1f3a9c6418d97890038fbe5e55218d090b697(迭代分支 v2.10.0 自 origin/master 冻结;分支此前已含维护提交 eba5aa0…72f24de,续做按 merge-base 语义沿用本 SHA) |
| 生成日期 | 2026-10-19 |
| 服务版本 / Migration | APP_VERSION_STABLE 单次 bump 2.9.0 → 2.10.0(app/init/constants.php:55 实读);Migration V57(边界迁移:不新增 schema/data 动作,platform projects collection 增两个只读状态字段与内部 readOnlyRevision,经 platform-migrate Expand 对账补齐;升级迁移基线 1.9.0 不变) |
| SDK 发布面 | agentbase-sdks v2.10.0 release 已发布(2026-10-19T03:03:11Z,revision 394f2a53dacfc2494f1f3e71082d9f09b9734ff1):npm 六坐标 2.10.0(public agentbase-web-sdk / agentbase-node-sdk / agentbase-console-sdk + 内部 @alipay/*,delivery.json npm_provenance_policy: bound)+ Java / Python / Go 与 Console 共 6 个 ZIP 制品 + SHA256SUMS / build.json(source_commit: 0a5d23f9… 与本迭代源 tag 一致)/ delivery.json |
范围说明:本页合并登记本迭代的非 Memory 更新与 PR14 的 Memory 专项修订。两部分分别保留其固定服务快照、文档开工基线、SDK 验证版本及截图环境;非 Memory 记录见下文,Memory 专项记录见本页后半部分。文档合并目标为
v2.10.0@a4bcbf2ec099b5e60c9d497ccff4f3230cddf3ac。
新增能力
知识索引质量评估(GraphRAG / RAPTOR / LLM Wiki 独立索引产物评估)(影响面:Console / Server API / SDK):在 2.9.0「知识库解析评估」任务类型上扩展出独立的知识索引质量评估——对 GraphRAG(实体描述忠实度、关系支持度、社区报告忠实度与覆盖)、RAPTOR(摘要忠实度、关键内容覆盖、层级一致性)、LLM Wiki(页面忠实度、引用支持、来源覆盖、跨页一致性)三类索引产物分别做模型评估 + 规则检查(来源引用、实体身份、关系端点、页面修订、内部链接),按适用维度等权聚合成 0–1 的能力级质量分(三类不合成总分)。创建任务按能力勾选并可配置抽样(默认每类 30 条,按记录类型 / 树层级 / 页面类型分层、绑定冻结结果确定性选择;关闭抽样则全量评估),创建前
index-preview预览各类预计评估记录数。评分发布前引入独立模型复核(复核不通过进待复核区、不参与聚合;协议异常不降级为通过);评分明细下钻新增kind=index(GET /v1/observability/scores/{scoreId}/quality-details?kind=index);构建 Trace 关联评分详情,根因分析与配置建议只引用已声明且历史值已知的配置字段。新端点:POST /v1/observability/evals/index-preview、POST /v1/observability/evals/index(Server SDK:previewIndexEvaluation/createIndexEvaluation)。内置模板目录新增 GraphRAG / LLM Wiki / RAPTOR Index Quality 三个 Built-in 模板。Observability Reports 报表(影响面:Console):项目级只读聚合看板,固定时间窗(近 24 小时 / 7 天 / 30 天,全页按窗口重聚合),三个页签——Overview(九张 KPI 卡:Traces、活跃用户、Tokens、成本估算、P95 延迟、错误率、综合质量分、评测覆盖率、单会话成本,均带环比;流量趋势、延迟与质量双轴趋势、Token 浪费分解、Top Agents / Models、质量五档分档、诊断结论)、Agents(按 Agent 的调用 / P95 / 平均分排行与状态徽标、ROI 三档、评估器覆盖、步骤与模型成本明细、Top 用户 / 会话 / 最近 Trace)、Quality(质量分 KPI、评估器趋势、分档分布、Bad Case 归因、低分 Trace 列表、评估器覆盖率)。成本为估算值(以平台账单为准);Token 浪费 / 缓存命中 / Bad Case 归因依赖写入侧在 Observation metadata 显式打标(
wasteReason、badCaseCategory、cache.status),未打标数据不进入对应分解面板。页面与路由保留,侧栏报表入口当前隐藏,经直接链接访问。评估 Prompt 解析端点(影响面:Server API / SDK):
GET /v1/observability/prompts/resolve——按名称 + label(默认production)或精确版本号解析评估 Prompt(label 与 version 互斥),供评估执行链路做确定性的 Prompt 取用(Server SDK:Observability.resolvePrompt)。Console Prompts 页同步新增 Prompt 使用说明与 Usage 入口。项目数据库与文件存储独立只读(read-only)(影响面:Console 管理 / Server API(平台管理域)/ 全执行面):项目新增
databaseReadOnly与storageReadOnly两个独立状态(Platformprojectscollection 新增字段,V57对账补齐);开启期间对应域的写入被拒绝(错误project_database_read_only/project_storage_read_only,切换排空超时 503),读取、文件预览与 token 读取不受影响;指定单文档 / 单行 / 单文件的立即删除是清理例外,批量删除、SQLDELETE、整库 / 表 / 桶删除仍按所属域拒绝。切换前先关闭新写准入并排空既有写租约(HTTP / Worker / Indexer / SQL Proxy 写栅栏),提交后 503 需按内部 Admin 直读状态确认阶段。管理入口:Admin Panel Project Read-only 标签(AdminGET/PATCH /v1/projects/{projectId}/read-only,PATCH 携带expectedDatabase/expectedStorage期望值防并发,状态已变化返回 409);普通项目身份无权切换。本项目定位为平台治理能力,手册按「只读期间的行为边界」在限额页登记。Functions:Java 17 预构建 JAR 部署 + 平台默认执行规格(影响面:Console / Server API / SDK):部署新增
artifactMode(source/java-jar)——java-jar模式直接上传预构建 JAR(entrypoint 固定Index.java语义),JAR 大小上限独立配置(_APP_FUNCTIONS_JAR_SIZE_LIMIT,默认 100 MB),与源码模式(_APP_COMPUTE_SIZE_LIMIT/ 计划deploymentSize)分开计量;GET /v1/functions/specifications响应新增defaultRuntimeSpecification(平台管理员配置的新函数默认规格 slug,对当前计划与算力不可用时为 null)。执行路径查询(2.9.0)新增path/pathMatch(exact/regex)/method过滤(GET .../execution-paths与.../execution-paths/executions)。知识库文档标签过滤与子产品定位(documentTag / subProductId)(影响面:Console / Server API / SDK):在 2.9.0 文档层级标签之上,标签升级为检索与列表的过滤维度——
{subProductId}_{sectionCode}_{fileKey}组合格式的documentTag精确匹配,subProductId成为独立写入字段与召回过滤;单库检索、跨库检索、文档列表、Graph / Wiki 冲突列表等读路径支持按标签 / 子产品过滤(Server SDKcreateSearch/createMultiSearch/listDocuments等签名新增documentTag/subProductId可选参数)。跨库检索新增metadataFilter/offset参数。Agent Runtime 项目 API Key 接入(影响面:Server API / SDK):项目级 Agent Runtime 面开放项目 API Key 认证(此前仅用户身份)——Key 需
ROLE_APPS、类型 standard / dynamic、项目匹配且未过期;调用身份按「显式用户身份」规则归一(userId语义不变)。Console 项目工作台兼容面不变。PowerContext 托管压缩(compaction)端点(影响面:Server API):
POST /v1/projects/{projectId}/powercontext/compaction——对托管上下文做显式 preview / commit 的记忆压缩(scopeprojects.write;请求体 ≤16 KiB,透传托管服务校验版本与策略)。Admin 公开文档发布管线(影响面:平台管理域):Admin 新增文档 ZIP 上传 / 版本发布 / 预览端点与后台任务(
/v1/admin/public-docs/**、/_internal/...),支撑产品文档站点从冻结主树发布版本化手册;属平台内部治理面,无用户 Console 入口,本手册不设页。
行为变化
Memory 经验与技能二次确认、Pipeline 管理面、图片 / PDF 写入:本迭代合入的 Memory 能力(自进化二次确认
evolution.requireConfirmation、四类 Pipeline 的草稿 / 验证 / 发布 / 回滚管理 API、Storage 图片与 PDF 解析写入与图片辅助查询)由 PR #14(Memory 专项)承载其手册、SDK 与 API 文档,本页不重复登记;能力清单以该 PR 的products/changelogs/2.10.0.md为准。知识索引链路加固(影响面:Console / 部署):GraphRAG 索引链路优化与知识索引进度 / 中断体验(Indexes 页操作进度、可取消的中断处理);Redis 写栅栏韧性增强(协程竞争与事务嵌套修复);Trace 重复生产与 ATIF 去重、额度锁竞争修复;OTel Prometheus 写入量下降。
评估与报表修正(影响面:Console):评估分数展示统一两位小数;评估任务观测范围过滤序列化修复;模型根因分析协议修复、证据边界收紧、超时延长至 300 秒并保留具体模型意见;报表查询的 project / 时间过滤下推到去重子查询(性能)。
AgentOps 命名统一(影响面:Console):Observability 服务声明与标签统一更名为 AgentOps(侧栏分区显示名;路由不变,
/observability前缀维持)。Console 性能与体验(影响面:Console):页面冗余请求削减并保留业务状态刷新;批量数据库查询优化;批量写入合并文档缓存失效(单次集合代际轮换)。
兼容性上传头(影响面:Server API):兼容
x-appbase/x-agentbase上传头与项目请求头;修复单分片上传PartNumber=-1越界。
配置与部署
项目元数据库迁移进入
V57:不新增 schema / data 动作;platformprojectscollection 的两个只读状态字段与内部readOnlyRevision由 platform-migrate 的 Expand 对账补齐(旧项目缺字段按false/0解释)。从 2.9.0 升级不重跑旧版本迁移,V56已发布内容不回写。Memory 侧部署变化(schema
009_memory_knowledge_reviews.sql、MEMORY_SCHEMA_REQUIRED_VERSION=009等)由 PR #14 的记录承载。Functions:新增
_APP_FUNCTIONS_JAR_SIZE_LIMIT(默认 100 MB);functions.defaultRuntimeSpecification平台配置项(Admin 动态配置,经计划与算力校验后生效);新增 0.5C/1G 双规格热池。知识索引:操作控制支持字段与 Helm 映射以知识索引 Worker 配置矩阵为准;新增知识索引模型请求超时配置。
Helm:支持外部 Secret、监控趋势统计完善、API HPA 支持;监控新增 Grafana 多环境同步与业务 API 面板(Message / SLS 原生日志检索)。
废弃与迁移
V56已发布不回写;升级到 2.10.0 的项目元数据库变化由V57承接(本迭代 server spec 以 agentbase-sdksv2.10.0specs/open-api3-latest-server.json为准:590 路径,较 2.9.0 新增 15 路径、无删除——Memory pipelines 12 + knowledge reviews 5 操作 + observability index 评估 2 + prompts/resolve 1)。报表(Reports)侧栏入口隐藏:页面与路由保留,经直接链接访问;后续迭代再评估入口恢复。
评估模板「知识库解析评估」之外新增「知识索引质量」内置模板;2.9.0 引入的解析 / 分块评分口径(
knowledgeBaseQuality)与索引质量(knowledgeIndexQuality)为两个独立 Score 维度,互不合并。
已知问题
Reports 的 Token 浪费 / 缓存 / Bad Case 归因面板在写入侧未打标时显示为空——空面板表示覆盖尚未建立,不是「未分类浪费」;历史数据不回填。
知识索引质量评估的独立模型复核仍是模型判断,不能替代人工复核;复核不通过的记录进入待复核区,不生成数值质量分。
手册侧(本迭代 products/ 变化)
功能点增删:无新增 / 删除文档;全部为既有页增补(功能点骨架基线表 22 功能点不变)。
正文上刷(zh-CN,本提交范围——Memory 相关 9 页由 PR #14 承载,本提交不触碰):
observability/overview.md:分区名更新为 AgentOps 口径;页面结构表补 Reports 报表行(入口隐藏、三页签)与知识索引质量模板行;新增评估模板目录实拍图(内置 Index Quality 模板与默认 / 视觉评估模型配置卡)。observability/evaluations.md:任务类型补知识索引质量(GraphRAG / RAPTOR / LLM Wiki 三类产物、抽样配置、独立模型复核、kind=index明细下钻、构建 Trace 关联与配置建议证据边界);评估 Prompt 解析端点与 Prompt Usage 入口。observability/metrics.md:补指标页实拍图与「指标由轨迹派生、不另行采集」的口径;保留 memoryOnly 过滤说明。overview/limits.md:补项目只读(databaseReadOnly / storageReadOnly)状态说明——开启期间的写入拒绝语义、读不受影响、恢复由平台管理员操作、错误码project_database_read_only/project_storage_read_only与 503 排空语义。functions.md:部署补artifactMode(Java 17 预构建 JAR 直接部署、独立大小上限)与平台默认执行规格说明;执行路径查询补path/pathMatch/method过滤参数。knowledge-base/overview.md/documents.md:文档标签升级为检索与列表过滤维度(documentTag 格式、subProductId 独立字段、跨库检索 metadataFilter / offset)。routes.md:Observability 行补 reports 路由(/observability/reports/{overview|agents|quality},入口隐藏);/v1/health/version示例版本值刷新为 2.10.0。
逐语言状态:zh-CN 上刷完成(本提交 + PR #14 合并后为全量);en-US、ja-JP 未产出(骨架态),事实源为中文同名文件。
截图台账:沿用 2.9.0 实拍 32 张(页面结构未变的图不重拍;PR #14 另补 Memory 域 15 张并移除 1 张旧概览图)。本迭代 2026-10-19 SIT(部署版本实测 2.10.0,
/v1/account/sessions响应version: 2.10.0)新增实拍 2 张(1440×900,单图 ≤300KB,逐张经捕获时 DOM 文本断言确认主区域为预期内容、无错误页、无凭据字面值):observability/fig-6-evals-index-templates.png(评估模板目录:GraphRAG / LLM Wiki / RAPTOR Index Quality 三个内置模板与默认 / 视觉评估模型配置卡)、observability/fig-7-metrics.png(Metrics 指标分析页真实数据态:轨迹派生延迟 / 用量 / 成本 / 评分面板)。核验缺口:Reports 报表三页签在 SIT 直达 URL 渲染为空白页(body 空、无错误横幅、无网络失败记录),与「侧栏入口隐藏」的灰度状态一致,本迭代不拍摄,正文只写源码可证的页签结构与打标口径,补拍待入口开放;知识索引质量评估的有数据结果页(抽样预览、
kind=index逐记录明细、待复核区)需真实索引构建 + 评估任务跑完后补拍,本迭代只拍内置模板目录;项目只读无 Console 用户入口(Admin Panel 域),不拍摄;Prompt resolve 为纯 API 面,无 Console 专属画面(Prompts 列表页在 SIT 为真实空态,未重复入库)。
与相邻 changelog 的分工
Memory 专项(手册 9 页 + SDK/API Memory 契约 + skill)→ PR #14(
docs/update-memory-2.10.0→v2.10.0)及其登记的三个changelogs/2.10.0.md。SDK 侧交付坐标(npm 六坐标 / ZIP 制品 / 校验形态)→
sdks/changelogs/2.10.0.md(PR #14 登记 Memory 部分;版本钉事实见 sdks/zh-CN/integration.md)。API 面增量 →
apis/changelogs/2.10.0.md(同上分工);本页「新增能力 / 行为变化」各条已标注影响面,不重复展开端点细节。
Memory 专项文档增量与版本记录
| 项目 | 事实 |
|---|---|
| 版本 | 2.10.0 |
| 范围 | 本节仅登记 Memory 及直接相关接入文档。 |
| 生成日期 | 2026-10-16 |
| 服务事实来源分支 | release-2.10.0(固定快照,后续分支移动不改变本记录) |
| 本迭代源 commit | 611a92b4853f3eea6c3ae83d2a0ec3b0480bd582(最终正文契约核对、定向单元测试及测试机部署共同使用) |
| 上一迭代源 commit | ebae954094883b847bf582cfbe9fbe58ae0a7499(上一版已登记的 v2.9.0,未用后查分支尖端替代) |
| 文档基线 commit | bbc80703db6f868846a3121c0938bbc4b4cd3bb7(开始任务时冻结的 origin/master;本任务目标按用户要求为 v2.10.0) |
本页是维护版本记录,不随产品语言树或客户 PDF 交付。初稿曾参考辅助快照 bcd0c8739c102cc1cd1448648eff2d96d4a15b26;交付前完整复核、定向单元测试及截图部署固定为上述本迭代源 commit。PR 最初目标冻结为 v2.10.0@19f1f3a9c6418d97890038fbe5e55218d090b697;2026-10-19 同步 PR15 合入后的目标 v2.10.0@72f24de57a0c44c5fbe408f1e1b5002cdff6119d,保留其规范、观测接入及材料索引修订。随后同步非 Memory 2.10.0 更新后的目标 a4bcbf2ec099b5e60c9d497ccff4f3230cddf3ac;整本手册版本随该基线上刷为 2.10.0,Memory 仍保留本节固定来源。开工文档基线、服务事实源与截图来源不因此改变。
新增能力
本次只核对 Memory,未声明其他组件的整版手册已更新。
Console:新增记忆、画像、经验与技能、遗忘四类 Pipeline,草稿保存、真实样例验证、发布及各场景默认选择。
Console:经验与技能的候选版本、证据、Diff、人工编辑、批准、拒绝及历史回滚;“自进化二次确认”默认关闭。
Server API:Storage 图片/PDF 异步解析写入、图片辅助文本查询;接口受文件权限和视觉模型配置约束。
Server API:按层级读取概览、上下文、事实和证据的渐进式检索,继续展开使用有时效的 expansionToken。
行为变化
项目 Memory 按项目直接启用;业务调用前等待 active / ready。旧资源与绑定流程不再作为接入步骤。
更新和删除含义分别明确:修改记忆携带 version;主动删除单条记忆会清除记录与检索数据,来源和审计仍可能保留;禁用保留数据;永久删除项目 Memory 异步清理数据,完成后查询为空状态。
智能提取默认异步,以 jobId 查询终态,同时检查 result.status 与逐项 actions;不把 HTTP 202 或任务调度成功当作全部业务成功。
用户画像重新生成仍需新输入;sourceMemoryIds 是补充证据,不能代替 messages。删除画像保留原始记忆。
“上下文”页管理分层聚合及确认、重建与回滚;遗忘规则在配置中的遗忘 Pipeline 维护,与独立 PowerContext 服务分开。
配置与部署
Memory 仍要求 Shared V2 项目。图片/PDF 需要文件读取权限、视觉模型与部署侧媒体解析支持;本文不执行部署或数据库迁移。
废弃与迁移
旧 Memory Resource、claim 和项目绑定初始化流程已从接入说明中移除;SDK 旧资源方法不作为当前服务接入示例。已发布 SDK 的版本与新服务能力分开记录,未更改全仓 SDK 版本钉。
已知问题与核验边界
无本任务证实的产品缺陷。接口契约核对不代表在线模型质量与实际部署结果。
手册侧
更新既有 Memory 概览、记忆操作、画像、经验与技能、模型、上下文、Pipeline、审计、Trace 页面;保持原目录与文件名,不新增功能点。
以用户旅程组织:新建组织/项目、确认存储模式、配置模型并启用 Memory、新建演示记忆,再接入 SDK。产品正文只描述 Console,SDK 入口在 SDK 树。
SDK 文档增加完整可运行 Node.js 流程,涵盖创建、读回、列表、语义搜索、统一召回、版本更新和遗忘;补充异步轮询。
API 及 canonical 指引同步校正 Memory 契约,新增能力不冒充已发布 SDK 方法。
逐语言:本次只更新 zh-CN;en-US / ja-JP 保持未产出状态。其他功能点正文沿用文档基线。
截图台账
本任务的截图来源依据是任务发起人在本会话的明确指令:“用release分支申请测试机,部署一个服务,文档内需要有系统操作截图”,并指定正式入库图片目录为 products/zh-CN/assets/。该指令是本次 Memory 更新使用专属测试机截图的来源例外,优先于目录默认的 SIT 取图步骤;只适用于本任务,不修改通用截图规则,也不将测试机记为 SIT。
部署与取图固定为 release-2.10.0@611a92b4853f3eea6c3ae83d2a0ec3b0480bd582,源码无跟踪修改。独立测试机申请编号 25020024;真实 Core、Memory、Worker 与 Console,Memory 按该版本的 required 009 / supported 006,009 配置,使用演示账号和数据。截图收集提交为文档分支 docs/memory-operation-screenshots-20261016@33e3e2dce8f581c2e149082a1a686031d6b7ce2e。本分支复制下列 PNG 后逐张校验 SHA-256,未用其他版本截图替代。
本次补入 15 张操作截图,来自独立申请的测试机,运行 Agentbase 2.10.0 和真实后端,使用演示账号与数据;不将该环境记为 SIT。覆盖项目创建、启用入口、模型配置、配置确认、就绪状态、直接写入、执行回执、检索、画像、四类 Pipeline、已保存草稿、模型路由、经验与技能、上下文及请求审计。图片位于各页面所属的 assets 目录,逐张检查,均不超过 300 KiB。
实际完成的操作为项目创建、Memory 启用、直接写入、语义检索、画像提取与查询、Pipeline 草稿创建与保存。经验与技能和上下文截图展示真实初始状态,不声明已完成蒸馏、版本批准或上下文生成。独立环境未部署可观测服务,未拍摄 Trace,也不声明移动端回归。移除旧版 Memory 概览图;其他功能点截图沿用基线。
| 图片(相对 products/zh-CN/assets/) | 拍摄时间(UTC,2026-10-16) | SHA-256 |
|---|---|---|
memory/overview/fig-1-create-project.png | 08:52:17.040Z | f4fec8b5ed87f82d23e3353de59935cd5bed5b077cc38efb238e555069a96a61 |
memory/overview/fig-2-memory-disabled.png | 08:49:37.441Z | 0e748a12f213b717e3e8938f6d7fb7c9617078f07798a4991f8bdf5c48312f28 |
memory/overview/fig-3-memory-configuration.png | 08:56:07.618Z | ba98f07f0168192d9dfde6ce0b43c26298e12a0b2a256429332965baa272d8ed |
memory/overview/fig-4-memory-review.png | 08:56:08.369Z | a62d5228629d5ed0c3b56485b2af3782ceb1305bb374d91ad84c977c677c3c89 |
memory/overview/fig-5-memory-ready.png | 08:56:21.515Z | 5ebecdc8e814c9ba79e1e15f86beb772547c0a5a093fe2b50d8b578465878a4a |
memory/memories/fig-1-create-memory.png | 08:56:44.908Z | 2016df8898f098f2b3c91812354496ae1ecc50fc6ea3fbab60fe89fd884bac16 |
memory/memories/fig-2-write-result.png | 08:56:49.794Z | 84f20a7839d408394ed9b5d0cfdc66ba35d54cd62484764266006c4ddd5cd373 |
memory/memories/fig-3-search-memory.png | 08:56:53.325Z | 98051ba33f40d7341b7bda2ee1762f5b96d32992338c2b5db3b6c37c510f85fa |
misc/profiles/fig-1-profiles.png | 08:58:39.200Z | e53865dede33dbe82a70310482381f5de49702b4b0d5e88d4732df8e626e8397 |
misc/evolution/fig-1-evolution.png | 08:57:03.529Z | 5961fae6ba1b21287c053f782e86a83878f98709412fd6f4b5a84032c4bb3f48 |
misc/models/fig-1-models.png | 08:57:06.143Z | a3ab9db50e7bdd91233cacff936b85f1b884388d25fd40cc2a95df15ff1b08f3 |
misc/governance/fig-1-contexts.png | 08:57:08.721Z | abd51c91a853216121937efbcecc117dd860f449c729e923bce30713ea03b365 |
misc/configuration/fig-1-configuration.png | 08:57:11.299Z | 30a901eac5f52cd1a5cc52c3f8f7d84019c90e00af9bc7757ef73f43985d9000 |
misc/configuration/fig-2-pipeline-draft.png | 08:58:41.746Z | 4f8888a44a9a396e55982e82a18c265c6058ddc2c3fe1d157deb9a300bdfa998 |
misc/audit/fig-1-audit.png | 08:57:13.867Z | d72eec65e99ecb01054595c647139d4a1c4db4d90f56352dad91e09dfc98ab99 |
交付核验
复核纠正了处理方式下拉框、控制台无编辑入口、主动删除语义与已遗忘内容保护;补齐权限、演示用户 ID、最小模型配置和异步任务续查步骤。SDK 演示加入本次操作的正文标记,区分新的演示与已删除内容。基础 Embedding 提供方、模型及维度的锁定说明与界面保持一致。
文档工具 77 项测试通过,145 个正文页面构建成功,本地链接与图片引用无死链;15 张新截图通过 PNG 完整性、大小及所属页面检查。Memory 的 54 项 API 操作、请求示例、代码围栏及多语言页签同时检查。删除、遗忘保护与重新学习相关的 5 个定向单元测试及协议单元测试通过。实际安装 2.9.0 SDK 验证完整脚本、连续两轮演示、6 张操作卡和异步成功/等待/部分失败/失败处理。SDK 验证采用模拟传输,不把测试机上的 Console 操作扩大为所有 SDK 或真实模型路线已回归。
本轮审查修正:Skill 下载包的项目准备、完整脚本与 HTTP 接入说明改为包内材料;API 与 SDK 说明明确可省略的字符串 errorCode,补充失败和部分失败响应,并纠正审计操作名 createMemory。新增实际 ZIP 引用边界与错误响应契约回归检查;本轮 81 项测试全部通过,146 个 HTML 页面完成本地引用检查,无死链。
根 DOCS-SYNC.md、API-DESIGN.md、SECURITY.md 已随 PR15 进入上述新目标,本次候选同步并补齐 Memory 文档与新增回归的映射。PR14 内容与新目标的合并结果需独立双轮审查;PR15 的通过记录不代替本次审查。
Memory 专项模拟验证及示例固定使用 SDK 2.9.0;这不覆盖后续 SDK 2.10.0 发布,当前通用接入版本见上表与 SDK 接入页。详情见 SDK 文档记录与 API 文档记录。
2026-10-19 构建就绪补充与截图路径勘误
PR14、PR15 已合入 v2.10.0@8f7b44336cd91e0d172295c6dabfc089fc62a92d;master 尚未同步。后续本轮构建固定此文档基线,修订内容经新的本地候选提交复现。默认 SIT 入口为 https://appbuild-sit.oceanbase.com/ ,此 URL 记录环境坐标,不声称本轮重新取图;Memory 图片仍是前文专属测试机例外。
截图仅按正文所属路径迁移到 assets/<页面路径>/,PNG 字节保持一致;观测概览与指标页原共用的 metrics 图各保留一份相同字节副本,分别归属各页面。原表路径是历史记录,当前以正文链接及所属 assets 子目录为准。迁移涉及 account、auth、databases、knowledge-base、models-ai-gateway、observability、organization、overview;根目录和页面路径不变。调色板 PNG 保留原文件,新增校验覆盖 CRC、解压上限、调色板和像素索引。
SDK/API 记录追加通用 2.10 发布来源,Skill 增加限定 Memory 兼容说明;发布索引仅引用已有制品,未触发新发布。
2026-10-22 基于 release-2.10.2 源码基准的生产级文档体系重构与 SIT 实操取图
源码基准与版本对齐:以
https://code.alipay.com/obai/appbase?ref=release-2.10.2(提交0983b818445bcf261f54c41984ff0d66832ec201,基于release-2.10.00a5d23f9349028496286572fd43117aa6f8fce0a演进)作为能力与代码事实基准,产出文档目标版本保持为 v2.10.0(2.10.0)。文档生成规范升级:参照
datapilot-docs-center企业级产品与开发者文档标准,升级AGENTS.md、products/AGENTS.md、apis/AGENTS.md、sdks/AGENTS.md、DOCS-SYNC.md与VERIFICATION.md规范,确立产品手册六节标准结构(功能概述、核心概念与架构、角色、入口与关联关系、功能详解与操作指南、常见问题与排障、相关文档)与最低正文深度门禁(单篇>= 6000字节)。release-2.10.2 增量能力全量覆盖:
项目级智能体工作台(Agent Runtime)5 大专题新增与补齐:新增
products/zh-CN/agent-runtime/5 篇独立专题文档(智能体工作台概览与启用、模型、提示词、上下文精简与词库拦截配置、多轮会话、异步运行与可恢复 SSE 事件流、挂载企业知识库检索、长期记忆与 PowerContext 协同、绑定 AI Gateway / MCP 工具、客户端工具与 Skill 技能包),并同步更新apis/zh-CN/agent-runtime.md与sdks/zh-CN/agent-runtime.md聚焦项目级/v1/agent-runtime/project/*接口。知识库(Knowledge Base)10 大专题全量拆解与深度补齐:将
products/zh-CN/knowledge-base/扩充为 10 篇独立专题文档(知识库概览、文档摄取与分块管理、外部数据源与语雀同步、GraphRAG 与 RAPTOR 高级索引构建、知识图谱可视化与社区报告、LLM Wiki 自动编译与冲突提案治理、多路混合检索与重排问答、知识库多版本与工作副本、项目级词库与检索/图谱/智能体绑定、知识库设置与多模态图片理解 VLM)。记忆(Memory)12 大专题统一归口与多层/遗忘/经验深度补齐:将原散落在
misc/的记忆子页统一迁回products/zh-CN/memory/目录并扩充为 12 篇独立专题文档(记忆概览与启用、多层记忆划分:三层时效记忆与 L0–L3 认知架构、记忆创建、多模态与混合检索、用户画像提取与重建、经验与技能知识蒸馏、自进化二次确认与版本回滚、分层上下文治理与后台做梦 Dreaming、记忆遗忘机制、艾宾浩斯衰减与保留治理、记忆模型路由与稀疏向量、四类记忆 Pipeline 与版本化配置中心、记忆业务请求审计、记忆调用链路追踪)。
SIT 真实环境业务数据注入与全量实拍截图:在
https://appbuild-sit.oceanbase.com/创建演示组织Agentbase 企业智能中台(69c6d1aa00062e6bb60)与Shared V2演示项目企业智能客服与知识中台(enterprise-ai-hub-210),接入环境变量AGENTBASE_DOCS_DASHSCOPE_API_KEY配置 DashScope Provider(dashscope-prod:qwen-plus、qwen-turbo、text-embedding-v3、qwen3.7-text-rerank、qwen-vl-max),注入真实企业用户、团队、客户工单表(customer_tickets)、知识库文档与切片、GraphRAG/RAPTOR/Wiki 索引、词典、多层长期记忆与蒸馏/遗忘流水线、AI 网关路由、智能体工作台会话及 AgentOps 调用链数据,采集并更新products/zh-CN/assets/下全部 68 张带真实业务数据的控制台截图(单张均<= 300KB且通过 PNG 完整性门禁)。
2026-10-22 手册内容补充(本地候选,未发布)
更新快速开始、FAQ 与产品概览中的版本表述:2.10.0 实例的公开版本端点预期返回
2.10.0,并明确部署版本必须以目标实例读回为准;API Key 示例仅保留该请求所需的users.readscope。按读者任务补充知识库创建、摄取、检索核验、索引构建和版本发布的连续操作路径;用独立 PNG 流程示意呈现首次检索闭环,版本状态关系保留为 Markdown 表格。
流程示意台账(非运行截图):
zh-CN/assets/knowledge-base/overview/diagrams/diagram-1-first-retrieval.png表达创建知识库、摄取、Ready/分块检查、Search 与来源核对;根据 v2.10.0 Console 和知识库手册事实绘制,不模拟 Console 页面,不计入 SIT 截图。移除知识库概览页的旧列表截图:画面脚注标注
Version 2.8.0,与本期事实不符。其他知识库截图按本期记录沿用 2.9.0 实拍素材,本轮未重新拍摄。截图核验:本机可访问实例的
/v1/health/version返回2.10.0,但本轮没有可用的文档截图登录态;默认 SIT 返回2.11.0,不能用于 v2.10 截图。因此本轮未新增真实 Console 截图,待获得有授权的 v2.10 Console 登录态后补拍。扩充
observability/datasets.md:补充创建数据集、手工/CSV/Trace 来源维护条目、Prompt/Agent 运行前置条件,以及 Runs/Reports 的结果查看和失败定位。CSV 限制与重试注意事项按 v2.10.0 Console 实现核对;本页没有新增运行截图,也不将源码核对表述为在线操作验收。扩充
observability/traces.md:按筛选、列表、详情拆解查找路径,说明 Observation 树/时间线/trajectory、详情状态和 Token 汇总边界,并补充无结果排查。产品行为按 v2.10.0 Console 源码复核。扩充
observability/metrics.md:列明 Traces / Observations / Scores 的指标、聚合和分组选项,补查询步骤与空数据排查;更正 Memory only 仅适用于 Observations 视图。沿用现有 v2.10.0 Metrics 实拍,不新增截图。截图勘误:复查
observability/metrics/fig-7-metrics.png后,确认画面为查询空态,原台账“真实数据态”描述有误;保留原台账并在此追加勘误,正文图注已更正,图片字节未修改。扩充
databases/sql-proxy.md:补充标明为示意而非截图的 Console 入口路径、SQL 操作、身份与权限边界、支持的数据库类型和单语句限制;依据 v2.10.0 服务事实说明事务状态命令会被拒绝。同步更正
core-concepts.md中旧的连接恢复/事务重放表述,避免它与 SQL Proxy 不提供公开事务状态的能力边界冲突;补齐两页的事实源映射。SQL Proxy 本轮未新增截图:没有可用的 v2.10.0 Console 登录态;本页内容按固定 v2.10.0 源码核对,不代表在线用户路径已验收。
本节只记录本地候选的内容变化和截图缺口,不表示已推送、创建 PR、部署或发布。
2026-10-23 appbase/docs 内容整理
本批按 appbase v2.10.0@0a5d23f9349028496286572fd43117aa6f8fce0a 的文档及实现核对后改写,文档仓库与 appbase 独立维护;不建立目录复制、子模块或自动同步链路。仅更新当前中文正文,不回写旧版本记录。
| 来源(appbase 固定提交内路径) | 本仓归属 | 整理内容 |
|---|---|---|
docs/products/v2.10.x/functions/default-runtime-specification.md | zh-CN/functions.md | 新函数默认规格的适用范围、显式选择与已有函数边界 |
docs/products/v2.10.x/functions/java-jar-upload.md | zh-CN/functions.md | Java 17 JAR 前置、上传步骤、部署/激活/执行结果和失败处理 |
docs/products/v2.10.x/functions/execution-filters.md | zh-CN/functions.md | Path/Method 筛选、查询串、等待态与删除限制 |
docs/products/v2.10.x/limits/project-read-only.md、docs/tutorials/project-read-only.md | zh-CN/overview/limits.md | 两个独立只读域、操作矩阵、清理例外与 403/503 处理 |
docs/products/v2.10.x/observability/prompts.md | zh-CN/observability/overview.md | Prompt 使用说明、标签/固定版本选择与变量替换 |
docs/tutorials/rag-dataset-evaluation.md | zh-CN/observability/evaluations.md、datasets.md | 数据集 RAG 评估准备、四类模板、真实检索证据、结果与提交异常处理 |
行为复核依据:同一提交的 Functions JavaJarArtifact、DeploymentSizeLimit、Specifications/Executions 路由,Projects ReadOnly 服务与 Admin 更新结果,Observability Prompt Resolve 路由,以及 Console 的 PromptUsage、promptUsageSnippet、ragEvaluationBinding 和 datasetRunSubmission。SDK 示例另按 agentbase-sdks v2.10.0@394f2a53dacfc2494f1f3e71082d9f09b9734ff1 校正,未沿用上游教程的旧 SDK 兼容调用或历史发布状态。
勘误:只读切换返回 503 时可能尚未提交、已提交但排空未完成,或提交结果未知;删除旧正文“重试即可”的建议。JAR 响应中的 Index.java 是兼容标识,真实入口来自 JAR manifest 的 Main-Class。本批未新增 Console 实拍,不把上游模拟页面图片当作真实运行证据;文档预览验收不代表业务环境在线验收。
数据集提交恢复补充:待确认身份存于原标签页会话;同标签页刷新/返回且配置一致可恢复,新标签页或关闭重开不能承诺去重,应先核对已有运行。依据固定 Console 数据集页面对
sessionStorage的使用;保留首次审查发现与修正记录。
2026-10-23 PR21 数量、图片来源与交付流程勘误
当前正文清单为产品 62 篇、API 25 篇、SDK 51 篇;验证指南与 API/SDK 本期记录按实际文件数统一,持久测试核对声明与目录。
本节取代前文 PR21“68 张实拍适用于本版”的结论,原记录按历史保留。PR21 新增和替换图缺少匹配 2.10 的采集证据,抽查 Memory Layers、Lexicons、Functions 列表页明确显示 2.11.0。本次不宣称这些图适用于 2.10:恢复 38 张有固定历史来源的图片,撤下 20 张无对应历史来源的图片及引用;保留 49 张既有资源(含流程示意)。未改造图片内容或遮盖版本标识,也未新增运行实拍。
automation/visual-evidence.json保存逐图摘要、原 Git 路径与来源提交;历史环境版本未在本轮重验的记录显式为 null。相邻图注说明历史演示数据可能不同,不把静态 PNG 检查当作当前环境兼容或功能验收。待采图页面:agent-runtime/configuration、agent-runtime/knowledge-memory、agent-runtime/overview、agent-runtime/threads-runs、agent-runtime/tools-skills、databases/tables、getting-started、knowledge-base/datasources、knowledge-base/graph、knowledge-base/indexing、knowledge-base/lexicons、knowledge-base/overview、knowledge-base/search、knowledge-base/settings、knowledge-base/wiki、memory/experiences、memory/forgetting、memory/layers、memory/traces。这些页面保留操作说明,待匹配版本环境和健康页面核验后再补实拍。
按已确认的版本维护流程,修订 PR 以
v2.10.0为目标,保持人工评审与人工合并,不自动合并;向 master 汇总属于后续独立交付。整合后恢复历史勘误豁免的三项边界:只允许更早版本、已存在于目标提交且字节未变的历史修订;新增、当前或未来版本的
-corrections.md仍检查安装版本钉。合并后的宽泛文件名豁免被回归用例检出并收紧。与 PR21 的
release-2.10.2@0983b818445bcf261f54c41984ff0d66832ec201比较,Functions 模块、Functions/Prompt/Dataset/Search Console 路径保持同一 Git 内容;只读管理端新增部署能力开关,正文补明确认前提。SQL 服务增加同一能力开关注入,事务和入口身份边界不因此改变。窄屏阅读回归发现长行内接口路径撑宽页面,渲染样式允许正文长词组和行内代码断行;围栏代码仍保留空白与独立滚动。新增桌面/窄屏持久用例验证此行为与代码块非回归。
整合复查勘误:统一 Search 默认值、单/跨库参数和响应字段;区分显式模型/Provider 重排失败与增强检索降级,修正答案状态、模型配置及元数据过滤示例。Functions、产品概览和 FAQ 同步 Main-Class 入口、有效包大小和 ready/激活边界,移除撤图后的图号指代。新增持久回归覆盖相邻消费者,防止正确新增段与旧说明并存。
定位字段勘误:依据补充基线
0983b818445bcf261f54c41984ff0d66832ec201的SubProductId、DocumentTagFormat与文档更新路由,修正 Search/文档摄取示例及格式说明;来源留在本记录和 SDK 事实源,不进入产品操作正文。清理撤图后四篇 Agent Runtime 页的失效图号引用。定位字段消费者回扫:明确删除独立字段后仍可能回退定位标识首段。Graph 的 Console 手动加载/分页/邻居/报告按固定页面核对,去除不存在的控件与抽屉;HTTP 使用 type/community/hops,报告使用 offset/limit,发布SDK方法同步。来源为0983b818的Graph三路由、Console graph页面/graphPagination/graphCanvas,以及SDK394f2a53对应模型。