# Knowledge base

> Manage the sources, documents and tags behind every Unifuse answer, upload documents for review, test what a source can answer, and read how the assistant cites and abstains.

Source: https://docs.unifuse.ai/enrollment/knowledge-base/

The knowledge base is the single library the assistant answers from, in the AI Front Door,
in student conversations and on the Knowledge Base page itself. Documents come in through
connected sources and uploads and are organised by tags. It is under **Enrollment →
Knowledge Base**; **Student Success → Knowledge Base** shows the same library filtered to
Student Success content.

## Before you start

- You need *view kb* to read and ask. Uploading, tagging, syncing and deleting need *manage
  kb* (Admin only by default).

## Data sources

Source cards show document and chunk counts and the last error, if any. The **Explorer** tree
and **Search documents by title** find individual documents; the **Tags** panel lists tags
and lets an administrator add or delete them. **Add a Source** opens
[Integrations](/integrations/overview/).

Select a source to open its drawer: document, chunk and token counts; **Last crawl** with
**Sync in background**; **Test this source**, which asks a question the source should be
able to answer; and, for web sources, the page inventory with **Excluded paths**.

Select a document to see its tags (attach or detach), its indexed chunks, and **Delete**.

## Upload a document

**Upload Document** accepts PDF, text, PNG and JPEG files up to 15 MiB. Every file is
checked against its declared type and virus-scanned, and is stored encrypted. Scanned
documents and images need text recognition, which Unifuse enables per institution.

An upload does not enter the knowledge base until a reviewer with *manage kb* approves it
on the review queue. Uploaded documents are attached to the built-in **Manual Uploads**
source.

## Ask the knowledge base

The **Ask the knowledge base** tab takes a question across all documents, or within the
selected tags. The answer card shows:

- the answer;
- **Retrieval confidence** and the institution's **threshold**: confidence is how closely
  the best-matching passage matches the question;
- numbered **Sources** linking to the page or file;
- when confidence is below the threshold, the assistant abstains. It does not guess; it
  refers the user to the contact the institution has set, such as a student-services email.

Every question is logged. The abstain threshold and the fallback contact are set in the
Orchestration Hub's global configuration.

## Evaluation

Nightly evaluation runs ask the knowledge base a fixed set of questions and record which
passed, which newly fail, and results by category. The evaluation page is at
`/knowledge-base/evaluation`; **Run now** needs *manage kb*.

## Related

- [Connector catalogue](/integrations/connectors/)
- [The AI Front Door](/ai-assistant/front-door/)
