Knowledge Library
The Knowledge Library is where you teach your AI agents about your business. The more relevant knowledge you add, the better your agents will answer questions.
Accessing Knowledge
- Click Knowledge Base in the left menu under "AI Configuration"
- You'll see all your knowledge items organized by type
Types of Knowledge
Your Knowledge Library can contain several types of information:
| Type | Icon | Description |
|---|---|---|
| Business Profile | Building | Core business details: name, address, hours, services |
| FAQ | Help Circle | Question-and-answer pairs for common inquiries |
| Website | Globe | Content imported from your website |
| Document | File | PDFs and text files with detailed information |
| Text | Text | Custom text content you write directly |
| Image | Image | Product images, diagrams, or visual materials |
| Audio | Audio | Audio files with information your agent can reference |
Business Profile
Your Business Profile is the foundation of your agent's knowledge. It contains essential business information that your agent needs to answer basic questions.
What's Included
| Field | Example |
|---|---|
| Business Name | "Sunshine Plumbing" |
| Address | "123 Main St, Portland, OR 97201" |
| Phone | "(555) 123-4567" |
| "info@sunshineplumbing.com" | |
| Website | "www.sunshineplumbing.com" |
| Hours | "Mon-Fri 8am-6pm, Sat 9am-2pm" |
| Services | "Drain cleaning, water heaters, bathroom remodels" |
| Business Types | "Plumber, Home Services" |
Creating a Business Profile
- Click Add Knowledge
- Select Business Profile
- Fill in your business details
- Click Save
You can only have one Business Profile. All agents in your account share it.
FAQs
FAQs (Frequently Asked Questions) are the easiest way to improve your agent's answers. Each FAQ pairs a question with its answer.
Creating FAQs
- Click Add Knowledge
- Select FAQ
- Add question-answer pairs:
- Question: How a customer would ask it
- Answer: The response your agent should give
- Click Save
Writing Effective FAQs
Question Best Practices
Write questions the way customers actually ask them:
- "How much does a haircut cost?" (natural)
- "What is the price for hair cutting services?" (too formal)
Include variations if customers ask the same thing different ways. Your agent can match similar questions.
Answer Best Practices
Keep answers:
- Conversational — Write how you'd speak
- Specific — Include actual numbers, prices, times
- Complete — Answer the full question
- Brief — Don't ramble; get to the point
FAQ Examples
Service Business:
| Question | Answer |
|---|---|
| How much is a service call? | Our standard service call is $89, which covers the first hour of diagnosis. Most repairs range from $150-$500 depending on parts needed. |
| Do you handle emergencies? | Yes! We offer 24/7 emergency service. There's an additional $75 after-hours fee for nights, weekends, and holidays. |
| What areas do you serve? | We serve the greater Portland metro area including Beaverton, Tigard, Lake Oswego, and Milwaukie. |
Salon/Spa:
| Question | Answer |
|---|---|
| Do I need an appointment? | Yes, we're appointment-only. Walk-ins may be accepted if we have availability, but we recommend booking ahead. |
| What's your cancellation policy? | Please give us 24 hours notice to cancel or reschedule. Late cancellations may be charged a $25 fee. |
Review your Conversations regularly. When customers ask new questions, add them as FAQs!
Website Content
Import content directly from your website so your agent can answer questions about your services, products, and policies.
Adding a Website
- Click Add Knowledge
- Select Website
- Enter your website URL
- Set the Page Limit (how many pages to scrape)
- Click Save
Import Process
Your website import goes through these stages:
| Status | Meaning |
|---|---|
| Pending | Queued for processing |
| Scraping | Currently reading your website pages |
| Training | Converting content into searchable knowledge |
| Completed | Ready to use |
| Failed | Something went wrong (check the error message) |
What Gets Imported
The system will try to import:
- Main pages and subpages
- About, Services, and Pricing pages
- FAQ and Help pages
- Blog posts and articles
Not imported:
- Password-protected pages
- Very large files or media
- Complex web applications
- Shopping cart / checkout pages
Scheduled Re-scraping
You can set up automatic refreshes to keep your website knowledge current:
- Open the website knowledge item
- Look for the scheduling option
- Set how often to refresh (daily, weekly, monthly)
Documents
Upload PDFs and text files containing detailed information.
Supported File Types
- PDF — Service menus, price lists, policies, brochures
- TXT — Plain text files
Uploading a Document
- Click Add Knowledge
- Select Document
- Drag and drop your file, or click to browse
- Give it a descriptive name
- Click Save
Processing Time
Documents are analyzed and converted to searchable knowledge. Processing time depends on document size. You'll see:
- Processing — Being analyzed
- Completed — Ready to use
- Failed — Couldn't process (try a different format)
Good Documents to Upload
- Detailed service menus with pricing
- Price lists and catalogs
- Policy documents (returns, cancellations, warranties)
- Product specifications
- Training guides or manuals
- Legal disclaimers
Text Content
Create custom text content directly in the dashboard.
When to Use Text
- Quick notes or information not in a document
- Custom instructions for specific scenarios
- Supplementary details that don't fit elsewhere
Adding Text
- Click Add Knowledge
- Select Text
- Enter a Name for this content
- Write your content in the text area
- Click Save
Images
Upload images that provide visual information your agent can understand and describe.
Supported Formats
- PNG, JPG, GIF, WebP
Use Cases
- Product photos with details your agent can describe
- Diagrams or charts
- Before/after examples
- Menu boards or signage
Audio Files
Upload audio content that will be transcribed and added to your knowledge base.
Supported Formats
- MP3, WAV, M4A
Use Cases
- Recorded training sessions
- Podcast episodes about your business
- Voice recordings with important information
Managing Knowledge
Viewing and Filtering
The Knowledge Library offers several ways to organize your content:
| Control | Description |
|---|---|
| View Mode | Switch between grid and list views |
| Sort By | Sort by name, date, or type |
| Filter by Type | Show only specific types of knowledge |
| Date Filter | Show items from a date range |
| Search | Find items by name |
Editing Knowledge
- Click on any knowledge item
- Click Edit in the detail panel
- Make your changes
- Click Save
Deleting Knowledge
- Click on the knowledge item
- Click Delete
- Confirm the deletion
Deleted knowledge cannot be recovered. Make sure you have a backup if needed.
Assigning Knowledge to Agents
Knowledge items must be assigned to agents to be used in conversations.
From the Agent Page
- Go to Agents → Select your agent
- Find the Knowledge Base section
- Click Add Knowledge
- Select items to assign
- Changes save automatically
From the Knowledge Library
Some knowledge types (like Business Profile) may be automatically available to all agents.
Knowledge Best Practices
Start with the Essentials
Begin with:
- Business Profile — Complete and accurate
- Top 10 FAQs — Most common customer questions
- Website import — If you have a website
Add more as you identify gaps.
Keep Information Current
Set a monthly reminder to:
- Update prices when they change
- Add seasonal services or promotions
- Remove discontinued services
- Add new FAQs from recent conversations
Be Specific, Not Generic
Instead of:
"We offer plumbing services"
Use:
"We offer drain cleaning ($89-$250), faucet repair ($75-$150), toilet installation ($200-$400), water heater replacement ($800-$2000), and full bathroom remodels (starting at $5000)"
Avoid Duplicate Information
Don't add the same information in multiple places. If your hours are in your Business Profile, you don't need an FAQ "What are your hours?"
The agent will find the information regardless of where it's stored.
Testing Your Knowledge
After adding knowledge, verify it works:
- Go to Agents → Select your agent
- Open the Test Chat panel
- Ask questions related to your new knowledge
- Verify the answers are correct
If answers aren't right:
- Check that knowledge is assigned to the agent
- Make sure the information is clear and specific
- Review for conflicting information
- Try rephrasing FAQ questions
Common Questions
How much knowledge can I add?
There's no hard limit, but quality matters more than quantity. Focus on:
- Most common customer questions first
- Information your agent needs to handle inquiries
- Details that require accuracy (prices, hours, policies)
Why didn't my website import correctly?
Common reasons:
- Pages behind a login or paywall
- JavaScript-heavy pages that don't render content server-side
- Very large websites hitting the page limit
- Network issues or timeouts
- Blocked by robots.txt or rate limiting
Try importing specific important pages individually.
How quickly does new knowledge work?
- FAQs and Text: Available within minutes
- Website imports: May take several minutes depending on size
- Documents: Processing time varies by file size
What if my agent gives wrong information?
- Check your knowledge base for incorrect data
- Look for conflicting information
- Update or remove inaccurate content
- Test again after making changes
If the information is correct in your knowledge but the agent is still wrong, it may be a prompt issue. Contact support.
Can I import from competitors' websites?
You should only import websites you own or have explicit permission to use. Importing competitors' content may violate copyright and terms of service.
Need Help?
- Check our Troubleshooting Guide
- Email support@needtheo.com