KB DOCUMENTS COUNT

The KB DOCUMENTS COUNT keyword returns the total number of documents stored in the bot’s knowledge base.

Syntax

count = KB DOCUMENTS COUNT

Parameters

None. Returns the count for the current bot’s knowledge base.

KB DOCUMENTS COUNT queries the database to return the total number of documents that have been indexed in the bot’s knowledge base. This is a lightweight operation compared to KB STATISTICS when you only need the document count.

Use cases include:

Checking if knowledge base has content
Displaying document counts in conversations
Conditional logic based on KB size
Simple monitoring and logging

Return Value

Returns an integer representing the total document count. Returns 0 if no documents exist or if an error occurs.

Examples

Basic Count Check

' Check how many documents are in KB
doc_count = KB DOCUMENTS COUNT

TALK "The knowledge base contains " + doc_count + " documents."

Conditional KB Usage

' Only use KB if it has content
doc_count = KB DOCUMENTS COUNT

IF doc_count > 0 THEN
    USE KB
    answer = SEARCH user_question
    TALK answer
ELSE
    TALK "The knowledge base is empty. Please add some documents first."
END IF

Admin Status Report

' Quick status check for administrators
doc_count = KB DOCUMENTS COUNT

IF doc_count = 0 THEN
    status = "⚠️ Empty - No documents indexed"
ELSE IF doc_count < 10 THEN
    status = "📄 Minimal - " + doc_count + " documents"
ELSE IF doc_count < 100 THEN
    status = "📚 Growing - " + doc_count + " documents"
ELSE
    status = "✅ Robust - " + doc_count + " documents"
END IF

TALK "Knowledge Base Status: " + status

Monitoring Growth

' Log document count for tracking
doc_count = KB DOCUMENTS COUNT
timestamp = FORMAT(NOW(), "YYYY-MM-DD HH:mm")

PRINT "[" + timestamp + "] KB document count: " + doc_count

' Store for trending
INSERT "kb_count_log", #{
    "timestamp": NOW(),
    "count": doc_count
}

Before/After Import Check

' Check count before and after document import
before_count = KB DOCUMENTS COUNT

' Import new documents
IMPORT "new-documents.zip"

after_count = KB DOCUMENTS COUNT
added = after_count - before_count

TALK "Import complete! Added " + added + " new documents."
TALK "Total documents now: " + after_count

Error Handling

ON ERROR RESUME NEXT

count = KB DOCUMENTS COUNT

IF ERROR THEN
    PRINT "Error getting document count: " + ERROR_MESSAGE
    count = 0
END IF

IF count > 0 THEN
    TALK "Found " + count + " documents in the knowledge base."
ELSE
    TALK "No documents found or unable to query knowledge base."
END IF

KB STATISTICS — Get comprehensive KB statistics
KB DOCUMENTS ADDED SINCE — Count recently added documents
KB STORAGE SIZE — Get storage usage
KB LIST COLLECTIONS — List all collections
CLEAR KB — Clear knowledge base
USE KB — Enable KB for queries

Implementation Notes

Implemented in Rust under src/basic/keywords/kb_statistics.rs
Queries PostgreSQL kb_documents table
Filters by current bot ID
Returns 0 on error (does not throw)
Very fast operation (single COUNT query)

Summary

KB DOCUMENTS COUNT provides a quick way to get the total number of documents in the knowledge base. Use it for simple checks, conditional logic, and lightweight monitoring. For more detailed statistics, use KB STATISTICS instead.

General Bots Documentation