Docs
文档目录

知识库 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 通过五大核心机制彻底解决上述痛点:

  1. 全自动百科大纲规划与多类型页面编译:

    • 开启 LLM Wiki 索引能力并触发构建后,大模型(如 qwen-plus)会自动通读全库分块,生成顶层总览入口页(Slug 固定为 kb-index)及按主题组织的专题章节页(例如在 kb_enterprise_support 中自动编译出 10 篇涵盖平台架构、客服 SOP、OceanBase 向量排障与 AI 网关治理的百科页面)。

    • 页面按语义类型划分为 文档总览(Index)、章节(Section)、文档(Document) 与 记忆(Memory),支持按类型定制专属生成提示词。

  2. 版本化在线协同编辑与一键恢复(Revisions & Rollback):

    • 知识运营人员不仅可以在线新建或手工润色任意 Wiki 页面,系统还会为每一次 AI 编译或人工保存生成不可篡改的修订版本记录(Revisions),支持随时对比差异并一键恢复(Restore)至任意历史版本。

  3. 跨文档知识冲突工作台(Conflict Workbench):

    • 在 Wiki 编译与增量更新过程中,引擎会自动识别不同源文档或分块之间在数值、规则、流程定义上的矛盾点,生成结构化冲突条目进入 冲突工作台(/wiki/conflicts),支持按 documentTag / subProductId 筛选并由领域专家逐条裁决(Resolve)。

  4. AI 更新建议(Proposals)与链接关系图(Wiki Graph):

    • 当底层文档发生更新时,系统会对受影响的 Wiki 页面生成非破坏性的更新建议(Proposals),由管理员选择接受(Accept)或忽略(Dismiss)。

    • 内置 Wiki Graph 可视化展示各百科页面之间的双向引用链接(Backlinks & Outbound Links)拓扑。

  5. 一键导出至记忆中心(Export to Memory):

    • 支持将经过人工审校或冲突裁决后的权威 Wiki 页面一键导出至项目 记忆中心(Memory),直接转化为智能体跨会话可随时调取的长期领域记忆。


核心概念与架构

知识库 Wiki 编译、冲突裁决与记忆导出闭环架构图

知识库 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/wikiGET /v1/knowledgebases/{kbId}/wiki/pages
GET /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/pages
PATCH /v1/knowledgebases/{kbId}/wiki/pages/{slug}
knowledgeBase.createWikiPage()
knowledgeBase.updateWikiPage()
角色:owner、admin、developer
Scope:knowledgebases.write
通过 contentRevision(Compare-And-Swap, CAS)防范多人并发编辑覆盖
页面修订历史与一键回滚Wiki 页面右上角「版本历史(Revisions)」抽屉GET /v1/knowledgebases/{kbId}/wiki/pages/{slug}/revisions
POST .../revisions/{revisionId}/restore
knowledgeBase.listWikiPageRevisions()
knowledgeBase.restoreWikiPageRevision()
角色:owner、admin、developer
Scope:knowledgebases.write
每次 AI 编译、提案合入或人工保存均生成不可变修订快照
跨文档知识冲突检测与裁决/console/.../kb-kb_enterprise_support/wiki(「冲突工作台 Conflicts」子视图)GET /v1/knowledgebases/{kbId}/wiki/conflicts
POST /v1/knowledgebases/{kbId}/wiki/conflicts/{conflictId}/resolve
knowledgeBase.listWikiConflicts()
knowledgeBase.resolveWikiConflict()
角色:owner、admin、developer
Scope:knowledgebases.write
未解决冲突会阻塞 版本管理(Versions) 的就绪封存(Seal)门禁
增量更新建议(Proposals)审阅/console/.../kb-kb_enterprise_support/wiki(「更新建议 Proposals」子视图)GET /v1/knowledgebases/{kbId}/wiki/proposals
POST .../proposals/{id}/accept & dismiss
knowledgeBase.listWikiProposals()
knowledgeBase.acceptWikiProposal()
角色:owner、admin、developer
Scope:knowledgebases.write
增量文档入库后以非破坏性提案方式建议合入既有页面
Wiki 页面引用拓扑图(Wiki Graph)/console/.../kb-kb_enterprise_support/wiki(「链接图 Wiki Graph」子视图)GET /v1/knowledgebases/{kbId}/wiki/graphknowledgeBase.getWikiGraph() / get_wiki_graph()角色:owner、admin、developer、member
Scope:knowledgebases.read
展示 [[slug]] 内部双向引用网络(实体关系图谱详见 知识图谱)
一键导出至记忆中心(Memory)Wiki 页面右上角「导出到 Memory(Export to Memory)」POST /v1/knowledgebases/{kbId}/wiki/pages/{slug}/export-to-memoryknowledgeBase.exportWikiPageToMemory()角色:owner、admin、developer
Scope:knowledgebases.write + memories.write
依赖项目已在 记忆中心(Memory) 启用记忆能力
破坏性重置 Wiki(reset:wiki)Wiki 设置菜单「重置全部 Wiki 页面(Reset Wiki)」POST /v1/knowledgebases/{kbId}/wiki/reset(确认口令 reset:wiki)knowledgeBase.resetWiki()角色:仅限 owner、admin
Scope:knowledgebases.write
彻底清空全部 Wiki 页面、修订历史、提案与冲突单

功能详解与操作指南

一、浏览与编辑自动编译的 Wiki 章节树(10 篇百科页面)

在 kb_enterprise_support 完成 Wiki 索引构建后,进入 Wiki 页签即可看到完整的百科知识工作区:

  1. 左侧章节导航树(Page Tree):

    • 顶层固定为 kb-index(企业智能客服与技术支持知识总览),下方按逻辑层级展开自动编译生成的其余 9 篇专题页面(合计 10 篇 Wiki 页面),涵盖:

      • 平台整体架构与 Shared V2 存储模式总览

      • 智能客服一线/二线工单流转与升级 SOP 规范

      • OceanBase 分布式事务两阶段提交(2PC)机制详解

      • OceanBase 向量索引构建与 -4013 内存排障手册

      • AI 网关逻辑模型路由、护栏与语义缓存计费规范等

  2. 在线编辑与创建新页面:

    • 点击任意页面右上角的 编辑(Edit) 按钮,可使用 Markdown 编辑器调整正文结构、补充内部页面引用链接,保存后自动生成新的修订版本号。

    • 点击左侧目录树顶部的 新建页面(Create page),选择页面类型(章节 / 文档 / 文档总览 / 记忆),填写标题与唯一 slug 即可手动增补百科词条。

  3. 查看修订历史与一键恢复:

    • 点击页面右上角的 版本历史(Revisions),在抽屉中查看历次修订记录,点击任意历史版本右侧的 恢复此版本(Restore) 即可安全回退。


二、审阅更新建议(Proposals)与裁决知识冲突(Conflicts)

在 Wiki 页签顶部切换栏中,除了默认的 页面(Pages) 与 链接图(Wiki Graph) 外,还提供 更新建议(Proposals) 与 冲突工作台(Conflicts) 两个治理子视图:

1. 处理更新建议(/wiki/proposals)

  1. 切换到 更新建议(Proposals) 子视图,列表展示当底层文档新增或修订后,AI 编译器建议合入既有 Wiki 页面的增量段落变更。

  2. 点击单条建议查看 变更前后对比(Diff Preview) 与来源文档分块依据:

    • 若内容准确无误,点击 接受(Accept),系统自动将建议内容合入目标 Wiki 页面并生成新版本;

    • 若无需合入,点击 忽略(Dismiss) 即可归档该条建议。

2. 在冲突工作台裁决跨文档矛盾(/wiki/conflicts)

  1. 切换到 冲突工作台(Conflicts) 子视图(支持按 documentTag 或 subProductId 筛选特定子产品的冲突项)。

  2. 每条冲突记录清晰列出:

    • 冲突主题描述:例如两份文档对同一告警阈值的描述不一致;

    • 证据来源 A 与证据来源 B:并排展示存在矛盾的两个源文档分块及各自的上传时间、documentTag;

  3. 选择权威口径或输入合并后的标准表述,点击 裁决并解决(Resolve Conflict)。裁决结果将同步更新至对应 Wiki 页面,并解除版本封存(Seal)门禁中的冲突阻塞项。


三、将 Wiki 页面一键导出至记忆中心(Export to Memory)

对于经过团队审校的核心百科页面(如《智能客服一线/二线工单流转与升级 SOP 规范》或《OceanBase 向量索引排障速查》),可通过以下步骤将其沉淀至项目记忆中心:

  1. 在 Wiki 页面树中选中目标页面(如 slug 为 oceanbase-vector-index-troubleshooting)。

  2. 点击页面右上角操作栏的 导出到 Memory(Export to Memory) 按钮。

  3. 在确认弹窗中选择或输入目标记忆作用域(如项目公共领域记忆或指定用户/Agent 作用域),点击 确认导出。

  4. 对应的 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) 机制保障数据零覆写丢失:

3. 破坏性重置操作(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。

首次构建时按“选择索引 → 启用并配置 → 发起构建 → 查看任务 → 检查产物”的顺序操作:

  1. 在 Indexes 中选择要使用的索引能力。未启用的能力不会生成对应产物。

  2. 按用途设置输出语言和提示词;开始构建前先确认所需模型 Provider 可用。

  3. 发起构建后,在 Recent tasks 查看状态与日志;失败时先读日志再决定重试,避免对仍在运行的任务重复发起构建。

  4. GraphRAG 构建完成后查看 Graph;LLM Wiki 构建完成后查看 Wiki 页面和链接图。RAPTOR 是派生索引能力,不等同于 Wiki 页面。

原始文档和分块是输入,派生索引是可重建产物;清除索引不会删除原始文档。Wiki Reset 会删除 Wiki 页面本体,操作前确认这是预期行为。

Graph(图谱)

Graph 页签浏览 GraphRAG 产物:实体、关系与社区报告(community reports)的可视化图谱。该页签依赖 GraphRAG 索引已启用并完成构建(部署需具备 GraphRAG 能力)。

Wiki

Wiki 页签把知识库内容组织为百科式页面:

能力说明
页面管理Wiki 页面列表、创建页面、页面详情与编辑;页面保留版本历史,可查看修订记录并恢复历史版本
链接图Wiki Graph 展示页面间的引用链接关系
更新建议系统对 Wiki 页面给出更新建议(proposal),逐条 接受(accept)或忽略(dismiss)
冲突裁决知识冲突进入冲突工作台,逐条裁决解决
页面类型Wiki 页面按类型组织(章节 / 文档 / 文档总览 / 记忆),各类型可配置独立自定义提示词
导出到 MemoryWiki 页面可一键导出到 Memory,沉淀为 Agent 长期记忆(见记忆)

使用边界

常见问题与排障(FAQ)

Q1:在「知识索引(Indexes)」页签清除 Wiki 索引与在 Wiki 页签执行「重置(reset:wiki)」有什么本质区别?

Q2:为什么点击「导出到 Memory」按钮时提示记忆服务未启用(412 Precondition Failed 或服务关闭提示)?

Q3:如何让自动编译出的 Wiki 页面遵循我们企业的特定行文风格或章节模板?

Q4:多人同时编辑同一篇 Wiki 页面时报错 409 Conflict(contentRevision 不匹配)怎么办?


相关文档