Docs
文档目录

知识库 Wiki(百科编译、冲突裁决与记忆导出)

知识库 Wiki(LLM Wiki) 根据知识库内容生成可阅读的页面,便于查看、组织和追溯知识。进入知识库详情页的 Wiki 页签,可按环境支持情况查看页面、来源和链接;冲突处理、更新建议及导出记忆等操作还受部署配置和权限限制。


功能概述与核心场景

在企业知识库长期运营过程中,不同部门上传的多份文档之间经常存在两类突出问题:一是知识分散在数十个零散文档中,新员工与智能体难以建立全局结构化认知;二是不同时期编写的手册之间可能存在参数或流程冲突(例如旧版文档写“工单升级时限为 30 分钟”,新版 SOP 写“P1 工单须在 15 分钟内升级”),导致 RAG 检索同时召回矛盾证据。

Agentbase 的 知识库 Wiki 提供以下能力,帮助整理和核对知识:

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

    • 开启 LLM Wiki 索引能力并触发构建后,系统根据配置的来源生成 Wiki 页面;页面的数量与内容取决于来源、模型和构建结果。

    • 页面对象的类型为 entity、topic、survey、agent_practice 或 category_index;编译提示词模板类别与页面类型是不同的配置。

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

    • 知识运营人员不仅可以在线新建或手工润色任意 Wiki 页面,系统会生成修订版本记录(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 百科页。
页面修订历史/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 .../wiki/pages/{slug}/restore
knowledgeBase.listWikiPageRevisions()
knowledgeBase.restoreWikiPage()
角色:owner、admin、developer
Scope:GET knowledgebases.read;POST knowledgebases.write
每次 AI 编译、提案合入或人工保存均生成不可变修订快照
跨文档知识冲突检测与裁决/console/.../kb-kb_enterprise_support/wiki(「冲突工作台 Conflicts」子视图)GET /v1/knowledgebases/{kbId}/wiki/conflicts
POST /v1/knowledgebases/{kbId}/wiki/conflicts/{slug}/resolve
knowledgeBase.listWikiConflicts()
knowledgeBase.resolveWikiConflict()
角色:owner、admin、developer
Scope:GET knowledgebases.read;POST knowledgebases.write
未解决冲突会阻塞 版本管理(Versions) 的就绪封存(Seal)门禁
增量更新建议(Proposals)审阅/console/.../kb-kb_enterprise_support/wiki(「更新建议 Proposals」子视图)GET /v1/knowledgebases/{kbId}/wiki/proposals
POST .../proposals/{id}/accept
knowledgeBase.listWikiProposals()
knowledgeBase.acceptWikiProposal()
角色:owner、admin、developer
Scope:GET knowledgebases.read;POST 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.createWikiPageMemoryExport()角色:owner、admin、developer
Scope:knowledgebases.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 页面

完成 Wiki 构建后,进入目标知识库的 Wiki 页面查看结果。页面数量和内容以实际构建结果为准:

  1. 页面导航:从页面列表选择需要查看的内容;构建结果可能包含 kb-index 概览页。

  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. 确认导出结果。接口写入项目级知识;调用方不能通过该接口选择目标用户或自定义导出元数据。

  4. 对应的 REST API 操作指令集合如下:

将 APPBASE_ENDPOINT 设置为目标环境的 API 地址(包含 /v1),并确认项目与凭据属于该环境。Wiki 重置会删除页面、修订历史和冲突,请在执行前再次确认目标与影响。

获取知识库 Wiki 页面列表

(
  set +x
  set -o pipefail
  : "${APPBASE_API_KEY:?Set APPBASE_API_KEY}"
: "${APPBASE_ENDPOINT:?Set APPBASE_ENDPOINT to the target API endpoint including /v1}"
APPBASE_ENDPOINT="${APPBASE_ENDPOINT%/}"
builtin printf 'X-Appwrite-Key: %s\n' "$APPBASE_API_KEY" | curl --disable -X GET "${APPBASE_ENDPOINT}/knowledgebases/kb_enterprise_support/wiki/pages" \
  -H "X-Appwrite-Project: enterprise-ai-hub-210" \
  --header @-
)

查看 Wiki 页面間の引用链接拓扑图

(
  set +x
  set -o pipefail
  : "${APPBASE_API_KEY:?Set APPBASE_API_KEY}"
: "${APPBASE_ENDPOINT:?Set APPBASE_ENDPOINT to the target API endpoint including /v1}"
APPBASE_ENDPOINT="${APPBASE_ENDPOINT%/}"
builtin printf 'X-Appwrite-Key: %s\n' "$APPBASE_API_KEY" | curl --disable -X GET "${APPBASE_ENDPOINT}/knowledgebases/kb_enterprise_support/wiki/graph" \
  -H "X-Appwrite-Project: enterprise-ai-hub-210" \
  --header @-
)

查询待裁决的 Wiki 知识冲突列表(支持按 subProductId 或 documentTag 过滤)

(
  set +x
  set -o pipefail
  : "${APPBASE_API_KEY:?Set APPBASE_API_KEY}"
: "${APPBASE_ENDPOINT:?Set APPBASE_ENDPOINT to the target API endpoint including /v1}"
APPBASE_ENDPOINT="${APPBASE_ENDPOINT%/}"
builtin printf 'X-Appwrite-Key: %s\n' "$APPBASE_API_KEY" | curl --disable -X GET "${APPBASE_ENDPOINT}/knowledgebases/kb_enterprise_support/wiki/conflicts?subProductId=ob" \
  -H "X-Appwrite-Project: enterprise-ai-hub-210" \
  --header @-
)

将指定的 Wiki 页面导出至项目记忆中心 (POST /wiki/pages/{slug}/export-to-memory)

(
  set +x
  set -o pipefail
  : "${APPBASE_API_KEY:?Set APPBASE_API_KEY}"
: "${APPBASE_ENDPOINT:?Set APPBASE_ENDPOINT to the target API endpoint including /v1}"
APPBASE_ENDPOINT="${APPBASE_ENDPOINT%/}"
builtin printf 'X-Appwrite-Key: %s\n' "$APPBASE_API_KEY" | curl --disable -X POST "${APPBASE_ENDPOINT}/knowledgebases/kb_enterprise_support/wiki/pages/kb-index/export-to-memory" \
  -H "X-Appwrite-Project: enterprise-ai-hub-210" \
  --header @- \
  -H "Content-Type: application/json" \
  -d '{
    "agentId": "wiki-export"
  }'
)

四、Wiki 页面类型、contentRevision CAS 并发控制与 reset:wiki 重置机制

1. Wiki 页面类型与编译模板

页面对象的 pageType 支持 entity、topic、survey、agent_practice 和 category_index。生成提示词另按模板类别配置,详见高级知识索引构建治理,不要把模板类别当作 pageType 值。

2. Markdown 在线编辑与 contentRevision CAS 乐观锁保护

当多位领域专家同时在线润色同一篇 Wiki 页面,或人工编辑与后台提案合入(Accept Proposal)并发发生时,Agentbase 通过 contentRevision(Compare-And-Swap, CAS) 机制保障数据零覆写丢失:

3. 破坏性重置操作(reset:wiki)与高级索引联动

带 contentRevision CAS 乐观锁更新指定 Wiki 页面 (PATCH /v1/knowledgebases/{kbId}/wiki/pages/{slug})

(
  set +x
  set -o pipefail
  : "${APPBASE_API_KEY:?Set APPBASE_API_KEY}"
: "${APPBASE_ENDPOINT:?Set APPBASE_ENDPOINT to the target API endpoint including /v1}"
APPBASE_ENDPOINT="${APPBASE_ENDPOINT%/}"
builtin printf 'X-Appwrite-Key: %s\n' "$APPBASE_API_KEY" | curl --disable -X PATCH "${APPBASE_ENDPOINT}/knowledgebases/kb_enterprise_support/wiki/pages/oceanbase-vector-index-troubleshooting" \
  -H "X-Appwrite-Project: enterprise-ai-hub-210" \
  --header @- \
  -H "Content-Type: application/json" \
  -d '{
    "contentRevision": 3,
    "page": {
      "title": "Wiki example",
      "contentMd": "## Example\n\nSee [[kb-index]]."
    }
  }'
)

裁决并解决跨文档知识冲突 (POST /v1/knowledgebases/{kbId}/wiki/conflicts/{slug}/resolve)。先读取当前修订号和待决冲突及其可选内容。

(
  set +x
  set -o pipefail
  : "${APPBASE_API_KEY:?Set APPBASE_API_KEY}"
: "${APPBASE_ENDPOINT:?Set APPBASE_ENDPOINT to the target API endpoint including /v1}"
APPBASE_ENDPOINT="${APPBASE_ENDPOINT%/}"
builtin printf 'X-Appwrite-Key: %s\n' "$APPBASE_API_KEY" | curl --disable -X POST "${APPBASE_ENDPOINT}/knowledgebases/kb_enterprise_support/wiki/conflicts/oceanbase-vector-index-troubleshooting/resolve" \
  -H "X-Appwrite-Project: enterprise-ai-hub-210" \
  --header @- \
  -H "Content-Type: application/json" \
  -d '{
    "contentRevision": 4,
    "resolvedConflictId": "<pending-conflict-id>",
    "resolvedConflictOptionText": "<selected-option-text>"
  }'
)

破坏性重置整个知识库的 Wiki 页面、修订历史与冲突单(必须传入确认口令 reset:wiki)。这是破坏性操作,仅在确认目标与影响后单独执行。

(
  set +x
  set -o pipefail
  : "${APPBASE_API_KEY:?Set APPBASE_API_KEY}"
: "${APPBASE_ENDPOINT:?Set APPBASE_ENDPOINT to the target API endpoint including /v1}"
APPBASE_ENDPOINT="${APPBASE_ENDPOINT%/}"
builtin printf 'X-Appwrite-Key: %s\n' "$APPBASE_API_KEY" | curl --disable -X POST "${APPBASE_ENDPOINT}/knowledgebases/kb_enterprise_support/wiki/reset" \
  -H "X-Appwrite-Project: enterprise-ai-hub-210" \
  --header @- \
  -H "Content-Type: application/json" \
  -d '{
    "confirmation": "reset:wiki",
    "idempotencyKey": "<unique-reset-operation-id>"
  }'
)

知识索引(Indexes)

Indexes 页签集中管理三类派生索引:GraphRAG、RAPTOR 与 LLM Wiki。

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

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

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

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

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

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

Graph(图谱)

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

Wiki

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

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

使用边界

常见问题与排障(FAQ)

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

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

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

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


相关文档

页面容量、引用定位与安全过期

Wiki 的实体、主题和综述页数不再固定受 200 / 64 / 100 的产品上限限制;使用设置中保存的值,部署方另设的硬天花板仍优先。目录类别超过 200 条时按“部分 x/n”续段展示,标题保留完整数量。调整配置后重新构建并核对页数,配置保存不表示构建完成。

有唯一来源证据的正文引用显示为数字角标,点击或键盘聚焦后按 Enter,可展开并定位下方证据。同一来源复用同一编号;未能确定来源的标记保留原样。切换页面后重新核对当前页的证据,代码块与已有链接不转换。

来源仅发生安全的文档/分块更新时,上次成功 Wiki 可能继续可读和可检索,但会显示过期与重建提示。这不表示包含最新来源。来源删除、禁用、配置/模型变化、快照损坏或版本不符时不适用。需要最新结果时重新构建,等索引恢复 ready 后再检查检索;不要把 hasWiki=false 简化为没有任何可读历史结果。