Documentation / Knowledge Base / Knowledge base: how it works and why use it

Knowledge base: how it works and why use it

ES EN

The knowledge base lets your AI agents answer with your business's real information (your website, PDFs, Word documents) instead of relying on what they "know" in general. This page explains how it works and why it is done this way.

What it is and how it works

  1. You give it your content. You enter your website's sitemap (Agent8Ai reads only the public pages your robots.txt allows) and/or upload files: PDF, Word (.docx), text, Markdown or CSV.
  2. Agent8Ai splits it up and stores it. Each page or file is divided into fragments of a few sentences. For each fragment it stores the text and a "numeric fingerprint" (a vector) that represents its meaning. Everything lives on our servers in Europe, inside your organisation: no other account can see it.
  3. When a customer asks, the agent searches. The question is also turned into a fingerprint, and the fragments with the closest meaning (and containing the keywords) are found. Only the 6 most relevant reach the agent, which answers with them and, when helpful, gives the source link.
  4. It stays up to date. Websites are re-read every day: only what has changed is processed. Uploaded files are not re-read on their own: if they change, delete the old one and upload the new one.

Why a knowledge base and not just the prompt

The "prompt" is the agent's instruction text. It is the right place for short, stable things (who you are, how you speak, what not to do), but not for all of a business's information:

Prompt onlyWith a knowledge base
How much information fitsA few pages. A huge prompt confuses small models in particular.Hundreds of pages and documents.
Cost per messageAll the text travels with every message from every customer, with an AI cost each time.Only the fragments relevant to that question travel.
UpdatingBy hand: if you change a price or opening hours, you have to remember to edit the prompt.Automatic: change your website and the agent knows after the next read.
Made-up answersHigher risk: if it is not in the prompt, the model tends to fill the gap.It answers with what is written in your content, with a source link; if it is not there, it is told to say so.
Private documentsThey have to be pasted into the prompt.They are uploaded separately and can be stored in private mode (encrypted).

In practice they work together: the prompt carries what is stable, the agent's tools bring what changes instantly (for example, free slots in the calendar) and the knowledge base provides your business's "how each thing is done".

Public and private content

  • Public (default for websites): the text is stored for search by meaning and by words.
  • Private mode (files): the text is stored encrypted and searched by meaning only; it is never shown in the open.
  • Do not upload third parties' personal data (customer lists, histories, health data…). The knowledge base is for your business information; you are responsible for the content you upload.

What it costs

  • Reading or uploading content uses a small amount of AI credits, only the first time and when a page changes. Re-reading unchanged pages costs nothing.
  • Searching the base when answering a customer is not charged separately: what uses credits is the agent's reply, as always.

Limits

  • Your plan limits: Basic, 50 sources and 100 MB; Pro, 250 sources and 500 MB; Business, 1,000 sources and 2 GB; Enterprise, tailored.
    • What counts: a source is each website (through its sitemap) and each document you upload. Storage adds up your uploaded documents and the saved text of your websites.
    • When it is checked: when you add a website or upload a document. If it does not fit, you will see a notice: you can delete something or upgrade your plan. What you already have keeps working.
    • Where you see it: at the top of the knowledge base: “Your plan: X of 50 sources · Y of 100 MB”.
    • What is not cut: if a website you already have grows when it is read again, it keeps being read; the limit only stops new things you add.
  • Available from the Basic plan: the free and Lite plans do not include it. If your account ends the free Basic trial and moves to the free plan, your bases are kept but your agents stop consulting them and the section is hidden until you subscribe to a plan that includes it (from Basic).
  • Up to 5 knowledge bases per organisation, each with up to 5 sources and 20 files (max. 10 MB per file).
  • Only public pages, normal websites (ports 80 and 443) and those your robots.txt allows Agent8Ai's crawler to read.
  • The agent only states what is in your content: if something is not written there, it will say it does not know.

If the reading service fails

If the service that computes the fingerprints is unavailable, the chat is never blocked: it keeps answering. Search switches to an emergency mode using exact words in public content (no synonyms or private documents), and the panel shows a notice. New content is saved by words and completed automatically when the service returns.