Skip to content

Articles & File Uploads

View as Markdown

Inside each Collection, you can add knowledge directly in two ways: authoring articles manually in the built-in editor or uploading document files for automatic background extraction and vector indexing.

When viewing or creating sources under Articles (/{slug}/ai-kb/{collectionId}/articles), each source carries a type:

KindPurposeDirectly Editable
Article (ARTICLE)Guides, workflows, and detailed context for AI responsesYes
Exact Match (EXACT_MATCH)Fixed rules that return a verbatim response without LLM rephrasingYes
FAQ (FAQ)Concise question-and-answer pairs for common inquiriesYes
Policy (POLICY)Return, warranty, shipping, and payment termsYes
Product (PRODUCT)Product/service descriptions (also creatable via Mina or API)Yes
File Document (FILE_DOC)Content extracted from uploaded filesYes (after processing)
Web Page (WEB_PAGE)Content synced from a website URLRead-only (resync from source URL)
Chat Example (EXAMPLE)Reply examples harvested from past human conversationsRead-only
  1. Inside a collection, click the add button and choose Write Article.
  2. Select a content kind (Article, Exact Match, FAQ, or Policy).
  3. Enter a Title and compose the content in the rich-text editor (supports formatting and inline image uploads).
  4. For Exact Match (EXACT_MATCH) sources, add question variants (questionVariants) so the rule triggers reliably across different phrasings.
  5. Click Save (or press Ctrl+S / Cmd+S on the article detail view). You can toggle active status (isActive) or move an article to another collection at any time.

OmnyBot supports uploading files that are asynchronously parsed, chunked, and embedded via a background worker queue (ai-document-ingest).

  • File extensions: .pdf, .docx, .txt, .md, .markdown, .csv, .json
  • Max file size: 100 MB per file
  • Batch limit: up to 10 files per upload batch
  1. Inside a collection, click the add button and choose Upload Document.
  2. Drag and drop or browse files from your device (unsupported extensions, files over 100 MB, and duplicates in the same batch are skipped automatically).
  3. Start the upload to transfer files to storage and enqueue them for background processing.
  4. Track indexing status on each item:
    • PENDING → INDEXING: Extracting text and generating embeddings.
    • READY: Indexed and searchable by AI bots.
    • FAILED / ERROR: Processing failed (inspect the recorded error message).