Skip to content

Knowledge bases

This page complements Knowledge Bases in XTM One.

That guide explains what a knowledge base is for. This page gives you a quick tour of the knowledge base screens.

The list page

In the left navigation, this area is Knowledge. The list page is where you start: search by name or description, filter by visibility or tags, and compare existing collections before creating a new one so you avoid duplicate silos. Each card shows enough to judge a collection at a glance — what it is about, its visibility, and how much indexed content it holds. If you have permission, New Knowledge Base creates one from files, GitHub, Notion, or cloud storage.

The detail page

Opening a knowledge base shows a header with the name, its badges (System managed, Company-managed, Shared, Read-only), and a few actions that serve different purposes:

  • Test Search lets you judge answer quality before changing anything. It is disabled until the knowledge base has indexed content.
  • Re-embed is a maintenance action that refreshes the searchable index.
  • delete removes the whole knowledge base, not a single document.

The detail page is organized into tabs. Overview, Configuration, and Activity are always present; Documents and Import Sources appear for knowledge bases you populate yourself (Import Sources is hidden for system-managed ones).

Overview

Overview is the fastest way to understand the current state: how much content is indexed, how often it is queried, the embedding model, and which agents are bound to it.

Documents

Documents is the main content view — upload files, paste text, download, delete, and reprocess documents that are stuck or failed. Open it when your real question is whether the source content is actually present, whether ingestion failed, or whether an old file version is still indexed.

Each document keeps its original source text, not just the searchable chunks it was split into. That is what makes download return the file you put in, and it is also what agents read when they need a whole document rather than the fragments semantic search returns.

Import Sources

Import Sources manages automatic sync (website, Notion, OneDrive/SharePoint, Google Drive, GitHub, and more). It shows each source's schedule and last-sync status, so it is useful both for setup and for answering "why isn't the knowledge base up to date?". Some source types require a connected integration first; when that is missing, the option stays visible but disabled and the UI explains what is needed.

Configuration

Configuration covers the knowledge base's identity (name, description, tags), its visibility and sharing, and the Read-only content switch. System-managed knowledge bases stay read-only here.

Turn Read-only content on when a collection is ground truth — the authoritative version of something other work is checked against. A read-only knowledge base stays fully searchable, so agents keep using it for answers; what changes is that nothing can rewrite it. Agents lose write access to it even if an agent's configuration grants writing, its documents cannot be added, edited or deleted, and the knowledge base itself cannot be deleted until you turn the switch back off.

Two things deliberately keep working on a read-only knowledge base: configured Import Sources still refresh it, and Re-embed still works. That is so a collection whose authority lives in another system — a policy wiki, a specification repository — stays both locked against edits and up to date. To freeze such a knowledge base completely, disable its import sources as well.

Activity

Activity is the audit view — when content changed, whether a sync ran recently, and who edited the configuration. Check it when answer quality shifts. Document updated entries also cover agent write-backs: an agent with write access to a knowledge base can revise a stored document, which re-indexes it. The document shows pending until re-indexing finishes, so a document an agent just changed is briefly not searchable — that is expected, not a failure.

Badges that set expectations

  • System managed means the platform maintains the content automatically; Documents may be read-only and point you to Import Sources instead.
  • Content locked (Locked on the list page) means the knowledge base is marked read-only: searchable as usual, but nothing writes to it. This is about the content.
  • Company-managed plus Read-only means you can view it but not change it. This one is about permissions — who may administer the knowledge base — which is why a collection can carry both badges for different reasons.
  • Shared means the knowledge base belongs to a shared group rather than to one person.

Good habits

  • Start on Overview before editing anything.
  • Use Test Search before deciding a knowledge base is weak.
  • Check Documents when results look incomplete, and Import Sources when freshness is the issue.
  • Read the badges first — they explain why some actions are missing.
  • Mark authoritative collections Read-only rather than relying on each agent's configuration being right — the lock lives on the knowledge base, so it holds no matter what an agent is granted later.
  • Keep very large documents out of knowledge bases you expect agents to read whole. A document above roughly 200 000 characters is not loaded into an agent's context at all: the platform records it as a work item instead, and the agent is steered to search it for the relevant passages. Splitting it into meaningful documents usually works better than leaving one enormous file.