Docs/Knowledge Base (RAG)

Knowledge Base (RAG)

Upload text or files when creating or editing an NPC. Mistscale splits the content into chunks, embeds them, and retrieves the relevant pieces every time the NPC speaks, so answers stay grounded in your canonical lore.

Upload text or a file when creating or editing an NPC. The platform splits it into chunks, embeds them, and retrieves the relevant pieces every time the NPC speaks.

How an upload progresses

Each uploaded file passes through these statuses, visible as a colored badge next to the file in the NPC editor:

pending
File received, waiting in the processing queue.
processing
Being chunked and embedded. Usually completes within seconds to a minute.
ready
Indexed. The NPC draws from it on the next reply.
failed
Processing failed. Delete and re-upload.

Limits

  • Your plan sets the number of files per NPC and the maximum file size (on Free: 3 files per NPC, 2 MB each).
  • Accepted file types: .txt, .md and .pdf.
  • Text or single-file uploads. No bulk import in the current UI.
  • Deleting a file removes both the original and every embedded chunk derived from it.
What makes a good knowledge file
Self-contained, narrative or factual prose works best. Lore documents, character bibles, location descriptions, in-world manuals. Short headings (for example a markdown "# The Lantern Inn") help: each section is indexed with its heading, so answers stay tied to the right place or person. Avoid raw spreadsheets, code, or fragmented bullet dumps. They index poorly and produce shallow answers.