Skip to content

Knowledge sources

Teach an agent from files, websites, text and questions with their answers.

On this page

Knowledge is what your agent answers from. The agent searches it for every question, so the quality of your answers depends on it more than on any other setting.

Open an agent and select the Knowledge tab. There are four kinds of source.

SourceBest forHow
FileManuals, policies, price lists, brochuresUpload a file: PDF, Word (.docx), text or Markdown, up to 20 MB each
WebsiteYour help centre, product pages, FAQAdd a website: crawl it, use its sitemap, or list pages
TextAnything not written down elsewhereAdd text: paste or write it; Markdown headings help
Q&A pairQuestions customers ask often, with the exact answer you wantAdd a Q&A pair

How training works

When you add a source, ikazebot reads it and splits it into short passages along its headings. It then stores each passage in a form that can be searched by meaning, not just by keywords. This is called training.

  1. 1You add a source
  2. 2Text is extractedPDF pages, Word headings…
  3. 3Split into passages
  4. 4Made searchableembeddings
  5. 5Agent can use it

Each source shows its status: Waiting to be trained, Training or Trained, or Failed with a reason you can act on. For example, "this PDF has no text layer — it is probably a scan". Large sources take a little longer; the page updates by itself.

Editing retrains automatically. Change a text or Q&A and select Save and retrain. Until the new version is ready, the agent keeps answering from the old one, so there is never a gap.

Add a website

  1. Select Add a website and choose how to find pages:
    • Crawl a site: give a start page, and ikazebot follows the links from it.
    • Use a sitemap: give your sitemap.xml address.
    • List pages: paste the exact addresses, one per line (up to 500).
  2. Optionally, add Leave out rules for pages the agent should not learn from. Each rule matches addresses that start with, end with, contain or exactly match a pattern, or that match a wildcard. Example: starts with /blog.
  3. Add it. Open the source to watch pages arrive, each marked Trained, Unchanged or Skipped, with a reason when skipped.

Good to know:

  • Your site's robots.txt is respected, and pages are fetched politely, one at a time.
  • Pages that show almost no text without JavaScript are reported, not silently dropped. Add their content as Text instead.
  • Websites resync every week. Unchanged pages are skipped, and removed pages disappear from the agent's knowledge. Select Resync to refresh straight away after a big change to your site.

Organise knowledge into categories

Once an agent knows a lot, group its sources into categories such as Rooms & rates, Booking & payment, Policies or Getting here.

  1. Select Categories, type a name and select Add. In the same window you can rename a category, move it up or down, or delete it.
  2. File a source with Move on its row, and choose a category or No category.
  3. Select a category at the top of the page to see only its sources. Anything you add while it is selected goes into it.

With All selected, sources appear in sections, in your categories' order, with sources in no category last.

Good to know:

  • Categories are for you, not for the agent. It searches every source whatever its category, so moving a source never retrains it.
  • Deleting a category keeps its sources. They move to No category; nothing the agent knows is removed.
  • An agent can have up to 30 categories, each with its own name.

Training limit

Each plan allows a certain amount of training text across the whole workspace (all agents together). The Knowledge page shows Training text in this workspace against your limit. When a source would go over the limit, it stops and says so.

Write knowledge that answers well

  • One topic per section, with a clear heading. The agent finds "Returns → Damaged items" more easily than a long page with no headings.
  • Use the words your customers use. If they say "money back", say "money back" as well as "refund".
  • Add Q&A pairs for your top 20 questions. They are short and precise, so they match well.
  • Remove outdated content. Old prices in an old PDF will be quoted.
  • After adding knowledge, ask the question in the Playground and open Inspect reply to check the right passage was found.

Delete a source

Deleting a source removes it from the agent's knowledge at once. An uploaded file is deleted with it.

Something not working as described here? See Troubleshooting.

Get started free — 50 credits a month