What is a File?
A file is any artefact you’ve uploaded to your organization. Each file:- Is stored securely in Bizzy storage.
- Belongs to an organization, optionally inside a folder.
- Has metadata — filename, content type, size, tags, description.
- Has an indexing status that tracks whether it’s searchable yet.
.docx), PowerPoint (.pptx), and OpenDocument text and
presentations (.odt, .odp), plus the images PNG, JPEG, and WebP
— alongside inline Markdown and other plain-text formats. Spreadsheets and
other formats can still be uploaded and shared via public links — they simply
aren’t indexed for retrieval.
Folders
Files can be grouped into folders. Folders are useful for two reasons:- Organisation. Same as folders anywhere — group what belongs together.
- Agent access control. Each file (and each folder) carries an Agent access flag. Turn the flag off on a folder and your agents will not see anything in it during retrieval, even if a query would otherwise match.
From Upload to Searchable
When a file is uploaded, an automatic pipeline takes it from raw bytes to retrievable knowledge:- Store. The file is saved and appears in your file list immediately.
- Extract. PDFs, office documents (Word, PowerPoint, OpenDocument), and images are converted to clean, structured text via OCR. Markdown and other text files are read directly.
- Chunk. The text is split along its natural structure — sections, paragraphs, sentences — so each piece stays coherent on its own, with a little overlap between neighbouring pieces so context isn’t lost at boundaries.
- Index. Each piece is indexed for both semantic (meaning-based) search and keyword search.
pending → indexing → indexed. If a file
isn’t indexable (unsupported format, too large, or its text couldn’t be
extracted) the status ends in skipped, excluded, or failed — visible on
the file’s detail view so you know it’s not searchable.
How Agents Retrieve Files (RAG)
When an agent needs information from your files, Bizzy uses hybrid retrieval: a semantic search that is good at fuzzy, meaning-level matches, and a keyword search that is good at exact terms — run together, with the best-matching passages from both handed to the agent as context. You get relevant results whether you ask “what’s our refund policy?” or search for an exact part number. Two important guarantees are enforced on every retrieval:- Only content from the agent’s own organization is ever returned.
- Files (and folders) with Agent access turned off, files that aren’t fully indexed, and files that have been deleted are silently excluded.
What it Costs
File usage is metered through two of your account’s consumables:- Storage — the total bytes in your file library, counted against your tier’s storage allowance.
- LLM Tokens — indexing a file consumes embedding tokens, which count toward the same token allowance your agents and automations use.
Related Topics
Upload Files
How to add files in the web app
RAG Indexing
Re-index files, exclude folders, troubleshoot
Agents
How agents use files at runtime
Credits & Billing
What storage and indexing cost