Guides

Training Your Agent

Best practices for adding content and improving your AI agent's response quality

Your AI agent is only as good as the knowledge you give it. This guide covers how to build a high-quality knowledge base that enables accurate, helpful responses.

How Your Agent Learns

FutureBase agents don't "learn" in real time — they reference the knowledge base you build. When a customer asks a question, the agent searches your content for the most relevant information and uses it to generate an answer.

This means the quality of your content directly determines the quality of your agent's responses.

The Knowledge Page

Everything your agent reads lives on its Knowledge page. Open it from Knowledge in the sidebar. The page has two tabs:

  • Overview — how much your agent knows, what needs attention, and how fresh each source is. New agents without any knowledge start on the Sources tab instead.
  • Sources — the Add box and every source your agent learns from: your website, your files, your FAQs and snippets, and connected apps like Notion and Slack.

The header also has a search box that finds any page, FAQ, file or synced item by its title, address or text, an Ask your agent button for testing answers, and an Add button that takes you to the Add box.

Adding Knowledge

The quickest way to add anything is the Add box at the top of the Sources tab. Paste a link, drop files, or type a question your customers ask, and it offers the right action:

You enterThe Add box offers
A website address, like northwind.comImport the whole website, or Add only the homepage
A page address, like northwind.com/docs/introAdd this page, or Add everything under /docs/* for that section
A question ending in ?Create FAQ with that question; you write the answer next
Longer text, like a policy or price listSave as a text snippet (up to 50,000 characters)
A help center, like northwind.zendesk.comImport help center
A Google Docs, Sheets, Slides or Drive linkAdd from Google Drive, or Connect Google Drive first
Anything elseSearch your knowledge for it

Below the Add box, tiles let you Drop files, Paste text, connect Notion, Slack and Google Drive, or Forward emails to your agent.

Your Website

Your website is usually the best place to start. Import it once and your agent reads every page it finds, then keeps it up to date on your plan's schedule.

When you create an agent during sign-up, FutureBase first shows you what it found on your site before it learns anything. See Reviewing what onboarding found.

Import your site

Type your website's address in the Add box and choose Import the whole website. FutureBase finds your pages through your sitemap and the links between them, within your plan's page limit. Pages you already have stay as they are.

Choose which pages your agent reads

On the Sources tab, open your website's source (it's named after your site, like northwind.com) and set its rules under Which pages your agent reads:

  • Only import pages under — limit imports to sections such as /docs/* or /help/*. Leave it empty to import every page of the site.
  • Never import — skip sections such as /careers/* or /blog/*.
  • Capture FAQs from pages — questions and answers found on your pages are added as FAQs, marked From website.
  • Add new pages automatically — new pages that match your rules are added when your site is refreshed.

Use * to match anything. Changing the rules starts a check of your site right away: pages the rules now leave out move to Removed, and pages they now let in are added (with Add new pages automatically on) or listed under New on site.

Review the pages

Your website source lists every page with its indexing status. Open a page to see what your agent reads from it, or select several pages to enable, disable, re-sync or delete them at once. When you delete pages, you can also skip them in future imports.

Reviewing what onboarding found

When you enter your website during sign-up, FutureBase reads your homepage and finds your pages, then stops and shows Here's what we found. Nothing is added to your agent until you choose Teach my agent.

  • Sections of your site: your main pages, and one group per section such as /docs or /blog, each with its page count and a few example paths.
  • Help center: when your homepage links to a help center on its own address (like help.yoursite.com, or one hosted by a help desk tool), its articles appear as their own group. Your agent learns them into a separate Help center source that refreshes like your website.
  • Documents: PDF and Word files your site links to. Each one counts as a page.
  • FAQs: when your site has an FAQ page, Capture FAQs turns its questions and answers into FAQs your agent answers word for word.

Untick anything your agent shouldn't learn. Sections you untick are added to your website's Never import rules, so later checks skip them too. The footer shows how many pages your plan lets your agent learn, for example "Learning 50 of 132 pages on the Free plan; the most useful first". Your agent reads the most useful pages first: the homepage, pricing, FAQ and help pages, then everything else.

Once you confirm, your agent learns your key pages first. When they're read, you can ask it a test question and see the pages it answered from. The rest of your pages are read in the background.

If you leave before confirming, the Sources tab shows a Finish setting up your agent card that takes you back to the review.

Keeping your website up to date

Your website source checks your site on a schedule that depends on your plan:

PlanAutomatic refresh
FreeOff
HobbyWeekly
Standard and ProDaily

The website source shows when it last checked your site and when the next check is due. Choose Check now to check right away, for example after you change a page. You can check each source up to six times an hour. On the Free plan, Check now is how your agent picks up changes.

Each check:

  • Reads changed pages again. Pages that haven't changed since the last check are skipped, so a check is quick and cheap.
  • Finds new pages. With Add new pages automatically on, new pages that match your rules are added within your plan's page limit. Otherwise they're listed on the source's New on site tab, where you can Add them, Skip this folder, or Dismiss them.
  • Removes pages that are gone. A page that returns a 404, now redirects elsewhere, no longer appears in your sitemap, or matches a Never import rule moves to the Removed tab. Your agent stops answering from it right away. Choose Undo within 7 days to bring it back; after that it's deleted for good. If a check would remove more than half of your site at once, it removes nothing and checks those pages one by one instead.

Pages you delete yourself are never added back by a check.

Your Help Center

If your help articles live in Zendesk, Intercom, Help Scout, Mintlify, GitBook or Freshdesk, paste the help center's address in the Add box and choose Import help center. It becomes its own Help center source that refreshes on the same schedule as your website. See Importing a Help Center.

Forwarded Emails

Forward an email to your agent's own address and it learns it: the email becomes a text snippet, and its PDF and Word attachments become files. Only emails from your team's verified addresses are learned. See Forwarding Emails to Your Agent.

Pages from Your Browser

With the browser extension, click Add this page on any page you have open, even one behind a login, and it's added to a Single pages source. Those pages aren't refreshed automatically: add a page again when it changes. See Browser Extension.

FAQs and Text Snippets

FAQs are the most effective content for customer support. They give your agent direct question-and-answer pairs, which often produce the most precise answers. When a customer's question closely matches an FAQ, your agent uses that answer.

Open the FAQs & snippets source to:

  • Add FAQ — write a question and its answer.
  • Paste text — save a policy, note or price list as a text snippet.
  • AI Suggestions — get suggested FAQs to review and add.
  • Import / Export — import FAQs from a file, or export them as JSON or CSV.

FAQs captured from your website appear here too, marked From website. Text snippets count toward your plan's FAQ limit.

Tips for writing great FAQs:

  • Write questions the way customers would actually ask them
  • Include variations — "How do I cancel?" and "How to cancel my subscription" can both be useful
  • Keep answers concise but complete
  • Group related questions together

Files

Upload documents that contain information customers ask about, such as product documentation, policies, technical specifications or training manuals.

Drop files on the Add box, or open the Files source and drop several files at once. Each file shows its upload and indexing progress.

Supported file types: PDF, Word (.docx), text, Markdown, CSV, JSON and HTML

File size limit: Up to 0.5 MB per file on Free, 5 MB on Hobby, 10 MB on Standard and 25 MB on Pro.

Connected Apps

Connect Notion, Slack or Google Drive to keep your agent in sync with the knowledge your team already writes there. Each connected app appears as its own source, where you can see its synced items, choose Sync now, or Manage the connection.

Keeping Knowledge Healthy

The Overview tab shows what needs your attention. Needs attention lists, in order:

  • Couldn't read: items your agent couldn't read, so it can't answer from them. Choose Retry to read an item again, Upload as file instead when a page blocks automated reading, or Exclude to stop using it.
  • Outdated FAQs: FAQs captured from your site that you edited, when the page now says something different. (Captured FAQs you haven't edited update by themselves.) You see your answer next to the site's, word by word. Choose Update FAQ to take the site's answer, Keep mine to keep yours, or delete the FAQ. Update all takes the site's answer for every one. When a question is gone from its page, you can keep or delete the FAQ.
  • Conflicting answers: two items that say different things about the same fact, like a page saying refunds take 30 days and an FAQ saying 14. See Conflicting answers.
  • New on your site: pages a check found that your agent doesn't read yet, per website. Choose Add all, or Review to pick them on the source's New on site tab.
  • Removed from your site: pages a check removed, with why and when each is deleted for good. Choose Undo (or Undo all) within 7 days to bring them back.
  • Not used lately: items no answer used in the last 90 days. See Unused items.

When nothing needs you, it says All clear. Freshness shows when each source was last indexed or synced.

Click any item, in a list or in search results, to see what your agent reads from it, which source it belongs to, how often answers used it in the last 30 days, and when it was last indexed. From there you can enable, disable, re-sync or delete it.

Conflicting Answers

When two items contradict each other, your agent could give a customer either answer. Each time an item is added or changes, FutureBase compares the facts it states (prices, durations, limits and the like) with the closest passages in the rest of your knowledge, and flags the pairs that can't both be true. Differences of plan, region, date or scope, like a different price on another plan, aren't flagged.

Each conflict shows the fact they disagree on and both sides next to each other: the item, what it says, and the sentence that says it. Then:

  • Trust this one: your agent answers from that side. The other side's sentence is taken out of what your agent reads from its item (the item itself isn't changed); when the other side is an FAQ, that FAQ is turned off instead.
  • Edit: fix the wording yourself. An FAQ opens in the FAQ editor; otherwise you add an FAQ with the right answer. Saving clears the conflict.
  • Dismiss: both are right, for example because they cover different cases. The same two sentences aren't flagged again.

Sentences you took out are listed under Excluded passages when you open their item. Choose Restore to put one back.

Checks start a few minutes after your content changes, so a large import is compared in a few batches. Each workspace compares a limited number of passages per day; anything left is checked the next day.

Unused Items

Items your agent never reaches for are often outdated: an old campaign page, last year's price list. Not used lately counts the enabled items that no answer used in the last 90 days.

  • Review lists them all in one table, where you can disable or delete them, or choose Keep for ones you still need. Kept items aren't listed again.
  • Disable all turns them all off after you confirm. They stay in their sources, and you can enable any of them again.

The list needs 90 days of answers to mean anything, so it appears once your agent has been answering questions for 90 days, and has answered enough of them. Until then, the Overview says when it will be available.

Ask Your Agent

Choose Ask your agent to ask a question the way a customer would. You see the answer and the knowledge items your agent used, so you can tell which content to fix when an answer is wrong. Test questions use AI credits but aren't saved as conversations.

Improving Response Quality

Once you have content in your knowledge base, here are some strategies to improve responses.

Fill Knowledge Gaps

Review your Conversations tab to see what customers are asking. If your agent is struggling with certain topics, add content that covers those areas.

Be Specific

Vague content leads to vague answers. Instead of:

"We offer flexible pricing plans."

Write:

"We offer three pricing plans: Starter at $9/month, Pro at $29/month, and Enterprise with custom pricing. All plans include the AI chat widget and basic analytics."

Keep Content Current

Outdated information is worse than no information. Regularly review and update your knowledge base, especially after:

  • Product or pricing changes
  • New feature launches
  • Policy updates
  • Seasonal promotions

Test Before You Go Live

Before going live with changes, ask your agent about the content you just added with Ask your agent on the Knowledge page, or chat with it through your shareable chat link (Channels → Share link), to verify the answers are accurate.

Avoid adding duplicate or contradictory content. If two pieces of content give conflicting answers, the agent may produce inconsistent responses. Conflicting answers on the Overview points out the contradictions it finds.

Content Priority

When adding content, prioritize in this order:

  1. FAQs — highest signal-to-noise ratio
  2. Core product pages — features, pricing, how-to guides
  3. Support documentation — troubleshooting, setup guides
  4. Policy pages — refunds, shipping, privacy
  5. Blog posts — useful for product context, but lower priority

On this page