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 of content:
  • Small knowledge bases (a few documents): 30 seconds to 1 minute
  • Medium (dozens of documents + URLs): 2 to 5 minutes
  • Large (100+ sources): 5 to 15 minutes
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:
  1. Collects all documents marked as “trained” and removes any content marked as “deleted”
  2. Splits the remaining content into searchable chunks
  3. Creates embeddings: mathematical representations that help the bot find relevant content
  4. Builds a knowledge graph: connections between concepts for deeper understanding
  5. Activates the new knowledge for the bot to use
The bot will not respond to questions while a rebuild is in progress. Plan rebuilds during low-traffic hours to minimize impact on your community.
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
Starter3
Pro10
Enterprise20
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
Don’t rebuild during peak hoursRebuilds use processing resources
Check the status before testingMake sure the rebuild finished successfully
Rebuild weekly for Q&A learningIncorporate the latest moderator answers

Next Steps