Content Quality

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:

  1. Open Knowledge in the sidebar and go to the Sources tab
  2. Type the address of the website you're adding the agent to (e.g. yoursite.com) in the Add box
  3. 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:

  1. Paste the page's address in the Add box on the Sources tab
  2. Choose Add this page
  3. Repeat for each page you want your agent to read

Create FAQs for Critical Questions

Identify questions that need exact answers:

  1. 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
  2. Write a clear question and a complete, self-contained answer
  3. 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:

  1. Drop the files on the Add box on the Sources tab, or open the Files source
  2. Upload PDF, Word, text, Markdown, CSV, JSON or HTML files, several at once if you like
  3. 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:

  1. Check your content: Is the answer actually on your website or in your documents?
  2. Add an FAQ: Create a specific FAQ for that question
  3. Refine wording: Make sure the answer is clear and unambiguous
  4. 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:

  1. FAQ exact matches: If the question closely matches an FAQ, that answer is used
  2. Semantic search: The system finds the most relevant content from all sources
  3. Re-ranking: Results are re-ranked by relevance to the specific question
  4. 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:

  1. Create a test sheet with common questions
  2. Ask each question with Ask your agent on the Knowledge page. You see the answer and the knowledge items it used
  3. Evaluate whether answers are accurate and complete
  4. 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:

  1. Review conversations: Check the conversation history for missed or incorrect answers
  2. Identify patterns: Look for commonly asked questions that aren't covered
  3. Add FAQs: Create FAQs for recurring questions
  4. Update content: Keep your website and documents current
  5. Check the Overview: After each website check, resolve what it found under Needs attention
  6. 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

SignalWhat it meansWhat you can do
Couldn't readYour agent couldn't read a page, file or item, so it can't answer from itRetry, Upload as file instead, or Exclude
Outdated FAQsA captured FAQ you edited no longer matches its page, or its question is goneUpdate FAQ, Keep mine, or delete it
New on your siteA check found pages your agent doesn't read yetAdd all, or Review them one by one
Removed from your siteA page returned a 404, redirects elsewhere, left your sitemap or matches a skip ruleUndo 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:

StateWhat it means
CoveredAt least 80% of its questions were answered from your knowledge, and nothing it relies on needs a fix
Needs fixYour agent answers it, but not reliably, or from an item flagged under Needs attention
GapYour 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:

  1. Go to Settings → AI Configuration
  2. Add a custom system prompt to guide the AI's tone and behavior
  3. 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

On this page