Knowledge Base overview

The knowledge base is everything your agent is allowed to talk about. You add sources such as website pages, documents, and Q&As, and your agent uses them to answer your visitors. This page explains how it all fits together before you dive into a specific source type.

8 min read Updated

Every source you add lives in one shared place, no matter where it came from. A scraped web page, an uploaded PDF, a hand-written Q&A, and a file imported from Google Drive all sit together in the same knowledge base for that agent. You manage them from the Knowledge Base area of the dashboard. Each source type has its own page in the sidebar under Knowledge Base: Website Links, Documents, FAQs, Business Context, Google Drive, OneDrive, and Notion, plus Wix and Shopify when your agent is connected to those apps.

Each agent has its own knowledge base. Sources you add to one agent are never shared with another. If you run several agents, you add knowledge to each one separately.
The Knowledge Base in the Ultimo Bots dashboard, listing sources with their status
The Knowledge Base, showing the sources an agent has learned from and the status of each one.

How your agent uses the knowledge base

Your agent does not memorize your content. Instead, it looks things up the moment a visitor asks a question. Behind the scenes, every source is split into small passages, and each passage is turned into a searchable representation (an embedding) so the agent can find the passages most relevant to a question.

When a visitor sends a message, the agent:

  1. Searches your knowledge base for the passages that best match the question.
  2. Reads those passages, along with a little surrounding context from the same source.
  3. Writes an answer grounded in what it found, rather than guessing.

This is why the quality of your answers depends on what you put in. The more clearly your content covers a topic, the better your agent can answer questions about it.

Answers come only from your knowledge base. Your agent answers from the sources you add, not from general world knowledge. If a topic is not covered, the agent will not have an answer for it. See Business Context for a place to add core facts that are not on your website.

The source types

You can build a knowledge base from any mix of the following sources. Each has its own page under Knowledge Base and its own dedicated guide. They all feed the same agent, so you can combine them freely.

  • Website links. Pages from your public website. Ultimo Bots reads each page and learns from its text.
  • Documents. Files you upload, such as PDF, DOC, DOCX, RTF, TXT, CSV, and Markdown. The text is extracted automatically.
  • FAQs. Exact question-and-answer pairs you write yourself, for replies you want to control word for word.
  • Business Context. A short text with the core facts about your business that goes into every answer, separate from your website.
  • Google Drive. Files imported from your Google Drive after you connect your account.
  • OneDrive. Files imported from Microsoft OneDrive after you connect your account.
  • Notion. Pages and databases imported from your Notion workspace.

Two more pages appear only when your agent is connected to the matching app under AI Studio → Apps: Wix shows the products and CMS collections your agent has from your Wix site, and Shopify shows everything your agent reads from your connected Shopify store. Without a connection, these pages are not in the sidebar.

Source typeBest for
Website linksContent already published on your site: products, services, pricing, and company pages.
DocumentsMaterial that is not on your website, such as handbooks, product sheets, and price lists.
FAQsCommon questions where you want one exact, on-brand answer every time.
Business ContextCore facts your agent may state in every answer, like what you offer, opening hours, or how to reach you. Tone belongs in Behaviors.
Google DriveTeams who keep their reference files in Google Drive.
OneDriveTeams who keep their reference files in Microsoft OneDrive.
NotionTeams who keep help articles or internal knowledge in Notion.

The status lifecycle

When you add a source, it does not become answerable instantly. Ultimo Bots reads the content, splits it into passages, and makes it searchable. Each source shows a status while this happens, and the list updates live, so you do not need to refresh the page.

StatusWhat it means
Scraping ProcessingThe source is being read and prepared. It shows a spinner and cannot be answered from yet. Large sites and big files take longer.
CompletedThe source is ready and your agent can answer from it on the next message.
FailedThe source could not be read, for example a page behind a login or a file with no readable text. Nothing was added for it.
Failed sources are retried, then wait for you. When a source fails, Ultimo Bots tries it automatically up to three times. If it still fails, the reason is shown next to it. Check that the page is public or the file has readable text, then select it and click Rescrape (website pages and Google Drive, OneDrive, or Notion imports), or remove it and add it again (uploaded documents). A failed source does not count toward your plan limit.

Preview, refresh, and delete

Once a source is ready, three actions help you keep your knowledge base accurate. You find them in the list on each source type's page.

Preview what the agent received

Use the view action on any completed source to open a preview of the exact text Ultimo Bots extracted from it. This is the single most useful check when an answer looks wrong: if the text is missing or garbled in the preview, the agent never had it either, and you can fix the source instead of guessing.

Keep sources fresh with rescraping

Your content changes over time. Website pages and imported files keep the text they had when you added them until you refresh them. You can do this in three ways:

  • Manual rescrape (every plan). Select one or more website pages, or imported Drive, OneDrive, or Notion items, and click Rescrape. Ultimo Bots reads the latest content and replaces the old version in place.
  • Check for updates (every plan). On the Website Links page, Check for updates scans your site once and lists new pages, pages to refresh, and pages that no longer exist. Nothing changes until you confirm. A freshness line next to it shows when your website knowledge was last refreshed and turns into a warning after 45 days.
  • Automatic rescraping (Boost: monthly; Ultimo: monthly or daily). Website pages are read again on a schedule, optionally adding new pages and removing pages that no longer exist. Google Drive, OneDrive, and Notion have their own sync schedule on their pages.

Exactly what a scheduled run refreshes, adds, and removes is explained in Website Links → Automatic rescraping.

FAQs and Business Context are edited, not rescraped. Because you write them yourself, you update them directly on their page and the change takes effect after it saves.

Delete sources you no longer need

For website pages, documents, and Google Drive, OneDrive, or Notion imports, tick one or more sources and click the trash button above the list, then confirm. FAQs have no checkboxes and are deleted one at a time with the trash icon on their row. Deleting a source removes both its stored text and the searchable data behind it, so your agent stops answering from it right away. Deleting frees up room against your plan limit.

Plan limits

Your plan sets how many knowledge sources an agent can hold in total, counted across every type together. Website pages, documents, FAQs, and Drive, OneDrive, and Notion imports all share the same allowance: each page, file, or Q&A is one source.

PlanKnowledge sources per agent
Free50
Smart200
Boost1,000
Ultimo10,000

A usage bar at the top right of the Knowledge Base pages shows where you stand, for example 180 / 200 knowledge sources used. Failed sources do not count. Business Context is a single free-text note, and products and Wix CMS collections are managed through Apps, so none of these count against the allowance either.

When you reach your limit, the usage bar shows an Upgrade button and adding more sources prompts you to upgrade (on Ultimo there is no Upgrade button; the dialog offers Contact Sales instead). Deleting sources you no longer need frees up room. See Plans & billing for what each plan includes.

What the knowledge base does not do

  • It does not answer from outside your sources. Your agent only uses the content you add. It does not browse the live web during a chat or pull in general knowledge.
  • It does not update on its own unless you ask it to. A source keeps its content until you rescrape it, apply the results of Check for updates, or a scheduled automatic rescrape runs. Editing your website does not change what the agent knows until the page is read again.
  • It cannot read what it cannot reach. Pages behind a login, files with no readable text, and image-only documents may come back as failed or with little content.
  • It is not instant. New and rescraped sources go through a short processing step before the agent can answer from them.

Next steps

Pick a source type to start adding knowledge: