Skip to main content

Rebuild Knowledge Base

After adding or removing content — documents, URLs, or Q&A entries — you need to rebuild the knowledge base. This processes your content and makes it available for the bot to use when answering questions.

When to Rebuild

You should rebuild your knowledge base when you:
  • Upload new documents
  • Scrape new URLs
  • Delete existing content
  • Want to incorporate recent Q&A entries from Discord
New content is not available to the bot until you rebuild. If you upload a document and don’t rebuild, the bot won’t know about it.

How to Rebuild

1

Open Knowledge Base Panel

In the dashboard sidebar, look for the Knowledge Base section or the rebuild button in the Document Manager.
2

Click Rebuild

Click the Rebuild Knowledge Base button to start the process.
3

Wait for Completion

You’ll see a progress indicator showing the rebuild status. The time depends on the amount and density of your content — smaller knowledge bases finish faster, while larger ones with many documents and URLs take longer.
4

Verify Status

Once complete, the status will update to show the rebuild was successful. The bot is now using your latest content.

What Happens During a Rebuild

When you rebuild, BestChatBot replaces the entire knowledge base with a fresh version built from your current sources:
  1. Clears the existing knowledge base completely
  2. Discards sources marked as deleted
  3. Fetches content for any pending sources (e.g., new URLs that haven’t been scraped yet)
  4. Re-processes all active sources from scratch to build the new knowledge base
  5. Activates the new knowledge for the bot to use
The bot will not respond to questions while a rebuild is in progress, to avoid giving incorrect or incomplete answers.
You can continue using the dashboard while a rebuild is in progress. The rebuild only affects the bot’s ability to answer questions temporarily.

Daily Rebuild Limits

Each plan includes a limited number of rebuilds per day:
PlanDaily Rebuilds
Free1
Starter1
Pro2
Business3
Once you reach your daily rebuild limit, you’ll need to wait until the next day or upgrade your plan for more rebuilds.

Rebuild Best Practices

PracticeWhy
Rebuild after batch uploadsMore efficient than rebuilding after each file
Know the bot pauses during rebuildsIt won’t respond to questions until complete
Check the status before testingMake sure the rebuild finished successfully
Rebuild weekly for Q&A learningIncorporate the latest moderator answers

Next Steps

Test Your Bot

Verify the bot answers correctly after rebuilding.

View Knowledge Graph

Explore the connections between your content.