Knowledge Bases & RAG

Create and manage knowledge bases (vector databases), ground chat answers in your own documents with Retrieval-Augmented Generation, and control access.

knowledge bases

What a knowledge base is

A knowledge base (shown as Vector Database in the Work Station) stores your trusted content — documents, folders, and notes — in one indexed place. AI conversations can then retrieve from it, so answers are grounded in your actual material instead of the model's general knowledge.

That grounding mechanism is Retrieval-Augmented Generation (RAG):

  1. You ask a question referencing a knowledge base.
  2. The platform retrieves the passages most relevant to your question.
  3. The model composes an answer using those passages — with sources shown where citations are enabled.

Use knowledge bases when you want consistent, repeatable, correct-context answers without pasting the same material into every chat.

Where to find it

  • Templates (Work Station) → Vector Database, or
  • Document → Knowledge

Both views list your databases; search by name, description, owner or group; select New to create one.

Create a knowledge base

  1. Select Create to open the setup dialog.
  2. Name — short and easy to type after # in chat: gpu-server-specs, hr-policies, audit-planning-notes.
  3. Description — what it contains and when to use it; this helps teammates choose correctly later.
  4. Group (optional) — restrict the database to members of a group (for example Engineering, Finance, Audit, Marketing).
  5. Access control — who may do what:
    • Read — can reference it in chat.
    • Full Access — can upload and edit content.
  6. Save.

Note:

Exact options vary by workspace policy. If unsure which access level suits your team, ask your administrator.

creating a knowledge base

Add content

Open the database and use Add Files to add:

OptionUse for
Plain textQuick notes, FAQs, how-to guides written directly into the base.
FilesOne or more documents (PDFs, Office files, text…), parsed and indexed automatically.
DirectoryA whole folder of documents in one step.

The database view shows a preview of attached files and the full file list; use the source view to read a plain-text version of an attachment. Content is indexed after upload — large collections take a little time before they are fully searchable.

Use it in chat

Reference a knowledge base by typing # plus its name (or selecting it from the picker):

#marketing Summarise our brand positioning and propose 5 tagline options.

Combine with explicit instructions:

Use #gpu-server-specs. Compare H100 vs H200 options and output a table with:
GPU, VRAM, target workloads, recommended chassis.

Best-practice prompts

  • Demand evidence:
    #hr-policies Answer using only this knowledge base. Quote the exact sentence for key claims.
    
  • Demand structure:
    #audit-planning-notes Extract the key risks as JSON with fields: risk, impact, controls, owner.
    

Templates can attach knowledge bases too, so the grounding is automatic — see Creating Templates.

knowledge base detail

Access, groups and governance

  • Use Groups to keep sensitive content (finance, HR) visible only to the right people.
  • Use Read for consumers, Full Access for maintainers.
  • If you can't see a knowledge base a colleague mentions, it's normally a group/permission setting. See Permissions.

Quality tips

  • One topic per database — focused bases retrieve better than one giant "everything" base.
  • Write a clear description including intended users and example questions.
  • Prefer source-of-truth documents — specs, SOPs, official notes.
  • Keep content tidy — headings, bullets and short sections retrieve better.
  • Update on change — re-upload new versions when documents change.

Troubleshooting

SymptomCheck
Doesn't appear in chatCorrect name after #; you have Read access; indexing finished (confirm files are listed).
Can view but not editYou have Read, not Full Access — ask the owner/admin.
Answers ignore a documentThe wording may not match; try a more specific question or check the document indexed correctly (View Source).
Outdated answersNewer versions weren't uploaded — refresh the content.