Knowledge Bases
A knowledge base (KB) is a collection of papers, observations, and embeddings that you can search and query together. KBs are owned by a group (including your personal group) and can be public or private.
Creating a KB
- Click New KB from the user menu.
- Choose an owner — your personal account or any group you belong to.
- Enter a slug (short URL-friendly name), description, and optional readme.
- Click Create.
If you're a group member (not admin), you'll automatically become the owner of KBs you create.
KB settings
Navigate to your KB and click the Settings tab. From here you can:
- Description — a short one-line description shown in listings.
- Readme — longer description shown on the KB overview page.
- System prompt — injected into LLM context when this KB is queried. Useful for steering chat behavior (e.g. "focus on clinical relevance").
- Auto-import cited papers — automatically import papers cited by sources in this KB. Cited papers are added with degree 2+.
- Entity types — limit fact extraction to specific entity types (genes, variants, phenotypes, etc.).
- Literature map — enable a PCA-based similarity map visualization.
Managing members
Click the Members tab in KB settings to see all group members and their effective KB role.
- Group admins are always KB owners — this can't be changed.
- Group members default to viewer access.
- KB owners or group admins can upgrade members to editor or owner.
- Setting a member back to viewer removes their per-KB override.
KB roles
| Role | Can do |
|---|---|
| Owner | Full control — settings, members, import, delete |
| Editor | Import papers, manage content, view settings/status |
| Viewer | Browse papers, authors, observations, run queries |
Visibility
KBs can be public or private:
- Public — anyone can view and query, even without signing in.
- Private — only authenticated users with a role can access.
Toggle visibility from the Danger zone section of KB settings.
Collections
Within a KB, you can organize papers into collections — useful for grouping papers by topic, review, or project. Collections can be created from the Docs tab.
Status and maintenance
The Status tab in KB settings shows:
- Job queue — pending, running, and failed background jobs.
- Recent activity — import history with success/error details.
- Actions — re-ingest papers, re-extract observations, refresh figures, fetch external citations, or cancel pending jobs.