Core Capabilities
- Organization-scoped: Files are shared across your entire organization — any agent can access them
- Upload files up to 25MB in supported formats
- Browse, preview, and delete files with full metadata (size, date, type)
- Attach files to agents with a custom name and description so agents know when to search them
Supported Formats
| Format | Extensions | Best For |
|---|---|---|
.pdf | Product catalogs, brochures, spec sheets | |
| Word | .docx, .doc | Sales materials, guides |
| Text | .txt | FAQs, simple documents |
| Spreadsheets | .csv, .xls, .xlsx | Product lists, pricing tables, inventory data |
Two Tabs
The Knowledge Base has two tabs for managing your documents:Agent Files
The Agent Files tab is your document library. Here you can:- View all uploaded documents in a list
- See file metadata (name, size, upload date, file type)
- Preview document contents
- Delete files you no longer need
AI Data Import
The AI Data Import tab provides a guided wizard for importing spreadsheet data. This is ideal for bringing in product lists, pricing tables, customer data, and other structured information from Excel or CSV files.Import Wizard Steps
Column Mapping
Map your spreadsheet columns to the appropriate fields, with the option to customize column headers
Uploading Files
From Agent Files Tab
- Navigate to Knowledge Base → Agent Files
- Click Upload or drag and drop files
- Wait for processing to complete (typically 1-2 minutes)
From AI Data Import Tab
- Navigate to Knowledge Base → AI Data Import
- Follow the 4-step import wizard
- Review AI classification results and adjust if needed
- Confirm column mappings and import
Files are processed after upload. Allow 1-2 minutes before testing agent responses with newly uploaded content.
Attaching Files to Agents
Once files are in your Knowledge Base, attach them to specific agents:- Open an agent in the agent builder
- Go to the Knowledge Base tab
- Select files to attach
- Give each attachment a name (e.g., “Pricing 2025”) and description (e.g., “Use for pricing questions”)
Agent Search
All agent types — voice, chat, and workflow — can search your Knowledge Base documents. When a customer asks a question, the agent automatically searches attached documents and uses the relevant content to respond.Document Best Practices
Content Quality
- Be specific: Include product names, SKUs, exact specifications
- Be complete: Don’t assume knowledge — spell everything out
- Be current: Update documents when products or pricing change
Structure
Well-structured documents lead to better agent responses:- Use clear headings and subheadings
- Use bullet points and numbered lists
- Organize content into logical sections
- Avoid scanned images without text content
Product: Steel Beams Overview Steel beams are structural components used in construction… SpecificationsPricing Contact sales for current pricing. Volume discounts available.
- Material: A992 Grade 50 Steel
- Sizes: W4x13 to W44x335
- Length: Up to 60 feet
Organization
- One topic per document: Don’t mix unrelated content
- Clear naming: Use descriptive file names
- Regular updates: Review and refresh documents periodically
Managing Documents
Updating a Document
When content changes:- Delete the old version from the Knowledge Base
- Upload the updated file
- Wait for processing to complete
Deleting a Document
- Go to Knowledge Base → Agent Files
- Click the delete icon on the document
- Confirm deletion
Processing Status
| Status | Description |
|---|---|
| Uploading | File is being uploaded |
| Processing | Document is being prepared for search |
| Ready | Available for agent queries |
| Error | Processing failed — try re-uploading |
Testing
After adding documents:- Open an agent that has the documents attached
- Use the Test panel in the agent builder
- Ask questions you expect customers to ask
- Verify the agent references your documents accurately
- Adjust document content or structure if responses aren’t accurate
Troubleshooting
Agent doesn't use knowledge base
Agent doesn't use knowledge base
- Verify documents show “Ready” status
- Check that files are attached to the agent with a name and description
- Test with questions that directly match document content
Responses are inaccurate
Responses are inaccurate
- Review source documents for accuracy
- Improve document structure with clear headings
- Add more detail and context to documents
Processing takes too long
Processing takes too long
- Large files take longer to process
- Split large documents into smaller, focused files
- Ensure files are under the 25MB limit
Spreadsheet import issues
Spreadsheet import issues
- Ensure your file is in CSV, XLS, or XLSX format
- Check that column headers are present in the first row
- Review the AI classification step and correct any misdetections
Next Steps
Custom Actions
Connect your business systems
Voice Agents
Configure voice settings
Testing
Test knowledge retrieval
First Agent Tutorial
Complete setup guide