Docs
Contents

Knowledge Base Wiki (Encyclopedia Compilation, Conflict Adjudication, and Memory Export)

Knowledge Base Wiki (LLM Wiki) is an innovative Agentbase v2.10.0 module that automatically distills, reorganizes, and compiles fragmented document chunks into a structured, human-readable, and continuously evolving enterprise encyclopedia knowledge system. Via the Wiki tab on the knowledge base detail page, the system can, based on ready (ready) document assets in the library (e.g., the 4 core technical specifications in kb_enterprise_support), automatically plan a global table-of-contents overview (kb-index) and compile multiple topical encyclopedia pages (e.g., the 10 structured encyclopedia section pages generated in production testing), while also providing page revision history and rollback, a cross-document knowledge conflict auto-detection and adjudication workbench (/wiki/conflicts), smart update suggestions (/wiki/proposals), a page reference relationship graph (/wiki/graph), and supports one-click export of high-value Wiki pages to the Memory Center (/wiki/pages/{slug}/export-to-memory) to consolidate them as agents' long-term memory.


Feature overview and core scenarios

During long-term operation of an enterprise knowledge base, documents uploaded by different departments often exhibit two prominent problems: first, knowledge is scattered across dozens of fragmented documents, making it difficult for new employees and agents to build a global structured understanding; second, manuals written in different periods may contain conflicting parameters or procedures (for example, an old document states "the support ticket escalation time limit is 30 minutes" while the new SOP states "P1 tickets must be escalated within 15 minutes"), causing RAG retrieval to retrieve contradictory evidence simultaneously.

Agentbase's Knowledge Base Wiki thoroughly resolves the above pain points through five core mechanisms:

  1. Fully automatic encyclopedia outline planning and multi-type page compilation:

    • After enabling the LLM Wiki index capability and triggering a build, the large language model (e.g., qwen-plus) automatically reads through all chunks in the library, generating a top-level overview entry page (with the Slug fixed to kb-index) and topic-organized topical section pages (e.g., in kb_enterprise_support it automatically compiles 10 encyclopedia pages covering platform architecture, customer service SOPs, OceanBase vector troubleshooting, and AI gateway governance).

    • Pages are classified by semantic type as Document Overview (Index), Section, Document, and Memory, with support for type-specific generation prompts.

  2. Versioned online collaborative editing and one-click restore (Revisions & Rollback):

    • Knowledge operators can not only create or manually polish any Wiki page online; the system also generates tamper-proof revision records (Revisions) for every AI compilation or manual save, supporting diff comparison at any time and one-click restore to any historical version.

  3. Cross-document knowledge conflict workbench (Conflict Workbench):

    • During Wiki compilation and incremental updates, the engine automatically identifies contradictions between different source documents or chunks in values, rules, and process definitions, generating structured conflict entries that enter the Conflict Workbench (/wiki/conflicts), where domain experts can filter by documentTag / subProductId and adjudicate (Resolve) each entry one by one.

  4. AI update suggestions (Proposals) and link relationship graph (Wiki Graph):

    • When underlying documents are updated, the system generates non-destructive update suggestions (Proposals) for affected Wiki pages, and administrators can choose to accept (Accept) or dismiss (Dismiss) them.

    • The built-in Wiki Graph visually displays the topology of bidirectional reference links (Backlinks & Outbound Links) between encyclopedia pages.

  5. One-click export to the Memory Center (Export to Memory):

    • Supports one-click export of authoritative Wiki pages that have undergone manual review or conflict adjudication to the project's Memory Center (Memory), directly converting them into long-term domain memory that agents can retrieve on demand across sessions.


Core Concepts and Architecture

Architecture Diagram of the Knowledge Base Wiki Compilation, Conflict Adjudication, and Memory Export Loop

Knowledge Base Wiki (Encyclopedia Compilation, Conflict Adjudication, and Memory Export): workflow diagram, not a runtime screenshot

Flow diagram, not a runtime screenshot; read the relationships between steps or states along the arrows.

View the flow diagram in full size

Table of Wiki Core Objects and Interfaces

Core ObjectKey Identifier / Route PathDetailed Description
Overview Home Pageslug = "kb-index"The root entry page automatically generated by Knowledge Base Wiki compilation, summarizing the core domain architecture, module breakdown, and sub-page navigation links of the entire knowledge base.
Topical Encyclopedia Page/wiki/pages/{slug}A structured Markdown encyclopedia page generated by aggregating evidence from multiple source documents by topic (e.g., the 10 pages compiled in kb_enterprise_support).
Page Revision History/wiki/pages/{slug}/revisionsRecords all version snapshots of a page since its creation (including version number, editor/compilation task ID, timestamp, and body snapshot), with restore by version.
Page Reference Graph/wiki/graphDescribes the directed graph structure of Wiki pages referencing each other via internal links (Nodes are pages, Edges are reference relationships).
AI Update Suggestion/wiki/proposalsA suggestion of incremental content that can be added to an existing Wiki page, discovered when new documents are ingested or recompilation occurs; supports accept (accept and generate a new revision) or dismiss (dismiss).
Knowledge Conflict Ticket/wiki/conflictsA cross-document factual contradiction or outdated definition detected by the compiler. Unresolved severe conflicts are not only highlighted in the Conflict Workbench but also closely verified during the readiness check for version sealing (Seal).
Export to Memory/wiki/pages/{slug}/export-to-memorySynchronizes the structured content of a specified Wiki page into the project's Memory service, converting the knowledge base's static encyclopedia into the agent's dynamic memory.

Feature Entrypoints and Permission Matrix

Console Entry Points, REST API, SDK Methods, and Permission Matrix

Console entrypoint / feature moduleFrontend route pathCorresponding REST API endpointServer SDK method (Node.js / Python)Required RBAC role / API Key scopeCross-module dependency
Wiki Page Section Tree and Body Browsing/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()
Roles: owner, admin, developer, member (read-only)
Scope: knowledgebases.read
Depends on the Advanced Index Build wiki capability being enabled and compilation completed
Online Markdown Editing with contentRevision Optimistic Lock Save"Edit" and "Create page" at the top right of a Wiki pagePOST /v1/knowledgebases/{kbId}/wiki/pages
PATCH /v1/knowledgebases/{kbId}/wiki/pages/{slug}
knowledgeBase.createWikiPage()
knowledgeBase.updateWikiPage()
Roles: owner, admin, developer
Scope: knowledgebases.write
Uses contentRevision (Compare-And-Swap, CAS) to prevent concurrent multi-user edit overwrites
Page Revision History and One-Click Rollback"Revisions" drawer at the top right of a Wiki pageGET /v1/knowledgebases/{kbId}/wiki/pages/{slug}/revisions
POST .../revisions/{revisionId}/restore
knowledgeBase.listWikiPageRevisions()
knowledgeBase.restoreWikiPageRevision()
Roles: owner, admin, developer
Scope: knowledgebases.write
Every AI compilation, proposal merge, or manual save generates an immutable revision snapshot
Cross-Document Knowledge Conflict Detection and Adjudication/console/.../kb-kb_enterprise_support/wiki ("Conflicts" sub-view of the Conflict Workbench)GET /v1/knowledgebases/{kbId}/wiki/conflicts
POST /v1/knowledgebases/{kbId}/wiki/conflicts/{conflictId}/resolve
knowledgeBase.listWikiConflicts()
knowledgeBase.resolveWikiConflict()
Roles: owner, admin, developer
Scope: knowledgebases.write
Unresolved conflicts block the ready seal (Seal) gate of Version Management (Versions)
Incremental Update Suggestion (Proposals) Review/console/.../kb-kb_enterprise_support/wiki ("Proposals" sub-view of Update Suggestions)GET /v1/knowledgebases/{kbId}/wiki/proposals
POST .../proposals/{id}/accept & dismiss
knowledgeBase.listWikiProposals()
knowledgeBase.acceptWikiProposal()
Roles: owner, admin, developer
Scope: knowledgebases.write
After incremental documents are ingested, non-destructive proposals suggest merging into existing pages
Wiki Page Reference Topology Graph (Wiki Graph)/console/.../kb-kb_enterprise_support/wiki ("Wiki Graph" sub-view of the Link Graph)GET /v1/knowledgebases/{kbId}/wiki/graphknowledgeBase.getWikiGraph() / get_wiki_graph()Roles: owner, admin, developer, member
Scope: knowledgebases.read
Displays the internal bidirectional reference network within [[slug]] (see Knowledge Graph for the entity-relationship graph)
One-Click Export to the Memory Center (Memory)"Export to Memory" at the top right of a Wiki pagePOST /v1/knowledgebases/{kbId}/wiki/pages/{slug}/export-to-memoryknowledgeBase.exportWikiPageToMemory()Roles: owner, admin, developer
Scope: knowledgebases.write + memories.write
Requires the project to have enabled the memory capability in the Memory Center (Memory)
Destructive Wiki Reset (reset:wiki)"Reset Wiki" in the Wiki settings menuPOST /v1/knowledgebases/{kbId}/wiki/reset (confirmation passphrase reset:wiki)knowledgeBase.resetWiki()Roles: owner and admin only
Scope: knowledgebases.write
Completely clears all Wiki pages, revision history, proposals, and conflict tickets

Feature Details and Operation Guide

One. Browsing and Editing the Automatically Compiled Wiki Section Tree (10 Encyclopedia Pages)

After kb_enterprise_support completes the Wiki index build, enter the Wiki tab to see the complete encyclopedia knowledge workspace:

  1. Left-side Section Navigation Tree (Page Tree):

    • The top level is fixed as kb-index (Enterprise Intelligent Customer Service and Technical Support Knowledge Overview), below which the remaining 9 automatically compiled topical pages expand by logical hierarchy (10 Wiki pages in total), covering:

      • Overall platform architecture and Shared V2 storage mode overview

      • Intelligent customer service first-line/second-line support ticket flow and escalation SOP specifications

      • Detailed explanation of the OceanBase distributed transaction two-phase commit (2PC) mechanism

      • OceanBase vector index build and -4013 memory troubleshooting manual

      • AI gateway logical model routing, guardrails, and semantic cache billing specifications, etc.

  2. Online Editing and Creating New Pages:

    • Click the Edit button at the top right of any page to use the Markdown editor to adjust the body structure and add internal page reference links; saving automatically generates a new revision version number.

    • Click Create page at the top of the left directory tree, select the page type (Chapter / Document / Document overview / Memory), and fill in the title and a unique slug to manually add a wiki entry.

  3. View revision history and one-click restore:

    • Click Revisions at the top right of the page, review past revision records in the drawer, and click Restore next to any historical version to safely roll back.


Two. Reviewing update proposals (Proposals) and adjudicating knowledge conflicts (Conflicts)

In the top switcher bar of the Wiki tab, besides the default Pages and Wiki Graph views, two governance sub-views are also provided: Proposals and Conflicts:

1. Handling update proposals (/wiki/proposals)

  1. Switch to the Proposals sub-view. The list shows incremental paragraph changes that the AI compiler suggests merging into existing Wiki pages after the underlying documents are added or revised.

  2. Click a single proposal to view the Diff Preview and the source document chunking rationale:

    • If the content is accurate, click Accept; the system automatically merges the proposed content into the target Wiki page and generates a new version;

    • If it should not be merged, click Dismiss to archive the proposal.

2. Adjudicating cross-document contradictions in the Conflicts workbench (/wiki/conflicts)

  1. Switch to the Conflicts sub-view (you can filter conflicts for a specific sub-product by documentTag or subProductId).

  2. Each conflict record clearly lists:

    • Conflict topic description: e.g., two documents describe the same alert threshold inconsistently;

    • Evidence source A and evidence source B: the two contradictory source document chunks displayed side by side, along with their respective upload times and documentTag;

  3. Choose the authoritative wording or enter a merged standard formulation, then click Resolve Conflict. The adjudication result is synchronized to the corresponding Wiki page and removes the conflict blocker from the version seal (Seal) gate.


Three. One-click export of Wiki pages to the Memory center (Export to Memory)

For core encyclopedia pages that have passed team review (such as "Frontline/Second-line Support Ticket Routing and Escalation SOP Standards" or "OceanBase Vector Index Troubleshooting Quick Reference"), you can consolidate them into the project memory center through the following steps:

  1. Select the target page in the Wiki page tree (e.g., slug as oceanbase-vector-index-troubleshooting).

  2. Click the Export to Memory button in the action bar at the top right of the page.

  3. In the confirmation dialog, select or enter the target memory scope (such as project public-domain memory or a specific user/Agent scope), then click Confirm export.

  4. The corresponding REST API operation command set is as follows:

# 1. Get the list of compiled knowledge base Wiki pages (10 pages in total, including 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. View the citation link topology graph between Wiki pages
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. Query the list of pending Wiki knowledge conflicts (supports filtering by subProductId or 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. Export the specified Wiki page to the project memory hub (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"
    }
  }'

Four. Four page compilation templates, contentRevision CAS concurrency control, and the reset:wiki reset mechanism

1. Four structured Wiki page types (Index / Section / Document / Memory)

The LLM Wiki compiler does not simply concatenate documents; it organizes the wiki knowledge system across four semantic tiers (each type can be given a dedicated prompt in the LLM Wiki configuration of advanced knowledge index build governance):

Page type (pageType)Typical slug exampleCore responsibilities and structural characteristics
Document overview (Index)kb-indexGlobally unique root entry page. Automatically distills the domain landscape of the entire library, the core sub-product navigation tree, and high-frequency troubleshooting entry links.
Chapter (Section)oceanbase-vector-index-troubleshootingAggregates the same topic across multiple source documents (e.g., the vector index chapters in a comprehensive whitepaper, troubleshooting guide, and SOP), containing bidirectional internal links [[slug]] and chunk references.
Document (Document)doc-ai-gateway-routing-specA structured distilled wiki page generated for a single core specification document, retaining the complete parameter tables and architecture highlights.
Memory (Memory)mem-p1-incident-escalation-rulesDistills concise, tightly constrained atomic rules and standard SOP entries for one-click export to the Memory center, where agents can retrieve them over the long term.

2. Markdown online editing and contentRevision CAS optimistic lock protection

When multiple domain experts simultaneously polish the same Wiki page online, or when manual editing and background proposal merging (Accept Proposal) occur concurrently, Agentbase uses the contentRevision (Compare-And-Swap, CAS) mechanism to guarantee zero data loss from overwrites:

3. Destructive reset operation (reset:wiki) and advanced index linkage

# 1. Update the specified Wiki page with a contentRevision CAS optimistic lock (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. Adjudicate and resolve cross-document knowledge conflicts (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. Destructively reset the entire knowledge base's Wiki pages, revision history, and conflict records (the confirmation passphrase reset:wiki is required)
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"
  }'

Knowledge Indexes (Indexes)

The Indexes tab centrally manages three types of derived indexes: GraphRAG, RAPTOR, and LLM Wiki.

For the first build, operate in the order “select index → enable and configure → start build → view task → check artifacts”:

  1. In Indexes, select the index capability you want to use. Capabilities that are not enabled will not produce corresponding artifacts.

  2. Set the output language and prompts according to your purpose; before starting a build, confirm that the required model providers are available.

  3. After starting a build, check status and logs under Recent tasks; on failure, read the logs before deciding to retry, and avoid starting duplicate builds for tasks still running.

  4. After the GraphRAG build completes, view the Graph; after the LLM Wiki build completes, view the Wiki pages and link graph. RAPTOR is a derived index capability and is not equivalent to Wiki pages.

Raw documents and chunks are inputs; derived indexes are rebuildable artifacts. Clearing an index does not delete raw documents. Wiki Reset deletes the Wiki pages themselves; before operating, confirm this is the intended behavior.

Graph

The Graph tab browses GraphRAG artifacts: a visual graph of entities, relations, and community reports. This tab requires the GraphRAG index to be enabled and built (the deployment must have the GraphRAG capability).

Wiki

The Wiki tab organizes knowledge base content into encyclopedia-style pages:

CapabilityDescription
Page managementWiki page list, create page, page details and editing; pages retain revision history, allowing you to view revision records and restore historical versions
Link graphWiki Graph displays reference link relationships between pages
Update proposalsThe system provides update proposals for Wiki pages, to be accepted or dismissed one by one
Conflict adjudicationKnowledge conflicts enter the Conflicts workbench and are adjudicated and resolved one by one
Page typesWiki pages are organized by type (Chapter / Document / Document overview / Memory), each type configurable with independent custom prompts
Export to MemoryWiki pages can be one-click exported to Memory, persisting as Agent long-term memory (see memory)

Usage boundaries

FAQ (Frequently Asked Questions and Troubleshooting)

Q1: What is the essential difference between clearing the Wiki index on the “Knowledge Indexes (Indexes)” tab and performing the “Reset (reset:wiki)” on the Wiki tab?

Q2: Why does clicking the “Export to Memory” button show a message that the memory service is not enabled (412 Precondition Failed or a service-disabled notice)?

Q3: How can automatically compiled Wiki pages follow our enterprise's specific writing style or chapter template?

Q4: What should I do when multiple people edit the same Wiki page simultaneously and an error 409 Conflict (contentRevision mismatch) occurs?