Improving Content Quality
Learn how to optimize your chatbot's knowledge base for accurate, consistent responses
Your agent's answer quality directly depends on the content you provide. This guide explains how to use the Knowledge page to improve answer accuracy and consistency. For a tour of the page itself, see Training Your Agent.
Content Types Overview
Every source your agent learns from appears on the Sources tab of the Knowledge page:
Website
Import your website and your agent reads its pages:
- Whole site: Enter your website's address to import the pages found through its sitemap and links
- Single pages: Add specific pages you want your agent to read
- Rules: Import only some sections (like
/docs/*) and never import others (like/careers/*) - Automatic refresh: Off on Free, weekly on Hobby, and daily on Standard and Pro. Check now checks your site right away on any plan
- Changes and removals: Each check reads changed pages again, lists new pages under New on site (or adds them, if you turn on Add new pages automatically), and moves pages that are gone to Removed, where Undo brings them back for 7 days
- Help centers: A help center on its own address (like
help.yoursite.com) can be its own source, kept up to date the same way
Imports only read publicly accessible pages, within your plan's page limit. To add a page behind a login, use the browser extension.
FAQs (Frequently Asked Questions)
FAQs provide deterministic, verbatim answers for specific questions:
- Use for: Pricing details, refund policies, legal information, or any answer that must be exact
- How it works: When a user question closely matches an FAQ, the AI uses that answer directly
- Best practice: Write one clear question per FAQ entry
FAQs override general website content. Use them strategically for high-stakes questions that require precise answers.
Document Uploads
Upload files directly to your agent's knowledge:
- Supported formats: PDF, Word (.docx), text, Markdown, CSV, JSON and HTML
- Use for: Internal documentation, product manuals, or content not on your public website
- Size limits: Vary by plan (see dashboard for your limit)
Text Snippets
Paste policies, notes or price lists as text snippets of up to 50,000 characters. Snippets count toward your plan's FAQ limit.
Pages from your browser
The browser extension adds the page you're on, including pages behind a login, to a Single pages source. Those pages aren't refreshed automatically; add a page again when it changes.
Connected Apps
Connect apps like Notion, Slack and Google Drive to sync content automatically (see Integrations section). Each one appears as its own source.
Step-by-Step: Optimizing Content Quality
Start with Your Website
Begin by adding your main website:
- Open Knowledge in the sidebar and go to the Sources tab
- Type the address of the website you're adding the agent to (e.g.
yoursite.com) in the Add box - Choose Import the whole website
FutureBase finds your pages through your sitemap and links, reads them, and makes them searchable. To import only some sections, open your website's source and set Only import pages under, then choose Import more pages.
If you set up your agent during sign-up, you already did this step: FutureBase showed you the sections, help center, linked documents and FAQ page it found, and learned only what you kept.
Add Key Pages One by One
If you have important pages the import didn't find:
- Paste the page's address in the Add box on the Sources tab
- Choose Add this page
- Repeat for each page you want your agent to read
Create FAQs for Critical Questions
Identify questions that need exact answers:
- Type the question in the Add box on the Sources tab and choose Create FAQ, or open the FAQs & snippets source and click Add FAQ
- Write a clear question and a complete, self-contained answer
- Save it. Your agent uses the answer once it's indexed
FAQ Writing Tips:
- Write answers as if speaking directly to a customer
- Include all necessary context in the answer (don't rely on the AI to add details)
- Keep one intent per FAQ (avoid multi-part questions)
- Use simple, jargon-free language
Upload Supporting Documents
Add documents that complement your website content:
- Drop the files on the Add box on the Sources tab, or open the Files source
- Upload PDF, Word, text, Markdown, CSV, JSON or HTML files, several at once if you like
- The content is extracted and indexed automatically
Content Quality Best Practices
Writing Effective FAQs
FAQs are your most powerful tool for controlling agent responses:
❌ Bad FAQ:
Q: How do refunds work?
A: Contact support for refunds.
✅ Good FAQ:
Q: How do I request a refund?
A: Refunds are available within 30 days of purchase. To request a refund, email [email protected] with your order number. Refunds are processed within 5-7 business days and returned to your original payment method.Organizing Website Content
Help the AI find relevant information:
- Clear structure: Use descriptive headings and subheadings
- Focused pages: Keep each page on a single topic
- Updated content: Remove or update outdated information
- Avoid duplicates: Don't publish the same information in multiple places
Handling Edge Cases
For questions the AI consistently gets wrong:
- Check your content: Is the answer actually on your website or in your documents?
- Add an FAQ: Create a specific FAQ for that question
- Refine wording: Make sure the answer is clear and unambiguous
- Remove noise: If irrelevant pages are being retrieved, disable them, or delete them and skip them in future website imports. Deleted pages are never added back by a website check
Content Priority System
When a user asks a question, the system retrieves content in this order:
- FAQ exact matches: If the question closely matches an FAQ, that answer is used
- Semantic search: The system finds the most relevant content from all sources
- Re-ranking: Results are re-ranked by relevance to the specific question
- Top content: The top 3-5 most relevant pieces are sent to the AI
FAQs act as "answer overrides" — they take precedence over general website content when there's a close match.
Testing Your Content
Before launching your agent:
- Create a test sheet with common questions
- Ask each question with Ask your agent on the Knowledge page. You see the answer and the knowledge items it used
- Evaluate whether answers are accurate and complete
- For incorrect answers, open the items it used and refine them, or add FAQs
Quality Checklist
- All key pages are indexed (check your website source on the Sources tab)
- Needs attention on the Overview tab says All clear: nothing under Couldn't read, Outdated FAQs, New on your site or Removed from your site
- Top 10-20 common questions have dedicated FAQs
- No outdated or contradictory information in indexed content
- Documents are up-to-date and relevant
- Test questions return accurate answers in Ask your agent
Monitoring & Iteration
After launch:
- Review conversations: Check the conversation history for missed or incorrect answers
- Identify patterns: Look for commonly asked questions that aren't covered
- Add FAQs: Create FAQs for recurring questions
- Update content: Keep your website and documents current
- Check the Overview: After each website check, resolve what it found under Needs attention
- Close gaps: Under Topic coverage, turn the topics your agent couldn't answer into FAQs or point them to a page
What the Overview flags after a website check
| Signal | What it means | What you can do |
|---|---|---|
| Couldn't read | Your agent couldn't read a page, file or item, so it can't answer from it | Retry, Upload as file instead, or Exclude |
| Outdated FAQs | A captured FAQ you edited no longer matches its page, or its question is gone | Update FAQ, Keep mine, or delete it |
| New on your site | A check found pages your agent doesn't read yet | Add all, or Review them one by one |
| Removed from your site | A page returned a 404, redirects elsewhere, left your sitemap or matches a skip rule | Undo within 7 days; after that it's deleted for good |
Topic coverage: what customers ask and where your agent falls short
Once your agent has had 50 conversations in the last 30 days, the Overview shows Topic coverage. Every day, FutureBase groups your customers' questions from the last 30 days into topics, like "Refunds for damaged items" or "Changing a delivery address", and checks how each one went.
The ring at the top shows how many questions your agent answered from your knowledge: it found a page, FAQ or file to answer from, the customer wasn't handed to your team, and nobody gave the answer a thumbs down. Below it, each topic shows how many questions it got, how many sources your agent answered from, and a state:
| State | What it means |
|---|---|
| Covered | At least 80% of its questions were answered from your knowledge, and nothing it relies on needs a fix |
| Needs fix | Your agent answers it, but not reliably, or from an item flagged under Needs attention |
| Gap | Your agent had nothing good to answer from: under 40% answered, or no source at all |
Open a Gap to fix it in place:
- Approve & add as FAQ: FutureBase drafts an answer from how your team replied to these questions in the inbox, and from your knowledge. Edit the question and answer, then approve it. The FAQ is added to FAQs & snippets and your agent uses it from the next conversation. Drafts leave out names, order numbers and email addresses, and nothing is published until you approve it.
- Point to a page: pick the page, FAQ or file that answers the topic, or paste a page's address to add it. FutureBase checks the topic against it as new questions come in.
- Not something we answer: hides the topic. Those questions keep going to your team. Show hidden brings it back.
A topic you fixed counts as covered until at least 5 new questions come in; after that, it's judged on how those questions went. Topics refresh every morning; use the refresh button next to the ring to recompute them sooner.
Before your agent reaches 50 conversations, the Overview shows how many it has had so far this month. Use Ask your agent to test questions in the meantime.
The more you refine your content, the better your agent performs. Content quality is an ongoing process, not a one-time setup.
Common Content Issues
The agent gives generic answers
Cause: Not enough specific content on the topic
Solution:
- Add detailed documentation or FAQs for that topic
- Upload supporting documents
- Add the pages that cover it with Add this page
The agent contradicts itself
Cause: Multiple sources contain different information
Solution:
- Remove or update outdated content
- Create an FAQ with the correct answer to override inconsistencies
- Ensure all content sources are aligned
Answers are too verbose or rambling
Cause: Retrieved content includes irrelevant sections (navigation, footers, etc.)
Solution:
- Improve page structure with clear headings
- Use FAQs for concise answers
- Disable pages that add noise without value
The agent doesn't know about recent updates
Cause: Your website hasn't been checked since the change
Solution:
- Open your website source and choose Check now. Changed pages are read again; unchanged ones are skipped
- Update or re-upload changed documents
- Check your website source's refresh schedule: automatic refresh is off on Free, weekly on Hobby, and daily on Standard and Pro
Advanced: Custom System Prompts
For fine-tuned control over how the AI responds:
- Go to Settings → AI Configuration
- Add a custom system prompt to guide the AI's tone and behavior
- Example: "Always be concise. Never apologize. Use bullet points for lists."
Custom system prompts are advanced. Only use them if the default behavior doesn't meet your needs.
Next Steps
- Set up integrations to sync content automatically
- Customize your agent's chat widget in Channels → Chat bubble → Appearance
- Put your agent on your site from Channels