AgentbaseDocs
文档目录

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


核心概念与架构

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

flowchart TB
    subgraph RawDocs["底层就绪文档分块 (kb_enterprise_support)"]
        FourDocs["4 篇核心文档分块 (status: ready)\n• Agentbase企业架构白皮书.md\n• 智能客服SOP标准作业手册.md\n• OceanBase分布式事务与向量索引排障指南.md\n• AI网关模型路由与限流计费规范.md"]
    end

    subgraph WikiCompiler["LLM Wiki 自动编译器 (qwen-plus, wikiPageMaxConcurrent)"]
        IndexPage["总览入口页 (kb-index)\n全局知识地图与核心专题导航"]
        ChapterPages["专题章节页面树 (共 10 篇已编译页面)\n带内链 [[slug]] 与源分块证据溯源"]
        WikiGraph["页面引用拓扑图 (/wiki/graph)\n节点与双向引用链接网络"]
    end

    subgraph Governance["持续演进与知识质量治理工作台"]
        Proposals["AI 更新建议 (/wiki/proposals)\n逐条 Accept (接受合入) / Dismiss (忽略)"]
        Conflicts["知识冲突工作台 (/wiki/conflicts)\n跨文档矛盾检测 + 按 documentTag 过滤 + 人工裁决"]
        Revisions["修订历史管理 (/wiki/pages/{slug}/revisions)\n在线编辑 + 历史版本对比与一键回滚"]
    end

    subgraph Downstream["下游智能体与记忆消费"]
        MemoryExport["一键导出至记忆中心\nPOST /wiki/pages/{slug}/export-to-memory"]
        AgentMem["记忆中心 (Shared V2 Memory)\n沉淀为智能体长期领域知识记忆"]
    end

    FourDocs --> WikiCompiler
    WikiCompiler --> IndexPage & ChapterPages --> WikiGraph
    WikiCompiler --> Proposals & Conflicts
    Proposals -->|Accept| Revisions
    Conflicts -->|Resolve 裁决| Revisions
    Revisions --> ChapterPages
    ChapterPages --> MemoryExport --> AgentMem

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<br/>GET /v1/knowledgebases/{kbId}/wiki/pages/{slug}knowledgeBase.listWikiPages()<br/>knowledgeBase.getWikiPage()角色:owner、admin、developer、member(只读)<br/>Scope:knowledgebases.read依赖 高级索引构建 中 wiki 能力已启用并编译完成
**在线 Markdown 编辑与 contentRevision 乐观锁保存**Wiki 页面右上角「编辑(Edit)」与「新建页面(Create page)」POST /v1/knowledgebases/{kbId}/wiki/pages<br/>PATCH /v1/knowledgebases/{kbId}/wiki/pages/{slug}knowledgeBase.createWikiPage()<br/>knowledgeBase.updateWikiPage()角色:owner、admin、developer<br/>Scope:knowledgebases.write通过 contentRevision(Compare-And-Swap, CAS)防范多人并发编辑覆盖
页面修订历史与一键回滚Wiki 页面右上角「版本历史(Revisions)」抽屉GET /v1/knowledgebases/{kbId}/wiki/pages/{slug}/revisions<br/>POST .../revisions/{revisionId}/restoreknowledgeBase.listWikiPageRevisions()<br/>knowledgeBase.restoreWikiPageRevision()角色:owner、admin、developer<br/>Scope:knowledgebases.write每次 AI 编译、提案合入或人工保存均生成不可变修订快照
跨文档知识冲突检测与裁决/console/.../kb-kb_enterprise_support/wiki(「冲突工作台 Conflicts」子视图)GET /v1/knowledgebases/{kbId}/wiki/conflicts<br/>POST /v1/knowledgebases/{kbId}/wiki/conflicts/{conflictId}/resolveknowledgeBase.listWikiConflicts()<br/>knowledgeBase.resolveWikiConflict()角色:owner、admin、developer<br/>Scope:knowledgebases.write未解决冲突会阻塞 版本管理(Versions) 的就绪封存(Seal)门禁
增量更新建议(Proposals)审阅/console/.../kb-kb_enterprise_support/wiki(「更新建议 Proposals」子视图)GET /v1/knowledgebases/{kbId}/wiki/proposals<br/>POST .../proposals/{id}/accept & dismissknowledgeBase.listWikiProposals()<br/>knowledgeBase.acceptWikiProposal()角色:owner、admin、developer<br/>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<br/>Scope:knowledgebases.read展示 [[slug]] 内部双向引用网络(实体关系图谱详见 知识图谱)
一键导出至记忆中心(Memory)Wiki 页面右上角「导出到 Memory(Export to Memory)」POST /v1/knowledgebases/{kbId}/wiki/pages/{slug}/export-to-memoryknowledgeBase.exportWikiPageToMemory()角色:owner、admin、developer<br/>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<br/>Scope:knowledgebases.write彻底清空全部 Wiki 页面、修订历史、提案与冲突单

功能详解与操作指南

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

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


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

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

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

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


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

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

# 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。

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

原始文档和分块是输入,派生索引是可重建产物;清除索引不会删除原始文档。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 不匹配)怎么办?


相关文档