知识库 Wiki(百科编译、冲突裁决与记忆导出)
知识库 Wiki(LLM Wiki) 是 Agentbase v2.10.0 将碎片化的文档分块自动提炼、重组并编译为结构化、人类可读且持续演进的企业百科知识体系的创新模块。通过知识库详情页的 Wiki 页签,系统能够基于库内已就绪(ready)的文档资产(如 kb_enterprise_support 中的 4 篇核心技术规范),自动规划全局目录总览(kb-index)并编译生成多篇专题百科页面(如生产实测生成的 10 篇结构化百科章节页),同时提供 页面修订历史与回滚、跨文档知识冲突自动检测与裁决工作台(/wiki/conflicts)、智能更新建议(/wiki/proposals)、页面引用关系图(/wiki/graph),并支持将高价值 Wiki 页面一键导出至记忆中心(/wiki/pages/{slug}/export-to-memory)沉淀为智能体的长期记忆。
功能概述与核心场景
在企业知识库长期运营过程中,不同部门上传的多份文档之间经常存在两类突出问题:一是知识分散在数十个零散文档中,新员工与智能体难以建立全局结构化认知;二是不同时期编写的手册之间可能存在参数或流程冲突(例如旧版文档写“工单升级时限为 30 分钟”,新版 SOP 写“P1 工单须在 15 分钟内升级”),导致 RAG 检索同时召回矛盾证据。
Agentbase 的 知识库 Wiki 通过五大核心机制彻底解决上述痛点:
全自动百科大纲规划与多类型页面编译:
开启
LLM Wiki索引能力并触发构建后,大模型(如qwen-plus)会自动通读全库分块,生成顶层总览入口页(Slug 固定为kb-index)及按主题组织的专题章节页(例如在kb_enterprise_support中自动编译出 10 篇涵盖平台架构、客服 SOP、OceanBase 向量排障与 AI 网关治理的百科页面)。页面按语义类型划分为 文档总览(Index)、章节(Section)、文档(Document) 与 记忆(Memory),支持按类型定制专属生成提示词。
版本化在线协同编辑与一键恢复(Revisions & Rollback):
知识运营人员不仅可以在线新建或手工润色任意 Wiki 页面,系统还会为每一次 AI 编译或人工保存生成不可篡改的修订版本记录(Revisions),支持随时对比差异并一键恢复(Restore)至任意历史版本。
跨文档知识冲突工作台(Conflict Workbench):
在 Wiki 编译与增量更新过程中,引擎会自动识别不同源文档或分块之间在数值、规则、流程定义上的矛盾点,生成结构化冲突条目进入 冲突工作台(
/wiki/conflicts),支持按documentTag/subProductId筛选并由领域专家逐条裁决(Resolve)。
AI 更新建议(Proposals)与链接关系图(Wiki Graph):
当底层文档发生更新时,系统会对受影响的 Wiki 页面生成非破坏性的更新建议(Proposals),由管理员选择接受(Accept)或忽略(Dismiss)。
内置 Wiki Graph 可视化展示各百科页面之间的双向引用链接(Backlinks & Outbound Links)拓扑。
一键导出至记忆中心(Export to Memory):
支持将经过人工审校或冲突裁决后的权威 Wiki 页面一键导出至项目 记忆中心(Memory),直接转化为智能体跨会话可随时调取的长期领域记忆。
核心概念与架构
知识库 Wiki 编译、冲突裁决与记忆导出闭环架构图
流程示意,不是运行截图;按箭头阅读步骤或状态之间的关系。
Wiki 核心对象与接口说明表
| 核心对象 | 关键标识 / 路由路径 | 详细说明 |
|---|---|---|
| 总览首页 | slug = "kb-index" | 知识库 Wiki 编译自动生成的根入口页面,汇总整个知识库的核心领域架构、模块划分与子页面导航链接。 |
| 专题百科页面 | /wiki/pages/{slug} | 按主题聚合多篇源文档证据生成的结构化 Markdown 百科页(如在 kb_enterprise_support 中编译生成的 10 篇页面)。 |
| 页面修订历史 | /wiki/pages/{slug}/revisions | 记录页面自创建以来的全部版本快照(含版本号、修改人/编译任务 ID、时间戳与正文快照),支持按版本恢复。 |
| 页面引用图 | /wiki/graph | 描述 Wiki 页面之间通过内部链接互相引用的有向图结构(Nodes 为页面,Edges 为引用关系)。 |
| AI 更新建议 | /wiki/proposals | 当新文档入库或重编译时发现可补充至既有 Wiki 页面的增量内容建议,支持 accept(接受并生成新修订版)或 dismiss(忽略)。 |
| 知识冲突单 | /wiki/conflicts | 编译器检测到的跨文档事实矛盾或过时定义。未解决的严重冲突不仅在冲突工作台中高亮提示,还会在版本封存(Seal)就绪检查中被重点核验。 |
| 导出至记忆 | /wiki/pages/{slug}/export-to-memory | 将指定 Wiki 页面的结构化内容同步写入项目的 Memory 服务,实现知识库静态百科向智能体动态记忆的转化。 |
功能入口与权限矩阵
控制台入口、REST API、SDK 方法与权限矩阵
| 控制台入口 / 功能模块 | 前端路由路径 | 对应 REST API 端点 | Server SDK 方法(Node.js / Python) | 所需 RBAC 角色 / API Key Scope | 跨模块依赖关系 |
|---|---|---|---|---|---|
| Wiki 页面章节树与正文浏览 | /console/project-default-enterprise-ai-hub-210/knowledge-base/kb-kb_enterprise_support/wiki | GET /v1/knowledgebases/{kbId}/wiki/pagesGET /v1/knowledgebases/{kbId}/wiki/pages/{slug} | knowledgeBase.listWikiPages()knowledgeBase.getWikiPage() | 角色:owner、admin、developer、member(只读)Scope: knowledgebases.read | 依赖 高级索引构建 中 wiki 能力已启用并编译完成 |
在线 Markdown 编辑与 contentRevision 乐观锁保存 | Wiki 页面右上角「编辑(Edit)」与「新建页面(Create page)」 | POST /v1/knowledgebases/{kbId}/wiki/pagesPATCH /v1/knowledgebases/{kbId}/wiki/pages/{slug} | knowledgeBase.createWikiPage()knowledgeBase.updateWikiPage() | 角色:owner、admin、developerScope: knowledgebases.write | 通过 contentRevision(Compare-And-Swap, CAS)防范多人并发编辑覆盖 |
| 页面修订历史与一键回滚 | Wiki 页面右上角「版本历史(Revisions)」抽屉 | GET /v1/knowledgebases/{kbId}/wiki/pages/{slug}/revisionsPOST .../revisions/{revisionId}/restore | knowledgeBase.listWikiPageRevisions()knowledgeBase.restoreWikiPageRevision() | 角色:owner、admin、developerScope: knowledgebases.write | 每次 AI 编译、提案合入或人工保存均生成不可变修订快照 |
| 跨文档知识冲突检测与裁决 | /console/.../kb-kb_enterprise_support/wiki(「冲突工作台 Conflicts」子视图) | GET /v1/knowledgebases/{kbId}/wiki/conflictsPOST /v1/knowledgebases/{kbId}/wiki/conflicts/{conflictId}/resolve | knowledgeBase.listWikiConflicts()knowledgeBase.resolveWikiConflict() | 角色:owner、admin、developerScope: knowledgebases.write | 未解决冲突会阻塞 版本管理(Versions) 的就绪封存(Seal)门禁 |
| 增量更新建议(Proposals)审阅 | /console/.../kb-kb_enterprise_support/wiki(「更新建议 Proposals」子视图) | GET /v1/knowledgebases/{kbId}/wiki/proposalsPOST .../proposals/{id}/accept & dismiss | knowledgeBase.listWikiProposals()knowledgeBase.acceptWikiProposal() | 角色:owner、admin、developerScope: knowledgebases.write | 增量文档入库后以非破坏性提案方式建议合入既有页面 |
| Wiki 页面引用拓扑图(Wiki Graph) | /console/.../kb-kb_enterprise_support/wiki(「链接图 Wiki Graph」子视图) | GET /v1/knowledgebases/{kbId}/wiki/graph | knowledgeBase.getWikiGraph() / get_wiki_graph() | 角色:owner、admin、developer、memberScope: knowledgebases.read | 展示 [[slug]] 内部双向引用网络(实体关系图谱详见 知识图谱) |
| 一键导出至记忆中心(Memory) | Wiki 页面右上角「导出到 Memory(Export to Memory)」 | POST /v1/knowledgebases/{kbId}/wiki/pages/{slug}/export-to-memory | knowledgeBase.exportWikiPageToMemory() | 角色:owner、admin、developerScope: knowledgebases.write + memories.write | 依赖项目已在 记忆中心(Memory) 启用记忆能力 |
破坏性重置 Wiki(reset:wiki) | Wiki 设置菜单「重置全部 Wiki 页面(Reset Wiki)」 | POST /v1/knowledgebases/{kbId}/wiki/reset(确认口令 reset:wiki) | knowledgeBase.resetWiki() | 角色:仅限 owner、adminScope: knowledgebases.write | 彻底清空全部 Wiki 页面、修订历史、提案与冲突单 |
功能详解与操作指南
一、浏览与编辑自动编译的 Wiki 章节树(10 篇百科页面)
在 kb_enterprise_support 完成 Wiki 索引构建后,进入 Wiki 页签即可看到完整的百科知识工作区:
左侧章节导航树(Page Tree):
顶层固定为
kb-index(企业智能客服与技术支持知识总览),下方按逻辑层级展开自动编译生成的其余 9 篇专题页面(合计 10 篇 Wiki 页面),涵盖:平台整体架构与 Shared V2 存储模式总览
智能客服一线/二线工单流转与升级 SOP 规范
OceanBase 分布式事务两阶段提交(2PC)机制详解
OceanBase 向量索引构建与
-4013内存排障手册AI 网关逻辑模型路由、护栏与语义缓存计费规范等
在线编辑与创建新页面:
点击任意页面右上角的 编辑(Edit) 按钮,可使用 Markdown 编辑器调整正文结构、补充内部页面引用链接,保存后自动生成新的修订版本号。
点击左侧目录树顶部的 新建页面(Create page),选择页面类型(章节 / 文档 / 文档总览 / 记忆),填写标题与唯一
slug即可手动增补百科词条。
查看修订历史与一键恢复:
点击页面右上角的 版本历史(Revisions),在抽屉中查看历次修订记录,点击任意历史版本右侧的 恢复此版本(Restore) 即可安全回退。
二、审阅更新建议(Proposals)与裁决知识冲突(Conflicts)
在 Wiki 页签顶部切换栏中,除了默认的 页面(Pages) 与 链接图(Wiki Graph) 外,还提供 更新建议(Proposals) 与 冲突工作台(Conflicts) 两个治理子视图:
1. 处理更新建议(/wiki/proposals)
切换到 更新建议(Proposals) 子视图,列表展示当底层文档新增或修订后,AI 编译器建议合入既有 Wiki 页面的增量段落变更。
点击单条建议查看 变更前后对比(Diff Preview) 与来源文档分块依据:
若内容准确无误,点击 接受(Accept),系统自动将建议内容合入目标 Wiki 页面并生成新版本;
若无需合入,点击 忽略(Dismiss) 即可归档该条建议。
2. 在冲突工作台裁决跨文档矛盾(/wiki/conflicts)
切换到 冲突工作台(Conflicts) 子视图(支持按
documentTag或subProductId筛选特定子产品的冲突项)。每条冲突记录清晰列出:
冲突主题描述:例如两份文档对同一告警阈值的描述不一致;
证据来源 A 与证据来源 B:并排展示存在矛盾的两个源文档分块及各自的上传时间、
documentTag;
选择权威口径或输入合并后的标准表述,点击 裁决并解决(Resolve Conflict)。裁决结果将同步更新至对应 Wiki 页面,并解除版本封存(Seal)门禁中的冲突阻塞项。
三、将 Wiki 页面一键导出至记忆中心(Export to Memory)
对于经过团队审校的核心百科页面(如《智能客服一线/二线工单流转与升级 SOP 规范》或《OceanBase 向量索引排障速查》),可通过以下步骤将其沉淀至项目记忆中心:
在 Wiki 页面树中选中目标页面(如
slug为oceanbase-vector-index-troubleshooting)。点击页面右上角操作栏的 导出到 Memory(Export to Memory) 按钮。
在确认弹窗中选择或输入目标记忆作用域(如项目公共领域记忆或指定用户/Agent 作用域),点击 确认导出。
对应的 REST API 操作指令集合如下:
# 1. 获取知识库 Wiki 已编译页面列表 (共 10 篇页面,含 kb-index)
curl -X GET "https://appbuild.oceanbase.com/v1/knowledgebases/kb_enterprise_support/wiki/pages" \
-H "X-Appwrite-Project: enterprise-ai-hub-210" \
-H "X-Appwrite-Key: <APPBASE_API_KEY>"
# 2. 查看 Wiki 页面間の引用链接拓扑图
curl -X GET "https://appbuild.oceanbase.com/v1/knowledgebases/kb_enterprise_support/wiki/graph" \
-H "X-Appwrite-Project: enterprise-ai-hub-210" \
-H "X-Appwrite-Key: <APPBASE_API_KEY>"
# 3. 查询待裁决的 Wiki 知识冲突列表(支持按 subProductId 或 documentTag 过滤)
curl -X GET "https://appbuild.oceanbase.com/v1/knowledgebases/kb_enterprise_support/wiki/conflicts?subProductId=ob" \
-H "X-Appwrite-Project: enterprise-ai-hub-210" \
-H "X-Appwrite-Key: <APPBASE_API_KEY>"
# 4. 将指定的 Wiki 页面导出至项目记忆中心 (POST /wiki/pages/{slug}/export-to-memory)
curl -X POST "https://appbuild.oceanbase.com/v1/knowledgebases/kb_enterprise_support/wiki/pages/kb-index/export-to-memory" \
-H "X-Appwrite-Project: enterprise-ai-hub-210" \
-H "X-Appwrite-Key: <APPBASE_API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"userId": "user_zhangwei_001",
"metadata": {
"source": "kb_enterprise_support_wiki",
"pageSlug": "kb-index"
}
}'四、四类页面编译模板、contentRevision CAS 并发控制与 reset:wiki 重置机制
1. 四类结构化 Wiki 页面类型(Index / Section / Document / Memory)
LLM Wiki 编译器并非将文档简单拼接,而是按照四种语义层级组织百科知识体系(可在 高级知识索引构建治理 的 LLM Wiki 配置中为每种类型定制专属提示词):
页面类型 (pageType) | 典型 Slug 示例 | 核心职责与结构特征 |
|---|---|---|
文档总览(Index) | kb-index | 全局唯一根入口页。自动提炼全库领域版图、核心子产品导航树及高频排障入口链接。 |
章节(Section) | oceanbase-vector-index-troubleshooting | 跨多篇源文档聚合同一专题(如综合白皮书、排障指南与 SOP 中的向量索引章节),内含双向内链 [[slug]] 与分块引用。 |
文档(Document) | doc-ai-gateway-routing-spec | 针对单篇核心规范文档生成的结构化精粹百科页,保留完整的参数表与架构要点。 |
记忆(Memory) | mem-p1-incident-escalation-rules | 提炼高密度、强约束的原子规则与黄金 SOP 条目,专供一键导出至 记忆中心(Memory) 供智能体长期召回。 |
2. Markdown 在线编辑与 contentRevision CAS 乐观锁保护
当多位领域专家同时在线润色同一篇 Wiki 页面,或人工编辑与后台提案合入(Accept Proposal)并发发生时,Agentbase 通过 contentRevision(Compare-And-Swap, CAS) 机制保障数据零覆写丢失:
每次调用
GET /v1/knowledgebases/{kbId}/wiki/pages/{slug}获取页面详情时,响应体均包含当前单调递增的整数修订号contentRevision(如contentRevision: 3);当提交修改
PATCH /v1/knowledgebases/{kbId}/wiki/pages/{slug}时,请求体可携带expectedContentRevision: 3;若服务端发现当前最新修订号已变为4,立即返回 HTTP409 Conflict,提示前端加载最新修订对比后再保存。
3. 破坏性重置操作(reset:wiki)与高级索引联动
与 GraphRAG / RAPTOR 的分工:若需配置
GraphRAG、RAPTOR或设置LLM Wiki的await_graphrag依赖栅栏与pageMaxConcurrent并发度,请前往 GraphRAG、RAPTOR 与高级知识索引构建治理;若需探索实体关系力导向图与 Leiden 社区摘要报告,请前往 知识图谱(Graph)可视化探索与社区报告。执行
reset:wiki破坏性重置:当企业彻底重构知识库文档结构、希望舍弃全部既有人工编辑的 Wiki 页面并从零重新编译时,可调用重置端点并显式传入确认令牌"confirm": "reset:wiki":
# 1. 带 contentRevision CAS 乐观锁更新指定 Wiki 页面 (PATCH /v1/knowledgebases/{kbId}/wiki/pages/{slug})
curl -X PATCH "https://appbuild.oceanbase.com/v1/knowledgebases/kb_enterprise_support/wiki/pages/oceanbase-vector-index-troubleshooting" \
-H "X-Appwrite-Project: enterprise-ai-hub-210" \
-H "X-Appwrite-Key: <APPBASE_API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"title": "OceanBase 向量索引构建与 -4013 内存排障权威指南",
"content": "## 核心排障步骤\n\n当出现 `OB_ALLOCATE_MEMORY_FAILED (-4013)` 时,请先检查 `ob_vector_memory_limit_percentage` 参数(建议调至 30%),详见 [[kb-index]]。",
"expectedContentRevision": 3
}'
# 2. 裁决并解决跨文档知识冲突 (POST /v1/knowledgebases/{kbId}/wiki/conflicts/{conflictId}/resolve)
curl -X POST "https://appbuild.oceanbase.com/v1/knowledgebases/kb_enterprise_support/wiki/conflicts/conf_p1_sop_timeout_01/resolve" \
-H "X-Appwrite-Project: enterprise-ai-hub-210" \
-H "X-Appwrite-Key: <APPBASE_API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"resolution": "统一按最新《智能客服SOP标准作业手册.md》执行:P1 级生产故障必须在 15 分钟内升级至二线技术专家。",
"applyToWikiPage": true
}'
# 3. 破坏性重置整个知识库的 Wiki 页面、修订历史与冲突单(必须传入确认口令 reset:wiki)
curl -X POST "https://appbuild.oceanbase.com/v1/knowledgebases/kb_enterprise_support/wiki/reset" \
-H "X-Appwrite-Project: enterprise-ai-hub-210" \
-H "X-Appwrite-Key: <APPBASE_API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"confirm": "reset:wiki"
}'知识索引(Indexes)
Indexes 页签集中管理三类派生索引:GraphRAG、RAPTOR 与 LLM Wiki。
首次构建时按“选择索引 → 启用并配置 → 发起构建 → 查看任务 → 检查产物”的顺序操作:
在 Indexes 中选择要使用的索引能力。未启用的能力不会生成对应产物。
按用途设置输出语言和提示词;开始构建前先确认所需模型 Provider 可用。
发起构建后,在 Recent tasks 查看状态与日志;失败时先读日志再决定重试,避免对仍在运行的任务重复发起构建。
GraphRAG 构建完成后查看 Graph;LLM Wiki 构建完成后查看 Wiki 页面和链接图。RAPTOR 是派生索引能力,不等同于 Wiki 页面。
原始文档和分块是输入,派生索引是可重建产物;清除索引不会删除原始文档。Wiki Reset 会删除 Wiki 页面本体,操作前确认这是预期行为。
每类索引可独立启用 / 配置 / 构建 / 清除 / 强制重建;未启用时该能力不可用。
输出语言配置决定派生知识(Wiki 页面、图谱报告等)的生成语言(2.9.0 起配置项更名为「输出语言」)。
自定义提示词(2.9.0):GraphRAG 可为实体抽取、描述摘要、社区报告配置自定义提示词;Wiki 可按页面类型(章节 / 文档 / 文档总览 / 记忆)配置各自提示词;留空回退内置模板。构建支持并发 / 批量 / 缓冲操作控制(如
graphragEmbedBatchSize、wikiPageMaxConcurrent),显式值仅保存上限内合法整数,未提供时回落 worker 默认。最近任务列表展示索引构建/清理任务,支持取消、重试与查看日志;任务异步执行,可离开页面后回来查看结果。
Graph(图谱)
Graph 页签浏览 GraphRAG 产物:实体、关系与社区报告(community reports)的可视化图谱。该页签依赖 GraphRAG 索引已启用并完成构建(部署需具备 GraphRAG 能力)。
Wiki
Wiki 页签把知识库内容组织为百科式页面:
| 能力 | 说明 |
|---|---|
| 页面管理 | Wiki 页面列表、创建页面、页面详情与编辑;页面保留版本历史,可查看修订记录并恢复历史版本 |
| 链接图 | Wiki Graph 展示页面间的引用链接关系 |
| 更新建议 | 系统对 Wiki 页面给出更新建议(proposal),逐条 接受(accept)或忽略(dismiss) |
| 冲突裁决 | 知识冲突进入冲突工作台,逐条裁决解决 |
| 页面类型 | Wiki 页面按类型组织(章节 / 文档 / 文档总览 / 记忆),各类型可配置独立自定义提示词 |
| 导出到 Memory | Wiki 页面可一键导出到 Memory,沉淀为 Agent 长期记忆(见记忆) |
使用边界
三类派生索引的构建消耗 LLM 与 embedding 配额,大库构建耗时较长;重复构建前先确认既有任务状态。
清除(clear)只删除派生索引数据,不影响原始文档与分块;Wiki 的重置会删除 Wiki 页面本体,属于破坏性操作。
导出到 Memory 要求项目已启用 Memory 能力。
常见问题与排障(FAQ)
Q1:在「知识索引(Indexes)」页签清除 Wiki 索引与在 Wiki 页签执行「重置(reset:wiki)」有什么本质区别?
原因分析: 知识库中的 Wiki 资产分为「后台派生编译索引状态」与「已固化并经过人工编辑审校的 Wiki 页面文档树(含 Revisions、Proposals、Conflicts)」两部分。
解决措施:
清除索引(Clear Index):仅清理后台辅助编译状态,保留已编写和人工修订的 Wiki 页面正文。
重置 Wiki(
reset:wiki):属于不可逆的破坏性操作,会彻底删除当前知识库下的全部 Wiki 页面本体、修订历史、更新建议与冲突记录。执行重置前请务必确认无需保留现有人工编辑成果,或已通过 知识库版本管理(Versions) 封存了历史快照。
Q2:为什么点击「导出到 Memory」按钮时提示记忆服务未启用(412 Precondition Failed 或服务关闭提示)?
原因分析: 「导出到 Memory」(
POST .../wiki/pages/{slug}/export-to-memory)功能需要将百科页面向量化并写入项目的Shared V2记忆表组,因此强依赖当前项目已启用并初始化了 记忆(Memory) 模块。解决措施: 请前往控制台左侧导航栏 记忆(Memory) 页面(详见 记忆中心总览与配置),确认项目记忆能力已开启并绑定了可用的 Chat 模型(
qwen-plus)与 Embedding 模型(text-embedding-v3),随后即可正常执行 Wiki 页面导出。
Q3:如何让自动编译出的 Wiki 页面遵循我们企业的特定行文风格或章节模板?
原因分析: 默认情况下,LLM Wiki 编译器使用平台内置的标准技术百科提示词模板生成
Index、Section、Document与Memory四类页面。解决措施: 前往知识库的 知识索引(Indexes) 页签(详见 GraphRAG、RAPTOR 与高级知识索引构建治理),点击 LLM Wiki 卡片上的 配置(Configure),在 自定义提示词(Custom Prompts) 区域分别针对 文档总览(Index)、章节(Section)、文档(Document) 与 记忆(Memory) 四种页面类型编写专属的 System Prompt 模板,并指定输出语言(如
zh-CN),随后触发重新构建即可按企业规范生成百科页面。
Q4:多人同时编辑同一篇 Wiki 页面时报错 409 Conflict(contentRevision 不匹配)怎么办?
原因分析: 在您打开编辑器期间,另一位团队成员或后台「接受更新建议(Accept Proposal)」操作已经保存了新版本,导致页面的
contentRevision递增,乐观锁(CAS)自动阻止了旧版本覆盖。解决措施: 请先复制您当前编辑的增量段落,刷新页面或打开右上角 版本历史(Revisions) 抽屉查看刚刚合入的最新变更,在最新修订版基础上粘贴合并您的修改后再次点击保存。
