Knowledge Base
Create, search, and curate the Q&A pairs and document chunks that power your AI assistant's responses
The Knowledge Base is the central content store that powers your AI assistant's responses. It holds two types of items — Q&A pairs, which you author in the console or which the platform imports or generates from a file uploaded to a Q&A-type content pack, and document chunks that the platform extracts from uploaded files — and gives curators a unified workspace to search, filter, edit, rate, and govern every entry across the entire tenant.

The Knowledge Base page in Text Search mode, with the seeded Employee Handbook entries visible.
Key concepts
- Q&A pairs — questions and answers. Each pair has a question (what the user might ask) and an answer (what the assistant should respond with). Pairs reach the Knowledge Base by three routes: authored manually with Add Q&A, imported row-by-row from a CSV or XLSX file uploaded to a Q&A-type content pack, or generated by the platform from a PDF uploaded to a Q&A-type pack. Imported and generated pairs are created as Draft.
- Document chunks — when you upload a PDF to a document-type content pack, the system splits it into chunks. Each chunk contains a portion of the document together with the page numbers it came from. The same file uploaded to a Q&A-type pack produces Q&A pairs instead.
- Content packs — containers that group Q&A pairs or document chunks together. Every item belongs to a pack, and the pack decides which callers it can answer.
- Status workflow — items move through statuses that control visibility: Draft (hidden from users), Approved (live), Needs Attention (flagged for review), and Discarded (soft-deleted). Only Approved items are retrievable, so a new Q&A — which starts as Draft — is invisible to the assistant until you approve it.
- Vector index — Q&A pairs and document chunks are embedded as they are written, so there is nothing to rebuild and no reindex to schedule: a curator's change is searchable as soon as it saves. Every search is scoped to your tenant.
Search modes
The toolbar exposes two search modes via a toggle on the left of the search field. Switch between them by clicking the magnifying-glass icon (Text Search) or the sparkles icon (AI Search).
![]()
The search-mode toggle sits to the left of the search field, with Filters and Add Q&A to its right.
Text Search
Text Search is the default mode. As you type in the search field, results filter in real time across the question, answer, title, section heading, chunk content and tag fields — typing part of a tag finds every item whose tag contains it. Combine it with the Filters popover to narrow by tag, item type, status, sensitivity, and rating, and to change the sort order.
Each active filter appears as a chip beneath the toolbar, where you can clear it individually. Clear All, inside the Filters popover, resets every filter at once.
The search text, the filters, the sort order and the current page are kept in the page's URL, so reloading reopens the list you were looking at, and a filtered view can be shared as a link. Whoever opens the link sees the search text it carries. An AI Search query is not kept in the URL.
AI Search
AI Search runs a vector similarity search across the entire tenant knowledge base: your query is embedded and the nearest items are returned. Use it when you cannot remember the exact wording of an item, want to find paraphrased duplicates, or need to discover items by intent rather than by keyword.
It matches on meaning only — there is no keyword matching underneath it. An exact string such as a policy code, a part number or a person's name is what Text Search is for; a short identifier carries almost no meaning to embed, so AI Search is the wrong tool to look one up with.

AI Search returns ranked semantic matches with confidence labels, highlighting the full query phrase wherever it appears in a title or preview.
Each result card shows:
- A type badge (QnA or Document) with an icon
- A confidence chip combining the qualitative label (Low / Medium / High) and the normalized score percentage
- The current status of the underlying item
- For document chunks, the chunk position within the source file (
Chunk 3/12) - The title and content preview, with the full query phrase highlighted wherever it appears verbatim
The result list is sorted by score. The score is a cosine similarity between your query and the item, expressed as a percentage: it is a measure of closeness in meaning, not a percentage of correctness, and unrelated text still scores around 50%. The colored bar on the left of every card mirrors the confidence level so you can scan a busy result set quickly.
AI Search finds items in every status — Draft, Needs Attention and Discarded as well as Approved — so you can use it to review unapproved content by meaning. Each card's status badge says which it is. Only Approved items answer questions, so a match here is not necessarily one the assistant can use.
Running an AI Search
Switch to AI Search
Click the sparkles icon in the search-mode toggle. The query field updates to the AI Search variant with a "Search semantically across the entire knowledge base" placeholder.
Type a natural-language query
Enter a question, paraphrase, or topic — anything from a single keyword to a full sentence. Queries are limited to 500 characters: the field does not stop you typing past that, but a longer one is refused when you run it.
Run the search
Press Enter or click the arrow button on the right of the field. A loading indicator replaces the arrow while the search runs; the response usually arrives within a couple of seconds.
Open a result
Click any Q&A card to open it in the details modal where you can edit, change status, or review history.
Document chunk hits are read-only in the result list. Each says Preview only, and clicking one opens nothing. To edit the underlying chunk, switch to Text Search and find the parent document.
Advanced filters
Click Filters in the toolbar to open the filter panel. The panel opens in both search modes, and in AI Search it offers only the filters AI Search applies — see the note below.

The panel in Text Search. In AI Search it offers only Type, Status and Sensitivity.
| Filter | Options |
|---|---|
| Tags | Multi-select from the tags your Q&A pairs carry. Matches items carrying any of the selected tags, whatever their letter case. Q&A pairs only |
| Type | All, QnA, Document |
| Status | All, Approved, Needs Attention, Draft, Discarded |
| Sensitivity | All, Public, Standard, Sensitive, Secret. Q&A pairs only |
| Rating | All, 5 stars through 1 star. Matches items rated exactly that number of stars — a "4★" filter does not include 5★ items. Q&A pairs only |
| Sort | Relevance, Newest, Oldest. "Relevance" sorts by most-recently-updated, identical to "Newest" |
AI Search applies Type, Status and Sensitivity. In AI Search the Filters popover offers only those three. Tags, Rating and Sort, and their chips, are hidden there, and apply again when you switch back to Text Search; Clear All in AI Search resets only the three it shows. Changing Type, Status or Sensitivity after a query has run runs it again under the new filter.
Status narrows AI Search to the status you pick: filter by Draft, for instance, to find unapproved Q&As by meaning.
Sensitivity is a Q&A pair's alone, so any Sensitivity leaves document chunks out of AI Search as it does in Text Search. It is applied to the closest matches AI Search found, so a narrow one can return fewer results, or none, while matching items of that sensitivity rank further down.
Tags, Sensitivity and Rating apply to Q&A pairs only. In Text Search, selecting any of them narrows the result set to Q&As — every document chunk is excluded, even when Item Type is set to All, because chunks carry no tags, sensitivity or rating, and their cards show none. Combining one of them with Item Type = Document therefore always returns an empty result set.
"Relevance" is not a relevance ranking. In Text Search it sorts by most-recently-updated, exactly like "Newest": text results are ordered by date and never scored for relevance. Only AI Search ranks results by semantic relevance, which is why it offers no Sort.
The tags offered are the ones your Q&A pairs carry, read again each time the Filters popover opens, so a tag you add to a Q&A is offered as soon as you save it. A tag no longer on any Q&A stops being offered.
Creating a Q&A item
Open the Add Dialog
Click Add Q&A in the top-right corner of the Knowledge Base page.

A pair saved here starts as Draft and is invisible to the assistant until you approve it. Create stays disabled until the question, the answer and a content pack are all given.
Enter the Question and Answer
Type the question your users might ask in the Question field and the response the assistant should provide in the Answer field. Both fields are required.
Select a Content Pack
Choose a content pack from the Content Pack dropdown. Only Q&A-type packs appear in this list, and one is required: a Q&A answers only the callers with access to its pack. If your tenant has no Q&A-type pack yet, click Create a Q&A pack under the dropdown: it opens Add Knowledge Pack with Q&A selected, and the pack you create there is chosen for this pair, with the question and answer you typed kept. A pair's details offer the same link while your tenant has no Q&A-type pack.
Create the Item
Click Create. The item is saved with Draft status. A success notification appears and the dialog closes automatically.
The item does not answer questions yet. The assistant uses only Approved items, so it cannot use a draft. Open the new item, click Approve, then click Save changes to publish it. In the details modal the quick-action buttons only stage the status change (the footer shows "You have unsaved changes"); closing the modal before you save asks whether to keep editing or discard it. To publish in one click instead, use the card's three-dot menu — that writes the change immediately.
Write questions in natural language that matches how your users actually ask. For example, use "How do I request time off?" rather than "Time Off Request Procedure."
Viewing and editing items
Click any card — a Q&A pair or a document chunk — to open the details modal. The modal exposes two tabs at the top:
- Details — the editable view with status and sensitivity badges, quick-action buttons (Approve, Flag for Attention, Discard), inline-editable question and answer fields, a Q&A pair's Content Pack, rating, tags, and metadata. Choose another Q&A-type pack and click Save changes to move the pair. A pair moved out of the pack its file was uploaded to no longer belongs to that file: removing or re-processing the file leaves it in place. A pair saved before a pack was required has none and answers no one: its card says No content pack, and it saves again only once you choose one here. A pair's question and answer may not be left blank: either one cleared says it is required and holds Save changes.
- History — a chronological list of every prior version. The Compare button (enabled once two or more versions exist) opens a side-by-side diff view where you can pick a base version and a comparison target to inspect exactly what changed and who changed it.
For document chunks, the modal includes chunk navigation buttons (Previous / Next) to step through all chunks from the same source file, with a "Chunk N of Total" indicator.
Save your changes before navigating between chunks: the Previous / Next buttons are disabled while you have unsaved edits. Switching tabs is not blocked, so it is possible to move from Details to History with unsaved edits still pending — save first.
Changing an item's status
There are two ways to move an item through the workflow:
- From the card — open the three-dot menu on any card (Q&A pairs and document chunks both have one) and choose Approve, Discard, or Flag as Needs Attention. The change saves immediately. A pair in no content pack offers none of these until it is put in one.
- From the details modal — open the item and use the quick-action buttons (Approve, Flag for Attention, Discard). These buttons only stage the new status in the open modal; you must click Save changes to persist it. If you close the modal without saving, you are asked first: Keep editing keeps the staged status change, and Discard changes drops it.
Approving is what publishes an item: the assistant answers only from Approved items, so it cannot retrieve a draft until the item is approved and the change is saved.
Deleting an item
Open the item's details modal, click Delete at the bottom-left, and confirm. The item stops being retrieved at once and cannot be restored. This is a hard delete, distinct from the Discarded status, which only hides the item from users and can be reversed.
Reviewing ingestion runs
Edits you make here take effect when you save them — there is nothing to rebuild afterwards. To see what the platform ingested from an uploaded file, and how much knowledge came out of it, click Processing History in the toolbar; the page is described under Knowledge Packs.
Uploading files
Files are uploaded through Knowledge Packs. What the platform produces from a file depends on the type of the pack you upload it to.
Uploading to a document-type pack
When you upload a file to a document-type knowledge pack, the system automatically:
- Extracts the PDF's text layer — the only document format a document-type pack accepts.
- Splits the text into overlapping chunks, each carrying the page numbers it came from.
- Creates individual document chunk items in the Knowledge Base, each created Approved.
Each chunk can then be reviewed, edited, approved, or discarded independently.
Uploading to a Q&A-type pack
A file uploaded to a Q&A-type pack becomes Q&A pairs, not document chunks. There are two paths:
- CSV or XLSX — imported directly, row by row, into question/answer pairs. Document parsing is skipped entirely. Both formats are accepted by Q&A-type packs only. A row missing its question, its answer or its second column is left out and the rest imported; the file's row in the pack says how many were left out, and why for the first five. A file none of whose rows can be imported fails, naming its first such row and why.
- PDF — parsed and chunked like a document, after which the platform generates Q&A pairs from the chunks.
Both paths create the pairs with Draft status, so nothing they produce is retrievable until you review and approve it.
There is a size ceiling of 100 MB per file, refused before the transfer starts. A second ceiling applies after parsing: a source that yields more than 10,000 items — chunks or Q&A pairs — fails at that point, so a large, text-dense PDF can upload successfully and then fail during processing. A CSV or XLSX file is held to it as it is read: it fails at its first row past 10,000 that holds a question or an answer, a header row aside, or once its pairs hold more than about 32 MB of text, less when the text holds emoji. An XLSX file also fails when reading it takes more than 30 seconds of processing time, or far more memory than 10,000 rows of text need. Document-type packs accept PDF only; Q&A-type packs accept PDF, CSV and XLSX.
Field reference
Q&A item fields
| Field | Description | Required |
|---|---|---|
| Question | The question users might ask | Yes |
| Answer | The response the assistant provides | Yes |
| Content Pack | Which collection this item belongs to, and so which callers it can answer. Changed from the item's details | Yes |
| Status | Controls visibility: Approved (live), Draft (hidden), Needs Attention (flagged), Discarded (removed). New Q&As start as Draft and answer nothing until approved | Set on create |
| Sensitivity | A classification label: Public, Standard, Sensitive, or Secret. Text Search and AI Search can filter by it. It does not restrict who is answered from the item | No (defaults to Public) |
| Rating | Curator quality assessment from 1 to 5 stars | No (defaults to 0) |
| Tags | Categorization labels. The item's editor offers every tag your Q&A pairs already carry and accepts a new one typed in; once saved, the new tag is offered on every Q&A and in the Filters popover | No |
Sensitivity is a label, not access control. Marking an item Sensitive or Secret does not change who is answered from it: once approved, it can answer every caller with access to its knowledge pack. To keep an item from some callers, put it in a knowledge pack they have no access to — see How access control works.
Document chunk fields
| Field | Description | Editable |
|---|---|---|
| Title | Document filename (without extension) | Yes |
| Content | The text content of this chunk | Yes |
| Chunk Index | Position within the source document (e.g., Chunk 3 of 12) | No |
| Status | Same status workflow as Q&A items. Chunks are created Approved | Yes |
Page numbers are captured during parsing and kept on the record, but the console does not display them today. Chunks carry no section heading: text extraction yields the page's text, not the document's structure.
AI Search result fields
| Field | Description |
|---|---|
| Type | QnA or Document — controls which icon and color the badge uses |
| Confidence | Normalized score from 0 to 100% with a qualitative label (Low / Medium / High) |
| Status | Current lifecycle status of the underlying item |
| Chunk position | For document hits, the chunk index and total count from the source file |
| Title | The Q&A question or the document title, with the query highlighted where it appears as a whole phrase |
| Preview | The first ~3 lines of the answer or chunk content, with the query highlighted where it appears as a whole phrase |
Related pages
- Knowledge Packs — create content pack containers and upload documents
- Guardrails — set safety policies that evaluate user input
- Conversation Logs — see how the assistant uses knowledge items in responses
- Confidence Thresholds — tune the minimum scores the runtime accepts before answering from a knowledge item
Content Management
Manage knowledge bases, knowledge packs, and guardrail policies for your AI assistant
Knowledge Packs
Organize knowledge base content into collections with file uploads, content type selection, the organizations whose agents may search them, processing history, and bulk status management