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

# Quick Start

> Get started with Knowledge Base in 4 simple steps

## Overview

Get up and running with Knowledge Base quickly. Follow these steps to create your first knowledge base item and add it to your agents.

## Prerequisites

Before getting started, ensure you have:

* An active project selected
* Appropriate permissions to manage knowledge base items
* Available storage quota (check your plan limits)

## Quick Start Steps

1. **Navigate to Knowledge Base**
   * Go to the [Knowledge Base section](https://agents.tryhamsa.com/app/knowledge-base) in your dashboard
   * Click the appropriate button based on your content type:
     * **"Add Free Text"** for text content
     * **"Add Document"** for file uploads
     * **"Add URL"** for web content

<img className="hidden dark:block" src="https://mintcdn.com/hamsa-452fa79a/z1y0oNwHv1IXNjPW/images/knowledge-base/knowledge-base-add-buttons-dark.png?fit=max&auto=format&n=z1y0oNwHv1IXNjPW&q=85&s=833a3b876c8e9aa0f6769a6d2db4915a" alt="Knowledge Base add buttons showing Add URL, Add Document, and Add Free Text options" width="1477" height="182" data-path="images/knowledge-base/knowledge-base-add-buttons-dark.png" />

<img className="block dark:hidden" src="https://mintcdn.com/hamsa-452fa79a/z1y0oNwHv1IXNjPW/images/knowledge-base/knowledge-base-add-buttons-light.png?fit=max&auto=format&n=z1y0oNwHv1IXNjPW&q=85&s=00f2c29ff167a1dcf36ae5ed10007083" alt="Knowledge Base add buttons showing Add URL, Add Document, and Add Free Text options" width="1366" height="162" data-path="images/knowledge-base/knowledge-base-add-buttons-light.png" />

2. **Follow the Creation Wizard**
   * Complete the form for your chosen content type

3. **Monitor Processing**
   * Watch the status indicator as your item processes
   * Wait for "PROCESSED" status (shown as "completed" in dashboard) before using in agents

4. **Add to Agents**
   * Open your agent configuration
   * Navigate to Knowledge Base section

<img className="hidden dark:block" src="https://mintcdn.com/hamsa-452fa79a/z1y0oNwHv1IXNjPW/images/knowledge-base/knowledge-base-add-into-agent-1-dark.png?fit=max&auto=format&n=z1y0oNwHv1IXNjPW&q=85&s=dee3fae5673a33e905f0e1d7dbc0b9dc" alt="Global Settings panel showing Knowledge Base section with Manage button" width="500" data-path="images/knowledge-base/knowledge-base-add-into-agent-1-dark.png" />

<img className="block dark:hidden" src="https://mintcdn.com/hamsa-452fa79a/z1y0oNwHv1IXNjPW/images/knowledge-base/knowledge-base-add-into-agent-1-light.png?fit=max&auto=format&n=z1y0oNwHv1IXNjPW&q=85&s=233856f0cdf5b9769385dfc845ab01a0" alt="Global Settings panel showing Knowledge Base section with Manage button" width="500" data-path="images/knowledge-base/knowledge-base-add-into-agent-1-light.png" />

* Click **"Manage"** to open the item selection modal
* Select the items you want to use

<img className="hidden dark:block" src="https://mintcdn.com/hamsa-452fa79a/z1y0oNwHv1IXNjPW/images/knowledge-base/knowledge-base-add-into-agent-2-dark.png?fit=max&auto=format&n=z1y0oNwHv1IXNjPW&q=85&s=38e21d225790504b1ef481bedc71d791" alt="Select Knowledge Base Items modal showing search bar, item list with types and word counts, and selection buttons" width="500" data-path="images/knowledge-base/knowledge-base-add-into-agent-2-dark.png" />

<img className="block dark:hidden" src="https://mintcdn.com/hamsa-452fa79a/z1y0oNwHv1IXNjPW/images/knowledge-base/knowledge-base-add-into-agent-2-light.png?fit=max&auto=format&n=z1y0oNwHv1IXNjPW&q=85&s=33d0d22f15abf7b4c6a78dcb2263dc12" alt="Select Knowledge Base Items modal showing search bar, item list with types and word counts, and selection buttons" width="500" data-path="images/knowledge-base/knowledge-base-add-into-agent-2-light.png" />

* Click **"Done"** to save your selection

## Next Steps

Now that you've created your first knowledge base item:

* **[Creating Items](./creating-items)** - Learn detailed steps for creating different item types
* **[Managing Items](./managing-items)** - Organize, search, and filter your items
* **[Status Lifecycle](./status-lifecycle)** - Understand processing states and troubleshooting
* **[Best Practices](./best-practices)** - Optimize your knowledge base for best results

## Related Documentation

<CardGroup cols={2}>
  <Card title="Introduction" href="./introduction">
    Learn more about Knowledge Base features and capabilities
  </Card>

  <Card title="Creating Items" href="./creating-items">
    Detailed guide on creating text, file, and URL items
  </Card>

  <Card title="Managing Items" href="./managing-items">
    How to organize and manage your knowledge base
  </Card>
</CardGroup>
