Sources - Prompts & Templates
Your bot configuration hub
Overview
Sources is the configuration center in General Bots Suite. Manage your bots, prompts, templates, and knowledge bases all in one place. Sources is where you create new bots, customize their behavior, and organize the content that powers your AI assistant.
Features
Managing Bots
Creating a New Bot
- Click + New Bot in the top right
- Fill in the bot details:
| Field | Description |
|---|---|
| Bot ID | Unique identifier (lowercase, numbers, hyphens only) |
| Display Name | User-friendly name shown in chat |
| Description | Brief explanation of what the bot does |
| Start from | Blank, Template, or Clone existing |
Bot Settings
Click the ⚙️ icon on any bot to configure:
General Settings:
| Setting | Description |
|---|---|
| Display Name | Name shown to users |
| Welcome Message | First message when conversation starts |
| Language | Primary language for the bot |
| Timezone | Bot’s timezone for date/time operations |
| Status | Live, Draft, or Maintenance |
Status Options:
- Live - Bot is active and responding
- Draft - Bot is hidden from users
- Maintenance - Shows maintenance message
AI Settings
| Setting | Description |
|---|---|
| Provider | AI provider (OpenAI, Azure, etc.) |
| Model | Model to use (GPT-5, Claude Sonnet 4.5, local GGUF, etc.) |
| Temperature | Creativity level (0 = focused, 1 = creative) |
| Max Tokens | Maximum response length |
| System Prompt | Bot personality and instructions |
| Knowledge Base | Connected .gbkb for answers |
Managing Prompts
Prompts are reusable text templates for AI interactions.
Prompt Types:
| Type | Purpose |
|---|---|
| System Prompt | Bot personality/behavior |
| Task Prompt | Specific task instructions |
| Template | Reusable text with variables |
Creating a Prompt:
- Click + New Prompt
- Enter a name (e.g., “support-agent”)
- Select type
- Write prompt content with optional
{{variables}} - Save and link to bots
Example Prompt:
You are a friendly and professional customer support agent
for {{company_name}}.
## Your Personality
- Be warm and empathetic
- Use simple, clear language
- Be patient and thorough
## Guidelines
- Always verify customer identity before sharing account info
- If unsure, search the knowledge base
- Escalate complex issues to human agents
- Never make promises about refunds or compensation
Managing Templates
Templates are pre-built bot packages you can reuse.
Installed Templates:
| Template | Description |
|---|---|
| 📋 CRM | Full CRM with leads, contacts |
| 📋 Support | Ticket management and customer service |
| 📋 FAQ | Answer common questions from KB |
Available Templates:
| Template | Description |
|---|---|
| 📋 HR | Employee self-service |
| 📋 Analytics | Dashboard and metrics |
| 📋 Compliance | LGPD, GDPR compliance |
Template Contents:
Templates include:
- Dialog scripts (.bas files)
- Bot configuration
- Knowledge base documentation
- Sample conversations
Managing Knowledge Bases
Knowledge bases store documents that your bot can search for answers.
| Field | Description |
|---|---|
| Documents | Count of uploaded files |
| Size | Total storage used |
| Last Indexed | When content was last processed |
| Used By | Bots connected to this KB |
Uploading Documents:
- Open the knowledge base
- Click Upload or drag files
- Organize into folders
- Click Reindex to process new content
Supported Formats:
- PDF, DOCX, TXT, MD
- CSV, XLSX
- HTML, JSON
Import and Export
Exporting a Bot
- Click ⚙️ on the bot
- Select Export
- Choose what to include:
- Bot configuration
- Dialog scripts (.bas files)
- Prompts
- Knowledge base (optional, large)
- Conversation history (optional)
- Select format: .gbai, ZIP, or JSON
Importing a Bot
- Click Import at the top
- Drop file or browse (supported: .gbai, .zip)
- Choose:
- Create new bot, or
- Replace existing bot
- Configure merge options for prompts and KB
Keyboard Shortcuts
| Shortcut | Action |
|---|---|
Ctrl+N | New bot |
Ctrl+S | Save changes |
Ctrl+E | Export selected |
Ctrl+I | Import |
Delete | Delete selected |
Ctrl+D | Duplicate |
F2 | Rename |
/ | Search |
Enter | Open selected |
Escape | Close dialog |
Tips & Tricks
Bot Management
💡 Use descriptive names - “customer-support-v2” is better than “bot1”
💡 Keep prompts separate - Reuse prompts across multiple bots
💡 Version your exports - Export before major changes
💡 Test in Draft mode - Don’t go Live until fully tested
Prompt Writing
💡 Be specific - Clear instructions give better results
💡 Use examples - Show the AI what good responses look like
💡 Set boundaries - Define what the bot should NOT do
💡 Use variables - Make prompts reusable with {{placeholders}}
Knowledge Base
💡 Organize in folders - Group related documents together
💡 Keep documents current - Remove outdated information
💡 Use clear filenames - “refund-policy-2025.pdf” not “doc1.pdf”
💡 Reindex after changes - New content isn’t searchable until indexed
Troubleshooting
Bot not responding
Possible causes:
- Bot is in Draft mode
- AI provider not configured
- No dialogs or prompts set up
Solution:
- Check bot status is “Live”
- Verify AI settings have valid API key
- Ensure at least start.bas exists
- Check error logs in Analytics
Knowledge base not finding answers
Possible causes:
- Documents not indexed
- Document format not supported
- Query doesn’t match content
Solution:
- Click “Reindex” and wait for completion
- Convert documents to supported formats
- Check document actually contains the information
- Try different phrasing
Import fails
Possible causes:
- File corrupted
- Incompatible version
- Duplicate bot ID
Solution:
- Try re-exporting from source
- Check General Bots version compatibility
- Choose “Create new bot” instead of replace
- Rename bot ID if duplicate
Prompts not applying
Possible causes:
- Prompt not linked to bot
- Variable not defined
- Syntax error in prompt
Solution:
- Check AI Settings → System Prompt selection
- Verify all {{variables}} have values
- Test prompt with “Test” button
- Check for unclosed brackets or quotes
BASIC Integration
Access Sources data from dialogs:
Get Bot Configuration
config = GET BOT CONFIG
TALK "Bot name: " + config.displayName
TALK "Language: " + config.language
Use Prompts
' Load a prompt template
prompt = GET PROMPT "summarize"
' Use with variables
summary = GENERATE WITH PROMPT prompt, content
TALK summary
Search Knowledge Base
HEAR question AS TEXT "What would you like to know?"
results = SEARCH KB question IN "support.gbkb"
IF COUNT(results) > 0 THEN
TALK results[0].answer
TALK "Source: " + results[0].source
ELSE
TALK "I couldn't find information about that."
END IF
List Available Bots
bots = GET BOTS
TALK "Available bots:"
FOR EACH bot IN bots
IF bot.status = "live" THEN
TALK "● " + bot.displayName
ELSE
TALK "○ " + bot.displayName + " (draft)"
END IF
NEXT
See Also
- Designer App - Visual flow builder
- Drive App - Upload KB documents
- How To: Create Your First Bot
- How To: Add Documents to Knowledge Base