Overview
The Knowledge Base tool enables your Utari workers to store, organize, and intelligently retrieve information from a personal knowledge library. Using semantic search and natural language queries, agents can find relevant information across documents, maintain organized file structures, and access contextual knowledge to inform their responses and actions.Knowledge Base Capabilities
Semantic Search
Find information using natural language queries across all knowledge base files
File Management
Upload, organize, enable/disable, and delete files and folders
Sync & Index
Synchronize knowledge base to local workspace for fast access
List Contents
View all folders and files in the knowledge base hierarchy
Enable/Disable
Control which files are active and searchable for specific agents
Maintenance
Cleanup and optimization operations for knowledge base health
The Knowledge Base uses semantic search, meaning it understands the meaning and context of queries rather than just matching keywords. Ask questions naturally, and the system finds relevant information even if exact words don’t match.
Understanding the Knowledge Base
What is Semantic Search?
Semantic Search Explained
Unlike traditional keyword search, semantic search understands:
- Meaning and Context: “How do I improve sales?” finds information about “increasing revenue” and “customer conversion”
- Related Concepts: Searching for “pricing strategy” finds documents about “monetization” and “value-based pricing”
- Natural Language: Ask questions as you would ask a person
- Intent Recognition: Understands what you’re really looking for
- Query: “How should we position our product?”
- Finds: Documents about “market positioning,” “competitive advantage,” “value proposition,” and “target audience definition”
Global vs. Local Knowledge Base
- Global Knowledge Base
- Local Sandbox Copy
Location: Cloud-based, accessible across all agentsPurpose:
- Centralized knowledge repository
- Shared across workspace
- Persistent storage
- Version controlled
- Upload files from sandbox
- Create folder structure
- Enable/disable for specific agents
- Delete when no longer needed
- Company SOPs and guidelines
- Reusable templates
- Shared reference materials
- Brand guidelines
- Product documentation
Using Semantic Search
Basic Search
Worker Performs Semantic Search
The system:
- Understands the semantic meaning of your query
- Searches all indexed files in knowledge base
- Ranks results by relevance
- Returns most pertinent information
Targeted Search
Search within specific files or folders:Advanced Search Techniques
Conceptual Search
Conceptual Search
Ask about concepts, not just keywords:
Question-Based Search
Question-Based Search
Ask direct questions:The system finds procedural documents and guidelines that answer these questions.
Context-Aware Search
Context-Aware Search
Provide context for better results:
Multi-Aspect Search
Multi-Aspect Search
Search for multiple related aspects:
Managing Knowledge Base Files
Listing Knowledge Base Contents
Uploading Files to Knowledge Base
Organizing with Folders
Enabling and Disabling Files
Deleting Files and Folders
Syncing Knowledge Base
Global KB Sync
Knowledge Base Maintenance
Cleanup Operations
Use Cases and Workflows
Reference-Based Content Creation
Creating Brand-Aligned Content
Procedure-Guided Task Execution
Following SOPs
Question Answering with Context
Informed Responses
Multi-Document Synthesis
Comprehensive Research
Best Practices
Organized Structure
Maintain clear folder hierarchy mirroring your organizational structure
Descriptive Naming
Use clear, searchable file names: “Brand_Voice_Guide_2024.pdf” not “doc1.pdf”
Regular Updates
Keep knowledge base current by updating or replacing outdated files
Strategic Enabling
Only enable relevant files for each agent to improve search quality
Periodic Cleanup
Regularly remove obsolete files and run maintenance
Version Control
Include version/date in file names for evolving documents
Format Consistency
Use consistent file formats (PDF for final, DOCX for editable)
Document Metadata
Include README files in folders explaining contents and purpose
Supported File Types
- Documents
- Spreadsheets
- Presentations
- Code & Data
- PDF (.pdf) - Best for final documents, reports, guides
- Word (.docx, .doc) - Editable documents
- Text (.txt) - Plain text files
- Markdown (.md) - Formatted text documentation
- RTF (.rtf) - Rich text format
Troubleshooting
Search returns no results
Search returns no results
Check:
- Files are enabled for the agent
- Files have finished indexing (check with ls_kb)
- Try broader or different search terms
- Verify files actually contain relevant information
- Run sync to update local copy
- Check if files are in correct format
File not appearing in knowledge base
File not appearing in knowledge base
Verify:
- File was successfully uploaded
- Check with list contents to see all files
- File is not being filtered from view
- File finished processing
- Refresh or re-list contents
File shows as indexing for long time
File shows as indexing for long time
Possible causes:
- Large file size (may take longer)
- Complex document structure
- High system load
- Wait 5-10 minutes for large files
- Check file isn’t corrupted
- Try re-uploading if stuck
Can't upload file to knowledge base
Can't upload file to knowledge base
Ensure:
- File exists in workspace sandbox first
- File path is correct
- File format is supported
- Sufficient storage space
- File isn’t corrupted
- Try smaller file or different format
Search results not relevant
Search results not relevant
Improve by:
- Using more specific, natural language queries
- Providing context in your search
- Checking if right files are enabled
- Ensuring files contain expected information
- Trying question-based queries
- Updating knowledge base with better documents
Sync fails or incomplete
Sync fails or incomplete
Try:
- Check network connection
- Verify permissions on files
- Run sync again
- Check available disk space
- List contents to see what should sync
- Contact support if persists
Summary
You’ve successfully learned how to:Perform semantic search using natural language queries
Upload and organize files in the knowledge base
Create folder structures for organization
Enable and disable files strategically for agents
Sync knowledge base to local workspace
List and review knowledge base contents
Delete files and folders when no longer needed
Perform maintenance and cleanup operations
Apply best practices for knowledge management
Next Steps
Activate Knowledge
Learn to activate knowledge for specific workers
Add Knowledge
Upload SOPs and documents to knowledge base
Agent Configuration
Configure agents with knowledge access
Jeremy SOPs
Access pre-built knowledge resources