Skip to main content

Knowledge Bases

Knowledge bases let you give assistants access to your organization's documents. Upload files — policy documents, product manuals, runbooks, FAQs — and the assistant can search and reference them when answering questions.

What Are Knowledge Bases?​

A knowledge base is a named collection of files that Diosc indexes for semantic search. When a user asks a question, the assistant searches linked knowledge bases for relevant content and includes it in its response.

This is called RAG (Retrieval Augmented Generation) — the AI retrieves relevant information from your documents and uses it to generate accurate, grounded answers.

Why Knowledge Bases?​

Without Knowledge Bases​

The AI only knows what's in its training data. It can't answer questions about:

  • Internal company policies
  • Product-specific documentation
  • Processes unique to your organization

With Knowledge Bases​

Upload your documents and the AI can:

  • Answer policy questions accurately
  • Reference specific sections of your documentation
  • Stay up-to-date as you update documents

How It Works​

1. Upload​

Files are uploaded to a knowledge base — either manually through the admin portal or automatically via the sync webhook.

2. Index​

Each file is processed through a pipeline:

  • Text extraction — Content is extracted from PDFs, DOCX, spreadsheets, etc.
  • Chunking — Large documents are split into searchable passages
  • Embedding — Each chunk is converted to a vector for semantic search

Knowledge bases are linked to assistants and/or roles. This controls which assistants can search which knowledge.

When a user asks a question, the assistant:

  1. Searches linked knowledge bases for semantically similar content
  2. Retrieves the most relevant passages
  3. Uses them to generate an informed response

Knowledge + Roles​

Knowledge bases can be linked at two levels:

LevelUse CaseExample
AssistantShared across all usersCompany-wide policies, product docs
RoleOnly for users with a specific roleEngineering runbooks, HR procedures

When a user has an active role, the assistant searches both the assistant-level and role-level knowledge.

An engineer sees Product Docs + Engineering Runbooks. An HR user sees Product Docs + HR Procedures.

Keeping Knowledge Current​

Documents go stale. Diosc provides two ways to keep knowledge up to date:

Manual Upload​

Upload updated files through the admin portal. Delete outdated files and upload replacements.

Sync Webhook​

Automate updates by connecting your document storage (S3, SharePoint, CI/CD) to the sync webhook. When a document changes in your storage, push the update to Diosc automatically.

Next Steps​