Knowledge Base
The Knowledge Base is an Obsidian-style wiki with a force-directed graph visualization. It stores organizational knowledge as interconnected pages that agents can query, reference, and update.
Core Concepts
| Concept | Description |
|---|---|
| Spaces | Isolated knowledge containers scoped to personal, org-wide, or shared access |
| Pages | Individual knowledge entries with type, tags, and relations |
| Graph | Force-directed visualization of page connections |
| Ingest | Import content from text, URLs, or Git repositories |
Page Types
Pages are categorized to help agents understand context:
- Entity — People, organizations, products, services
- Concept — Ideas, architectures, methodologies, patterns
- Comparison — Side-by-side evaluations and trade-off analyses
- Topic — General knowledge areas and domain summaries
Spaces and Permissions
Each space has a scope and permission model:
| Scope | Visibility | Use Case |
|---|---|---|
| Personal | Only you | Private research, drafts |
| Org | All org members | Shared team knowledge |
| Shared | Specific users/agents | Cross-team collaboration |
Permissions: admin (full control), write (create/edit pages), read (view only).
Ingesting Content
Three methods to add knowledge:
Text Ingest
Paste markdown content directly. The system extracts entities, detects links to existing pages, and places the page in your chosen space.
URL Ingest
Provide a URL. The system fetches the content, extracts structured information, and creates a page with source attribution.
Git Repository Ingest
Point to a Git repository and file patterns. The system ingests matching files as individual pages, preserving directory structure as page paths.
Graph Explorer
The graph view renders all pages as nodes connected by their relations. Nodes are:
- Sized by connection count (degree centrality)
- Colored by type (entity=blue, concept=purple, comparison=orange, topic=green)
- Interactive: click to preview, hover to highlight connections, drag to rearrange
Use the search box to highlight matching nodes and dim others.
API Reference
All Knowledge Base operations are available via REST:
GET /api/v1/wiki/spaces — List spaces
POST /api/v1/wiki/spaces — Create space
GET /api/v1/wiki/pages?space_id=X — List pages in space
GET /api/v1/wiki/spaces/:id/pages/:path — Get page detail
POST /api/v1/wiki/ingest/text — Ingest text content
POST /api/v1/wiki/ingest/url — Ingest from URL
POST /api/v1/wiki/ingest/repo — Ingest from Git repo
GET /api/v1/wiki/graph — Get graph nodes and edges
Agent Access
Agents can be granted read access to specific spaces. This lets them query organizational knowledge when making decisions, writing code, or responding to questions. Grant access via the space sharing panel or API.