Knowledge bases
Document status
The steps a document goes through, the progress bar, stopping and re-indexing.
The Status column in the documents table moves through these steps in order:
| Status | What is happening |
|---|---|
pending | File received, waiting for a worker. |
parsing | Reading text, tables and pages out of the file. |
chunking | Splitting into passages with the chosen method. |
enriching | (If enabled) writing keywords / questions per passage. |
embedding | Turning passages into vectors and writing the index. |
summarising | (If Summary tree is on) building the summary passages. |
ready | Searchable and citable. |
failed | Stopped on an error — open the detail page for the reason. |
cancelled | You clicked Stop indexing. |
While processing, the row shows a progress bar and a line naming the current step.
Stop and re-index
Row menu (or the buttons on the detail page):
- Stop indexing — cancels the running work; nothing partial is used. Status becomes
cancelled. - Re-index — runs everything again, for example after changing the chunking method or turning on keywords. Parts that did not change (same content, same settings) are reused and cost nothing.
- Download original — get the original file back.
- Delete — removes the document and all its passages from the index. Needs
document.delete.
Common failures
| Message | Cause |
|---|---|
| No text in the PDF | A scanned PDF — see Upload documents. |
| The X method cannot read filename | The chunking method does not support this format. |
| A provider error | Check the Failures tab on Usage. |