KB LIST COLLECTIONS

The KB LIST COLLECTIONS keyword returns a list of all knowledge base collection names associated with the current bot.

Syntax

collections = KB LIST COLLECTIONS

Parameters

None. Returns collections for the current bot.

KB LIST COLLECTIONS queries Qdrant to retrieve all collection names that belong to the current bot. Collections are filtered by the bot ID prefix (kb_{bot_id}), returning only collections owned by the calling bot.

Use cases include:

Discovering available knowledge domains
Building dynamic collection selection interfaces
Admin dashboards and monitoring
Iterating over collections for batch operations
Validating collection existence before operations

Return Value

Returns an array of collection name strings. Returns an empty array if no collections exist.

Example return value:

["kb_products", "kb_faqs", "kb_policies", "kb_support"]

Examples

Basic Collection Listing

' List all KB collections
collections = KB LIST COLLECTIONS

TALK "Available knowledge bases:"
FOR EACH coll IN collections
    TALK "  - " + coll
END FOR

Check Collection Existence

' Verify a collection exists before using it
collections = KB LIST COLLECTIONS
target_collection = "kb_products"

found = false
FOR EACH coll IN collections
    IF coll = target_collection THEN
        found = true
        EXIT FOR
    END IF
END FOR

IF found THEN
    TALK "Products knowledge base is available"
    USE KB target_collection
ELSE
    TALK "Products knowledge base not found"
END IF

Admin Collection Overview

' Generate overview of all collections
collections = KB LIST COLLECTIONS

IF LEN(collections) = 0 THEN
    TALK "No knowledge base collections found."
ELSE
    TALK "Found " + LEN(collections) + " collections:"
    
    FOR EACH coll IN collections
        stats_json = KB COLLECTION STATS coll
        stats = PARSE_JSON(stats_json)
        
        disk_mb = stats.disk_data_size / 1024 / 1024
        TALK "  " + coll + ": " + stats.points_count + " docs (" + FORMAT(disk_mb, "#,##0.00") + " MB)"
    END FOR
END IF

Dynamic Collection Selection

' Let user choose a knowledge base
collections = KB LIST COLLECTIONS

TALK "Which knowledge base would you like to search?"
TALK "Available options:"

idx = 1
FOR EACH coll IN collections
    ' Remove kb_ prefix for display
    display_name = REPLACE(coll, "kb_", "")
    TALK idx + ". " + display_name
    idx = idx + 1
END FOR

HEAR choice AS NUMBER

IF choice > 0 AND choice <= LEN(collections) THEN
    selected = collections[choice - 1]
    USE KB selected
    TALK "Now searching in: " + selected
ELSE
    TALK "Invalid selection"
END IF

Batch Operations on All Collections

' Get stats for all collections
collections = KB LIST COLLECTIONS

total_docs = 0
total_size = 0

FOR EACH coll IN collections
    stats_json = KB COLLECTION STATS coll
    stats = PARSE_JSON(stats_json)
    
    total_docs = total_docs + stats.points_count
    total_size = total_size + stats.disk_data_size
END FOR

TALK "Across " + LEN(collections) + " collections:"
TALK "  Total documents: " + FORMAT(total_docs, "#,##0")
TALK "  Total size: " + FORMAT(total_size / 1024 / 1024, "#,##0.00") + " MB"

Collection Health Check

' Check health of all collections
collections = KB LIST COLLECTIONS
issues = []

FOR EACH coll IN collections
    stats_json = KB COLLECTION STATS coll
    stats = PARSE_JSON(stats_json)
    
    IF stats.status <> "green" THEN
        issues = issues + [coll + " (" + stats.status + ")"]
    END IF
END FOR

IF LEN(issues) > 0 THEN
    TALK "Collections with issues:"
    FOR EACH issue IN issues
        TALK "  ⚠️ " + issue
    END FOR
ELSE
    TALK "✅ All " + LEN(collections) + " collections are healthy"
END IF

Collection-Based Routing

' Route query to appropriate collection based on topic
collections = KB LIST COLLECTIONS

' Determine best collection for user's question
topic = LLM "Classify this question into one category: products, support, policies, or general. Question: " + user_question
topic = TRIM(LOWER(topic))

target = "kb_" + topic

' Check if collection exists
collection_found = false
FOR EACH coll IN collections
    IF coll = target THEN
        collection_found = true
        EXIT FOR
    END IF
END FOR

IF collection_found THEN
    USE KB target
    answer = SEARCH user_question
ELSE
    ' Fall back to searching all collections
    USE KB
    answer = SEARCH user_question
END IF

TALK answer

Error Handling

ON ERROR RESUME NEXT

collections = KB LIST COLLECTIONS

IF ERROR THEN
    PRINT "Failed to list collections: " + ERROR_MESSAGE
    collections = []
END IF

IF LEN(collections) = 0 THEN
    TALK "No knowledge base collections available"
ELSE
    TALK "Found " + LEN(collections) + " knowledge base collections"
END IF

KB STATISTICS — Comprehensive KB statistics
KB COLLECTION STATS — Stats for specific collection
KB DOCUMENTS COUNT — Total document count
KB STORAGE SIZE — Storage usage in MB
USE KB — Enable KB for queries
CLEAR KB — Clear knowledge base content

Implementation Notes

Implemented in Rust under src/basic/keywords/kb_statistics.rs
Queries Qdrant REST API at /collections
Filters results by bot ID prefix (kb_{bot_id})
Returns array of Dynamic strings for easy iteration
Empty array returned if no collections or on error
Collection names include the full prefix (e.g., kb_products)

Summary

KB LIST COLLECTIONS provides a way to discover all knowledge base collections belonging to the current bot. Use it for dynamic collection selection, admin dashboards, batch operations, or validating collection existence before performing operations. Combine with KB COLLECTION STATS to get detailed information about each collection.

General Bots Documentation