Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

.gbkb Knowledge Base

The .gbkb package contains your bot’s domain knowledge - documents that the AI uses to answer questions accurately about your specific organization, products, or services.

What It Does

When you place documents in a .gbkb folder, the system automatically:

  1. Extracts text from your files (PDF, DOCX, TXT, MD, HTML, CSV)
  2. Creates searchable indexes using vector embeddings
  3. Enables semantic search so users can ask questions naturally

This means your bot answers based on YOUR documents, not just general AI knowledge.

Folder Structure

mybot.gbai/
└── mybot.gbkb/
    ├── policies/           ← Collection: "policies"
    │   ├── vacation.pdf
    │   └── handbook.docx
    ├── products/           ← Collection: "products"
    │   ├── catalog.pdf
    │   └── specs.xlsx
    └── support/            ← Collection: "support"
        └── faq.md

Each subfolder becomes a collection you can activate independently.

Using in BASIC Scripts

' Activate collections for this conversation
USE KB "policies"
USE KB "products"

' Now the AI automatically searches these when answering
TALK "How can I help you today?"

' Later, clear when done
CLEAR KB "policies"

Supported File Types

FormatExtensions
PDF.pdf
Word.docx, .doc
Text.txt, .md
Web.html
Data.csv, .json

Key Points

  • Automatic indexing - Just drop files in folders
  • Semantic search - Users don’t need exact keywords
  • Multiple collections - Organize by topic, activate as needed
  • No code required - The AI handles search automatically

Learn More