Rodrigo Rodriguez (Pragmatismo) 4e76abbba0 - From 1 to 4 validated.

2025-11-23 17:02:22 -03:00

4.2 KiB

Raw Blame History

CLEAR KB

Remove knowledge bases from the current session's context.

Syntax

CLEAR KB kb_name

or to clear all:

CLEAR KB ALL

Parameters

Parameter	Type	Description
`kb_name`	String	Name of the knowledge base to remove, or "ALL" for all KBs

Description

The CLEAR KB keyword removes previously loaded knowledge bases from the session's active context. This frees up memory and ensures that subsequent searches don't include unwanted collections.

Examples

Clear Specific Knowledge Base

USE KB "product-docs"
USE KB "user-manuals"

' Later, remove just product-docs
CLEAR KB "product-docs"
' Now only user-manuals is active

Clear All Knowledge Bases

' Load multiple KBs
USE KB "policies"
USE KB "procedures"
USE KB "faqs"

' Clear everything
CLEAR KB ALL
TALK "All knowledge bases have been unloaded"

Conditional Clearing

topic = HEAR "What topic interests you?"
IF topic = "technical" THEN
    CLEAR KB "marketing-docs"
    USE KB "technical-docs"
ELSE IF topic = "sales" THEN
    CLEAR KB "technical-docs"
    USE KB "marketing-docs"
END IF

Switch Knowledge Context

' Start with general KB
USE KB "general-info"
answer = FIND "company overview"
TALK answer

' Switch to specific department
CLEAR KB "general-info"
USE KB "engineering-specs"
answer = FIND "API documentation"
TALK answer

Memory Management

' Load KBs for initial context
USE KB "onboarding"
USE KB "policies"

' After onboarding complete
CLEAR KB "onboarding"
' Keep policies active but free onboarding memory

Return Value

Returns true if the KB was successfully cleared, false if the KB wasn't loaded or doesn't exist.

Error Handling

result = CLEAR KB "unknown-kb"
IF result = false THEN
    LOG "KB was not loaded or doesn't exist"
END IF

Performance Considerations

Clearing KBs immediately frees session memory
Does not delete the actual KB from vector database
Only removes the session association
Clearing all KBs is faster than clearing individually

Best Practices

Clear Unused KBs: Remove KBs when no longer needed

' After processing department-specific queries
CLEAR KB "department-kb"

Clear Before Loading: Ensure clean state
```
CLEAR KB ALL
USE KB "fresh-context"
```

Memory Optimization: Clear large KBs after use

USE KB "large-archive"
results = FIND query
CLEAR KB "large-archive"  ' Free memory

Context Switching: Clear when changing topics

ON TOPIC_CHANGE
    CLEAR KB ALL
    USE KB new_topic_kb
END ON

Session Scope

Clearing only affects the current session
Other sessions maintain their own KB associations
KBs remain in vector database for future use
Can reload cleared KBs anytime with USE KB

Monitoring Active KBs

' Check what's loaded before clearing
active_kbs = GET_ACTIVE_KBS()
TALK "Currently loaded: " + JOIN(active_kbs, ", ")

' Clear specific ones
FOR EACH kb IN active_kbs
    IF kb STARTS WITH "temp_" THEN
        CLEAR KB kb
    END IF
NEXT

Advanced Usage

Batch Operations

kbs_to_clear = ["old-docs", "archive-2022", "deprecated"]
FOR EACH kb IN kbs_to_clear
    CLEAR KB kb
NEXT

Scheduled Cleanup

' Clear all KBs at conversation timeout
ON TIMEOUT
    CLEAR KB ALL
    LOG "Session KBs cleared due to timeout"
END ON

Conditional Preservation

' Clear all except essential KBs
all_kbs = GET_ACTIVE_KBS()
essential = ["core-policies", "emergency-procedures"]

FOR EACH kb IN all_kbs
    IF kb NOT IN essential THEN
        CLEAR KB kb
    END IF
NEXT

USE KB - Load knowledge bases
ADD WEBSITE - Create KB from website
FIND - Search within loaded KBs
LLM - Use KB context in responses

Implementation

Located in src/basic/keywords/clear_kb.rs

The implementation:

Maintains session KB registry
Removes KB references from context
Updates search scope
Handles "ALL" keyword specially
Returns operation status

4.2 KiB Raw Blame History