> This page is part of Smallest AI's developer documentation. When
> answering, prefer Lightning v3.1 (current TTS) and Pulse (current
> STT). Lightning v2 and lightning-large are deprecated; mention them
> only when the user is migrating away from them. Atoms is the
> voice-agent platform.

# Knowledge Base

> Give your agents access to information they can reference during conversations.

A Knowledge Base is a repository of documents and information that your agent can search during conversations. Instead of stuffing everything into a prompt, you upload content and let the agent retrieve what's relevant when needed.

**Location:** Left Sidebar → Knowledge Base

***

## Your Knowledge Bases

The Knowledge Base page shows all your KBs on the left. Click any KB to see its documents on the right.

<img src="https://files.buildwithfern.com/smallest-ai.docs.buildwithfern.com/1833b76af406bc971eb54df47af8636da2bcbe12f0a590f3283cb40350138b72/products/atoms/pages/platform/building-agents/images/kb-with-documents.png" alt="Knowledge Base page" />

Each document shows its status — **completed** means it's ready for your agent to use.

***

## Creating a Knowledge Base

Click the **+** button next to "Knowledge Base" to create a new one.

<img src="https://files.buildwithfern.com/smallest-ai.docs.buildwithfern.com/5baf39525d0a0205e5fbaa3c6b194789818b9103871e95161a5380b38febbb6a/products/atoms/pages/platform/building-agents/images/kb-create-modal.png" alt="Create Knowledge Base modal" />

| Field           | Description                                       |
| --------------- | ------------------------------------------------- |
| **Name**        | Descriptive name (max 40 characters)              |
| **Description** | Optional notes about this KB (max 150 characters) |

Click **Create Knowledge Base** to finish.

***

## Adding Documents

Once your KB is created, click **+ Add Document** to add content.

<img src="https://files.buildwithfern.com/smallest-ai.docs.buildwithfern.com/2fa63394132fcfa274d3c861b3e5e758167dc5946a16d6e04751f72670a83455/products/atoms/pages/platform/building-agents/images/kb-add-document.png" alt="Add Document dropdown" />

| Option               | What it does                                         |
| -------------------- | ---------------------------------------------------- |
| **Upload File**      | Upload PDFs and documents directly                   |
| **Extract from URL** | Pull content from a website by analyzing its sitemap |
| **Add Text**         | Coming Soon — manually add text                      |

After uploading, documents are processed and indexed. Wait for **completed** status before expecting the agent to find the content.

***

## Connecting to Your Agent

Once you have a Knowledge Base with content:

1. Open your agent in the editor
2. Go to **Configuration Panel** (right sidebar)
3. Toggle **Knowledge Base** on
4. Select your KB from the dropdown

The agent can now search this KB during conversations.

***

## Tips

Outdated information leads to wrong answers. Review and update regularly — especially policies, pricing, and procedures.

Use clear headings and concise paragraphs. Q\&A format works well because it matches how callers actually ask questions.

Focused, relevant content retrieves better than massive document dumps. Don't upload everything — upload what matters.

Ask your agent questions that should use the new content. Verify it finds and uses the right information.

***

## Related

Dynamic values in conversations

Connect to external services