Organize & Prioritize Knowledge

Why organization matters

A tidy Brain Vault reduces noise in retrieval, speeds up indexing, and keeps your assistant's answers sharp. Because every knowledge source is treated equally by the retrieval engine, the quality and clarity of each file or URL determine which snippets the LLM surfaces first.

Four habits for a healthy Vault

Use descriptive titles

When you upload a file or paste a URL, give it a short, human‑friendly name such as Refund‑Policy‑2025. The title appears in search debugging and makes future clean‑ups easier.

Keep sources bite‑sized

Split long PDFs or manuals into sections (e.g., one chapter per file). Smaller chunks give the vector search engine more precise hits and lower token costs.

Remove stale content

Outdated docs cause conflicting answers. Delete superseded versions and re‑upload new ones so the assistant never quotes old pricing or policy text.

Preview early & often

Use the Preview button in Brain Vault to ask sample questions. If the response cites the wrong source, fix the Vault before shipping your flow.

Import efficiently

If you have many pages to add, use one of the bulk import tools instead of manual uploads:

• Bulk URLs: Paste or CSV‑upload dozens of links in one go.
• Site crawl: Point BotStacks at a root URL and let it ingest every reachable page automatically.

Next steps

• If you haven't added any data yet, start with Add Knowledge Sources.
• When your Vault looks clean, head to DIRTbox to test the whole conversation flow.

FAQ

How do I fix answers that still look wrong after clean‑up?

Double‑check that the correct document actually contains the answer. If not, add it. If yes, try shortening that document into more focused subsections so retrieval returns a tighter snippet.

Can I edit a source without deleting it?

At the moment, changes require a re‑upload. Download or copy the existing content, edit locally, then upload the revised file.