> ## Documentation Index
> Fetch the complete documentation index at: https://help.treble.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Knowledge Base
> Learn how to structure an effective knowledge base to maximize the performance of your AI agents
Your AI agent is only as smart as the information you provide it. A well-structured knowledge base is the difference between an agent that confuses your customers and one that converts them into satisfied buyers.
## Why is it so important?
**๐ฏ Accurate responses from day 1**
* Avoid invented or incorrect answers
* Provide consistent information 24/7
* Reduce the need for human intervention
**๐ Better conversion results**
* More informed customers make better decisions
* Increases trust in your brand
**โก Faster implementation**
* Agents ready for production in less time
* Fewer iterations and subsequent adjustments
* Faster ROI on your AI investment
**Think of your AI agent as a new team member**: it needs the same information, procedures, and context that you would give any employee to be successful.
## ๐ Quick checklist: Is your knowledge base ready?
Before starting, verify that you have:
* Basic company information (address, hours, contact)
* Clear description of main products/services
* Current prices and promotions
* Important policies (warranty, returns, shipping)
* Frequently asked questions from your real customers
* Success stories and testimonials
* Comparisons with competition
* Simplified internal processes
* Objection handling scripts
* Lead qualification criteria
* Files in readable formats (.docx, .txt, digital .pdf)
* Selectable text (not scanned)
* Documents organized by topic
* Updated versions only
* Descriptive file names with dates
***
## ๐ง Best practices by category
Our AI can only read digital text, not images or scanned files.
**โ
Recommended formats:**
* `.docx` - Microsoft Word (ideal for structured content)
* `.txt` - Plain text (perfect for simple information)
* `.md` - Markdown (excellent for technical documentation)
* `.pdf` - Only if text is selectable (not scanned)
**๐งช Quick test:** Can you select and copy the text? If yes, it will work.
**โ Avoid these formats:**
* Scanned PDFs or converted from paper
* Screenshots or photos of documents
* Images with embedded text
* Password-protected documents
**Golden rule:** One topic = One file. AI processes organized information better than massive documents.
**๐ Recommended structure:**
```
๐ Knowledge Base/
โโโ ๐ Company-information-2024.docx
โโโ ๐ Main-products-2024.docx
โโโ ๐ Warranty-policies-2024.docx
โโโ ๐ Frequently-asked-questions-2024.docx
โโโ ๐ Prices-promotions-2024.docx
```
**โ
Within each document:**
* Clear and descriptive title
* Table of contents (if +3 sections)
* Hierarchical headings (H1, H2, H3)
* Complete information in each section
**โ Avoid:**
* Giant documents mixing everything
* Ambiguous titles like "Info.docx"
* Skipping heading levels (H1 โ H3)
* References to "the above" or "as mentioned"
**Key principle:** Each paragraph should work independently. AI can read isolated fragments.
**๐ฏ Complete context always:**
* Include specific names, dates, places
* Don't use references like "this", "the above", "as mentioned"
* Each sentence should be self-sufficient
**Writing examples:**
โ
**Excellent:**
> "The Xiaomi smartphone warranty covers factory defects for 12 months from purchase in Mexico, excluding water damage or impacts."
โ **Problematic:**
> "It has 12 months coverage, but doesn't include external damage."
**๐ Clear and consistent language:**
* Short and direct phrases (maximum 25 words)
* One term per concept ("customer" OR "user", not both)
* Define acronyms: "CRM (Customer Relationship Management)"
* Avoid technical jargon without explanation
**Quick trick:** Read each paragraph out of context. Is it completely understood? If not, add more context.
**Why it's important:** AI learns patterns. Documents with similar structure improve response accuracy.
**๐ ๏ธ Product sheet template:**
```
# [Product Name]
## General description
[What it is and what it's for]
## Technical specifications
[Detailed features]
## Prices and availability
[Current price information]
## Frequently asked questions
[3-5 real customer questions]
## Contact and support
[How to get specific help]
```
**๐ข Company information template:**
```
# [Company Name]
## Who we are?
## Main services
## Location and hours
## Contact methods
## Important policies
```
Create a master document with your template and duplicate it for each new content. This guarantees automatic consistency.
**Winning strategy:** Include the REAL questions your customers ask, not the ones you think they should ask.
**๐ Recommended format:**
```
## Frequently Asked Questions
**Q: Do you ship on weekends?**
A: We ship Monday through Friday. Friday orders are processed the following Monday.
**Q: Can I cancel my order?**
A: You can cancel at no cost up to 2 hours after confirming your order by calling 555-0123.
```
**๐ฏ Sources of real questions:**
* Customer support chat
* Support emails received
* Social media comments
* Frequent sales questions
**โ Avoid vague answers:**
* "It depends on each case"
* "Contact for more information"
* "Subject to availability"
Update FAQs monthly with new real questions. An updated knowledge base = better conversions.
**Common problem:** AI doesn't distinguish between versions. If it finds conflicting information, it can mix incorrect answers.
**๐ฏ Single source strategy:**
* One fact = One place
* Delete old versions before uploading new ones
* Use file names with dates for version control
**Problematic examples:** โ `warranty-v1.pdf` says 6 months โ `warranty-final.pdf` says 12 months โ `warranty-updated.pdf` says 24 months
**Result:** AI could answer "between 6 and 24 months" ๐ฑ
**โ
Solution:**
* Only keep: `warranty-march-2025.pdf` with updated information
* Delete all previous versions
Before uploading an updated document, delete the previous version from the knowledge base. AI cannot distinguish which is the "correct" version.
**Golden rule:** An outdated knowledge base is worse than having no knowledge base.
**๐
Recommended maintenance calendar:**
**Weekly:**
* Review new customer questions
* Update promotions or temporary prices
**Monthly:**
* Audit AI agent responses
* Add new identified FAQs
* Verify policy validity
**Quarterly:**
* Complete review of entire base
* Remove obsolete information
* Update contact information and hours
**๐ฏ Indicators you need to update:**
* Customers mention incorrect information
* Changes in products, prices, or policies
* New frequently asked questions not covered
* Agent can't answer current topics
**Name your files with dates:** `prices-january-2025.pdf` is better than `new-prices.pdf`. It will help you identify what needs updating.
***
## ๐ข Industry-specific guides
Each sector has critical information that your agents MUST know to be effective:
**Essential information:**
* Specific hours by specialty
* Available procedures and requirements
* Approximate costs and payment methods
* Typical wait times
* Exact location and parking
* Cancellation/rescheduling policies
**Optimized example:**
> "Dr. Lopez (cardiology) sees patients Tuesdays and Thursdays 9:00 AM to 1:00 PM in Office 205. Consultation cost: \$800 MXN. Requires medical referral. Free parking available."
**Essential information:**
* Current inventory with exact prices
* Detailed property characteristics
* Zone/location with landmarks
* Purchase/rental process step by step
* Financial requirements and documentation
* Additional costs (maintenance, services)
**Optimized example:**
> "House in Polanco, 3 bedrooms, 2 bathrooms, 120mยฒ. Price: 2,500/month. Minimum down payment: 30%. Available for immediate delivery."
**Essential information:**
* Exact enrollment and start dates
* Specific academic requirements
* Itemized costs (tuition, materials, extras)
* Available modalities (in-person, virtual, hybrid)
* Hours by program/level
* Complete admission process
**Optimized example:**
> "Master's in Digital Marketing: Start January 15, 2025. Hybrid modality (Saturdays in-person 8am-2pm + virtual classes Tuesdays 7pm-9pm). Cost: \$48,000 per semester. Requirement: bachelor's degree in related fields."
**Essential information:**
* Real-time inventory
* Prices with applicable discounts
* Accepted payment methods
* Detailed shipping policies
* Warranties and return policies
* Comparisons with similar products
**Optimized example:**
> iPhone 15 Pro 256GB available in blue and black. Price: $25,999 MXN (12 months interest-free). Free shipping in CDMX (24-48hrs). 1-year Apple warranty + optional theft insurance $299
**Essential information:**
* Available models with specifications
* Final prices (with taxes)
* Financing plans
* Specific warranties by component
* Included maintenance services
* Dealership/shop locations
**Optimized example:**
> Nissan Versa 2024 Sense MT: $259,900 MXN final price. Engine warranty 5 years/100,000km. Financing from $4,890/month at 60 months. Free maintenance first 2 services. Available at Satelite dealership.
## ๐ Next steps to implement
Use the initial checklist to identify what information you're missing.
Apply specific recommendations for your sector.
Structure information using suggested templates.
Test your AI agent and adjust the base according to results.
**Need specific help?** Each industry has unique nuances. If your sector isn't covered here, apply general principles and focus on the most frequent questions from your real customers.