Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.neuralfactory.ai/llms.txt

Use this file to discover all available pages before exploring further.

Indexing Status

When documents are added to a knowledge base, they go through a processing pipeline before they become searchable. The indexing status lets you monitor this progress.

Processing states

Each document progresses through these states:
StateDescription
UploadedFile has been received and stored, awaiting processing
ProcessingContent is being extracted, split into chunks, and embedded
IndexedSuccessfully processed — the document is searchable by agents
FailedProcessing encountered an error (see troubleshooting below)

Monitoring progress

From the knowledge base detail page, you can see:
  • Overall progress — A summary of how many documents are indexed vs. pending
  • Per-document status — The current state of each individual document
  • Datasource sync status — For connected sources like SharePoint, the last sync time and result

Processing time

Processing time depends on several factors:
  • File size — Larger files take longer to process
  • File type — PDFs with complex layouts or scanned content take longer than plain text
  • Queue depth — If many documents are being processed simultaneously, individual documents may wait in the queue
  • Content complexity — Documents with tables, images, or mixed formatting require more processing
Typical processing times:
ScenarioExpected time
Small text file (< 1 MB)Seconds
Standard PDF (1–10 MB)10–60 seconds
Large document (10–50 MB)1–5 minutes
Bulk upload (100+ files)10–30 minutes

Troubleshooting failed documents

If a document shows Failed status:
  • Unsupported format — Ensure the file is in a supported format (PDF, DOCX, XLSX, TXT, PPTX, CSV)
  • Corrupted file — Try opening the file locally to verify it’s not corrupted
  • File too large — Check if the file exceeds your plan’s size limits
  • Extraction error — Some heavily formatted or encrypted PDFs may fail. Try converting to a simpler format.
You can retry a failed document by deleting it and re-uploading.