> ## Documentation Index
> Fetch the complete documentation index at: https://docs.verbex.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Workspace Knowledge Base Management

The Knowledge Base system follows a centralized management model that ensures consistency while providing flexibility for workspace-specific implementations.

# Architecture

## **Knowledge Base management follows a centralized model:**

**My Workspace (Owner's Default)**

├── Create Knowledge Bases ✓

├── Manage KB Content ✓

└── Central KB Repository ✓

**Created Workspaces**

├── Create Knowledge Bases ✗

├── Connect Existing KBs ✓

└── Use Connected KBs ✓

## **Workspace Management Flow**

<img src="https://mintcdn.com/hishabsingaporepteltd/usZ2yfFlMXldspO0/images/Untitleddiagram-2025-10-28-043153.png?fit=max&auto=format&n=usZ2yfFlMXldspO0&q=85&s=1ebc19725ea629af3f90420d36b09f7a" alt="Untitled diagram-2025-10-28-043153.png" width="1186" height="818" data-path="images/Untitleddiagram-2025-10-28-043153.png" />

## **Key Principles**

1. **Single Source of Truth**: All Knowledge Bases are created and maintained in one location
2. **Workspace Agnostic**: Once created, KBs can be used across any workspace
3. **Owner Controlled**: Only workspace owners can create and modify Knowledge Bases
4. **Member Accessible**: All workspace members can connect KBs to their agents

## **Creating Knowledge Bases**

### **Prerequisites**

* You must be a **Workspace Owner**
* You must be in **My Workspace** (not in a created workspace)

### **Step-by-Step Creation**

1. **Navigate to My Workspace**

Top Navigation Bar → Workspace Selector → My Workspace

2. **Access Knowledge Base Section**

Main Menu → Knowledge Bases → Create New

3. **Configure Knowledge Base**
   * **Name**: Descriptive identifier for the KB
   * **Description**: Purpose and content overview
4. **Add Content**
   * Upload documents (MD, PDF, DOCX, TXT)
   * Add Q\&A pairs manually
   * Import from external sources (Web URL)
5. **Save and Process**

## **Content Types**

| **Format** | **Description**    | **Best For**              |
| :--------- | :----------------- | :------------------------ |
| MD         | Markdown           | Best for all purposes     |
| PDF        | Portable documents | Manuals, guides, reports  |
| DOCX       | Word documents     | Policies, procedures      |
| TXT        | Plain text files   | Simple FAQs, lists        |
| URL        | Web content        | Live documentation, wikis |

## **Connecting Knowledge Bases to Agents**

**Within Created Workspaces**

When working in any created workspace (not My Workspace):

1. **Create or Edit an Agent**
2. Workspace → Agents → Create/Edit Agent
3. **Navigate to Knowledge Base Section**
4. Agent Configuration → Knowledge Base → Connect KB
5. **Select from Available KBs**
   * View list of all KBs created by the owner
   * Select and add the KB to agent
6. **Save Agent Configuration**

## **Managing Knowledge Base Content**

**Updating Content**

1. **Access My Workspace**
2. **Navigate to Knowledge Bases**
3. **Select the KB to update**
4. **Add a file to KB**

## **Access Control and Permissions**

| **Action**          | **Owner (My Workspace)** | **Owner (Created Workspace)** | **Member (Any Workspace)** |
| :------------------ | :----------------------- | :---------------------------- | :------------------------- |
| Create KB           | ✅                        | ❌                             | ❌                          |
| Edit KB             | ✅                        | ❌                             | ❌                          |
| Delete KB           | ✅                        | ❌                             | ❌                          |
| View KB List        | ✅                        | ✅                             | ✅                          |
| Connect KB to Agent | ✅                        | ✅                             | ✅                          |
| Disconnect KB       | ✅                        | ✅                             | ✅                          |