Skip to main content
The Knowledge Base is your organization’s centralized document repository. Upload product catalogs, spreadsheets, FAQs, and sales materials so that any AI agent in your organization can reference them when answering customer questions.

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

FormatExtensionsBest For
PDF.pdfProduct catalogs, brochures, spec sheets
Word.docx, .docSales materials, guides
Text.txtFAQs, simple documents
Spreadsheets.csv, .xls, .xlsxProduct 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

1

Upload

Drag and drop your Excel or CSV files into the upload area
2

Classification

AI automatically classifies your sheets and detects the type of data in each one
3

Column Mapping

Map your spreadsheet columns to the appropriate fields, with the option to customize column headers
4

Import

Execute the import and track progress in real time. View your import history to see past imports.

Uploading Files

From Agent Files Tab

  1. Navigate to Knowledge BaseAgent Files
  2. Click Upload or drag and drop files
  3. Wait for processing to complete (typically 1-2 minutes)

From AI Data Import Tab

  1. Navigate to Knowledge BaseAI Data Import
  2. Follow the 4-step import wizard
  3. Review AI classification results and adjust if needed
  4. 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:
  1. Open an agent in the agent builder
  2. Go to the Knowledge Base tab
  3. Select files to attach
  4. Give each attachment a name (e.g., “Pricing 2025”) and description (e.g., “Use for pricing questions”)
The name and description help the agent understand when to search that document. Be specific — a well-described attachment leads to more accurate responses.
Use descriptive names like “Q1 Product Catalog” or “Shipping Policy 2025” rather than generic names like “Document 1”. This helps agents choose the right document for each question.
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
Good Document Example:
Product: Steel Beams Overview Steel beams are structural components used in construction… Specifications
  • Material: A992 Grade 50 Steel
  • Sizes: W4x13 to W44x335
  • Length: Up to 60 feet
Pricing Contact sales for current pricing. Volume discounts available.

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:
  1. Delete the old version from the Knowledge Base
  2. Upload the updated file
  3. Wait for processing to complete

Deleting a Document

  1. Go to Knowledge BaseAgent Files
  2. Click the delete icon on the document
  3. Confirm deletion
Deleted documents are immediately removed and will no longer be referenced by agents.

Processing Status

StatusDescription
UploadingFile is being uploaded
ProcessingDocument is being prepared for search
ReadyAvailable for agent queries
ErrorProcessing failed — try re-uploading

Testing

After adding documents:
  1. Open an agent that has the documents attached
  2. Use the Test panel in the agent builder
  3. Ask questions you expect customers to ask
  4. Verify the agent references your documents accurately
  5. Adjust document content or structure if responses aren’t accurate

Troubleshooting

  • 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
  • Review source documents for accuracy
  • Improve document structure with clear headings
  • Add more detail and context to documents
  • Large files take longer to process
  • Split large documents into smaller, focused files
  • Ensure files are under the 25MB limit
  • 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