Folders

Learn how to use Folders in Odeus to work with large document collections in the Knowledge Hub.

What is a Folder?

A folder is a collection of files in the Knowledge Hub that your agents and chats can search. When you add files to a folder, Odeus ingests them, splits them into chunks, and indexes them for semantic retrieval. When the model needs information, it searches the folder and only the most relevant passages are returned — with inline citations (file, page, and location) — so you can work with collections far larger than a single model context window.

Knowledge Folders are now called Folders. Find them in the Library → Folders.

Folders are fully managed by Odeus. There is no separate database to provision and no infrastructure to maintain — less technical users can work with many documents straight from the Library.

Management

You can manage folders through the interface (Library → Folders), including:

• Uploading files
• Deleting files
• Managing permissions

Sharing: You can share folders with individual users, groups, or the entire workspace.

A Google Drive folder can also be synced into a folder so it stays up to date automatically. See Google Drive Folder Sync.

Configurable retrieval

Folders use the Knowledge Hub's retrieval pipeline, which admins can tune for the workspace:

• Embedding model — admin-configurable (for example OpenAI 3-small/large, Jina, Cohere, or Voyage), with support for a self-hosted, OpenAI-compatible embedding endpoint.
• Reranker — an optional reranking stage (Cohere, Jina, or Voyage) to improve result ordering.
• Multi-resolution chunking, entity extraction, and image indexing for richer retrieval.
• Query rewriting (HyDE / multi-query) to broaden recall.

Because the embedding model is admin-configurable, your workspace can match retrieval quality to its content and language needs.

Using a Folder

Once a folder has files, it can be used:

• In chat by @-mentioning the folder.
• In an agent by attaching the folder to its Knowledge or adding it as an action so the agent can search it.