Skip to main content
Plexara

Knowledge Capture & Application

A correction someone makes in passing becomes documentation the whole organization holds. Captured during the conversation, reviewed by a person, written to the place that kind of fact belongs, and reversible if it turns out to be wrong.

Reach

What one person teaches, the whole team gets

The finance lead explains that a column is gross margin, not revenue. Normally that stays inside one conversation, and the next analyst re-derives it from the data and gets it wrong.

Promotion is what changes that. The moment a reviewer applies an insight, it stops being the capturer’s private note and becomes something every identity can find through the same search they already use, still attributed to the person who taught it. Nobody needs to know it exists, or who to ask.

Until then it stays private. An insight still waiting on review is visible only to whoever captured it, because a capture under review is not yet something the organization asserts.

A teammate who never saw the original conversation, answering correctly

46.7%→98.9%

Our lifecycle benchmark teaches a fact with one identity and then asks a different one. Moving the visibility boundary to the act of applying an insight took that from under half the time to near-total.

30 protocols, 95 transfer attempts on claude-sonnet-5; 95% CI 96.8 to 100.0. Measured on v1.102.0 and again on v1.118.0, so the comparison is across code rather than across samples.

Read the accuracy study

Capture

Three Sources of Knowledge

01

User-Provided Knowledge

"That column is gross margin, not revenue"

When a user corrects an agent during a conversation, the correction is captured as a structured insight with the specific entity, the type of correction, and the suggested catalog change. No separate tool needed.

02

Agent-Discovered Insights

"Column amt appears to be in cents based on value ranges"

When an agent queries data and observes patterns, these observations are captured as lower-confidence insights flagged for human review. The agent does the analytical work. Humans validate the conclusion.

03

Enrichment Gap Flags

"This table has no description and 12 undocumented columns"

When the semantic enrichment middleware finds missing metadata, the gap is recorded automatically. Over time, the gap log becomes a prioritized list of documentation debt ranked by access frequency.

The Insights tab of the Knowledge page with My Insights selected, showing Total, Pending, Approved, and Applied counters, a search box with status filters, and a list of captured insights each carrying a status badge, a category, the tables it references, and the reviewer's note
Whatever the source, a capture shows up here as an insight you can read back, with its status and the reviewer’s note once it has been decided.

Pipeline

The Review Pipeline

Nothing becomes shared knowledge without human approval. Review and promotion belong to whoever holds that capability, which your team assigns and which need not be an administrator.

1

Capture

Insight recorded with source, confidence level, entity reference, and suggested changes.

2

Review

A reviewer evaluates accuracy and relevance. Bulk or per-entity review workflows, with the whole queue enumerable rather than only searchable.

3

Synthesize

Related insights about the same subject are combined, and each proposed change is shown beside the value it would replace.

4

Apply

Approved knowledge is written to whichever of the two homes fits it, as a tracked changeset with full provenance.

The Insight Detail panel open over the review queue, listing who captured the insight, their persona, category, confidence, and status, the insight text, the entity URNs it references, a Suggested Actions table, Related Columns, a Review Notes field, and Approve and Reject buttons
A reviewer opens one insight and sees everything the decision rests on: the claim, what it references, what applying it would change, and a place to say why.

A pending insight is not judged in the abstract. The panel looks up the table the claim is about and reports what it finds right now, so the reviewer decides against the data as it stands rather than as the capturer remembered it.

An Insight Detail panel for a pending business-context insight about a daily sales table, with an Observed Now card confirming the table is queryable now and reporting its current row estimate, followed by entity URNs and a suggested column description update
Observed. The table is reachable and its current row estimate is shown, so the reviewer can see the claim and the data side by side.
An Insight Detail panel for a pending correction claiming an inventory table holds 1,140 rows, where the Observed Now card shows a current estimate of about 1,200 rows and an amber warning that the claim disagrees with the table, marked advisory only
Conflict. The claim names a figure the table no longer matches, so the panel says so in place. It is advisory: the decision still belongs to the reviewer.
An Insight Detail panel for a pending enhancement about a product catalog table, where the Observed Now card confirms the table is queryable now but notes that this connection does not estimate row counts
No estimate. The table is reachable but its connection does not report row counts, and the panel says that plainly instead of leaving a blank.

Two Homes

Where a Promoted Fact Lands

Not every fact belongs on a table. Promotion routes each one to the place it can be found from: business and domain knowledge becomes a page, technical and entity knowledge goes to the catalog. The reviewer picks the destination at promotion time, and one search covers both.

Canonical knowledge pages

Business and domain facts

Durable, human-readable pages written in formatted text with diagrams, version-tracked on every save, searchable by meaning, and open to feedback in place. They hold the vocabulary, definitions, runbooks, and context that do not fit inside the metadata on a single table.

  • How the fiscal calendar differs from the calendar year
  • What counts toward net revenue and what does not
  • The runbook for a month-end close that spans six systems

The data catalog

Technical and entity facts

A fact that belongs to one table, column, dashboard, or glossary term is written where that entity already lives, so it arrives with the metadata every time anyone touches the entity. Descriptions, tags, glossary terms, quality flags, curated queries, and incidents are all reachable this way.

  • The amt column is in cents, not dollars
  • This extract is deprecated in favor of the modeled table
  • Rows before the March migration are in UTC
The Knowledge tab with Search All selected and the query revenue entered, returning grouped results from the catalog, knowledge pages, insights, and memory, with source filter chips above the groups and a count of how many matches each group shows
One search, grouped by where each match lives: catalog entries, knowledge pages, insights, and memory come back together.

Repeated promotions about the same subject consolidate into one living page rather than piling up beside each other, and when an agent tries to write a page that closely matches one that already exists, the platform steers it into updating that page instead. Canonical knowledge gets deeper over time instead of splintering into near-copies.

Structure

Knowledge Is Linked, Not Filed

A wiki asks you to remember where you put something. Knowledge in Plexara hangs off the things it describes, so it arrives when you are looking at them.

The result is a corpus with a shape you can inspect: the portal draws it as a reference network, sizes each node by how much of the graph it holds together, and traces the chain of references between any two things.

Pages cite what they are about

A page states the assets, prompts, collections, connections, catalog entries, glossary terms, tags, and domains it concerns. Each one renders as a live chip carrying the current name, not the identifier some system generated, and deep-links to where that thing is managed.

The link runs both ways

Standing on a glossary term, a tag, a domain, or a table, you see the knowledge written about it. A steward reading a definition finds the runbook that depends on it without knowing the runbook exists.

Access decides what you see

A reference to something you cannot reach is omitted from both directions, so you see the part of the corpus you are cleared for and nothing hinting at the rest.

Reversible

Every Promotion Can Be Undone

The objection to letting an agent contribute to your catalog is the obvious one: what happens when it is wrong. A person approves every promotion, every promotion records what it wrote over, and a bad one comes back out.

Every promotion is a changeset

Each run records exactly what it wrote and the values it wrote over, on both destinations. The changeset list sits with the promoted knowledge, showing what was applied, to what, by whom.

A changeset can be rolled back

Rolling one back restores what was there before and returns the source insights to the queue. A promotion that created a page removes it; one that revised a page restores the prior version. Reversibility is stated up front, before you apply, so you never learn at rollback time that a change could not be undone.

Nothing ages silently

The review queue reports how old its oldest pending item is and how much has aged past thirty days, and says so in the assistant, in the portal, and on the admin screens. When the backlog crosses the threshold your team sets, it emails a digest with a link straight into the queue.

Flywheel

Usage Improves the Platform

1

Usage generates insights

2

Insights improve documentation

3

Better documentation improves agent accuracy

4

Better accuracy drives more usage

This flywheel distinguishes knowledge application from one-time documentation initiatives. A documentation sprint produces a snapshot that begins decaying immediately. Knowledge application produces documentation that improves continuously because it is connected to ongoing data usage.

The rate of improvement is proportional to usage. Datasets queried frequently accumulate documentation faster. Columns discussed in conversations get descriptions sooner. Business terms explained to agents get linked to glossary entries. The documentation naturally prioritizes what matters most.

Over 15 change types are supported: update descriptions at entity and column level, add tags, add glossary terms, flag quality issues, add curated queries, raise incidents, add context documents, and create prompts. Works across datasets, dashboards, charts, data flows, containers, data products, domains, and glossary terms.

Next

Catalog Governance

Where promoted knowledge lands, and how your team curates the catalog around it.