agentbase-docs

版本管理

这是什么 / 何时用

2.8.0 起知识库支持多版本:以 READY 版本为源创建工作副本(异步复制为隔离 DRAFT)→ 就绪检查通过后 Seal 为只读 READY → Publish 切换为当前激活版本,Rollback 则恢复保留的回滚目标;未启用版本化的库先走 Adoption 采纳。所有写路径携带预期修订号做并发保护,操作类变更为异步(幂等键 + 轮询)。产品语义与 Console 入口见版本管理(产品手册)。

使用骨架

关键参数与返回

错误与边界

各语言调用示例

主链:创建工作副本 → 轮询操作 → seal → publish。各卡 expectedBindingRevision 等修订号取自最近一次读取的库与版本对象。

// 1) 创建工作副本(源版本与库的修订号取自最近一次读取)
const op = await kb.createVersion({
    knowledgeBaseId: base.$id,
    sourceVersionId: readyVersion.$id,
    expectedSourceVersionRevision: readyVersion.versionRevision,
    expectedBindingRevision: base.bindingRevision,
    label: 'v2-改写稿',
});
// 2) 轮询操作直至终态 succeeded / failed / cancelled(DRAFT 校验成功后才可见)
let st = await kb.getWorkingCopyOperation({ knowledgeBaseId: base.$id, operationId: op.$id });
// 取消:await kb.cancelWorkingCopyOperation({ knowledgeBaseId: base.$id, operationId: op.$id, expectedOperationRevision: st.operationRevision });
const draft = await kb.getVersion({ knowledgeBaseId: base.$id, versionId: st.result.versionId });
// 3) 就绪检查通过后 seal 为 READY(幂等键按平台约定装载)
const readiness = await kb.getVersionReadiness({ knowledgeBaseId: base.$id, versionId: draft.$id });
if (readiness.sealable) {
    await kb.sealVersion({
        knowledgeBaseId: base.$id,
        versionId: draft.$id,
        expectedDefinitionRevision: readiness.definitionRevision,
        expectedVersionRevision: readiness.versionRevision,
    });
}
// 4) publish 切换当前激活版本(旧当前版本自动成为回滚目标)
await kb.publishVersion({
    knowledgeBaseId: base.$id,
    versionId: draft.$id,
    expectedBindingRevision: base.bindingRevision,
    expectedVersionRevision: draft.versionRevision,
});

事实源