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.
| Source | Best for | How |
|---|---|---|
| File | Manuals, policies, price lists, brochures | Upload a file: PDF, Word (.docx), text or Markdown, up to 20 MB each |
| Website | Your help centre, product pages, FAQ | Add a website: crawl it, use its sitemap, or list pages |
| Text | Anything not written down elsewhere | Add text: paste or write it; Markdown headings help |
| Q&A pair | Questions customers ask often, with the exact answer you want | Add 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.
- 1You add a source
- 2Text is extractedPDF pages, Word headings…
- 3Split into passages
- 4Made searchableembeddings
- 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
- 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.xmladdress. - List pages: paste the exact addresses, one per line (up to 500).
- 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. - 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.txtis 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.
- 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.
- File a source with Move on its row, and choose a category or No category.
- 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.
Related
- Test in the playgroundTry changes without saving, compare two models and inspect exactly what a reply was given.
- ProceduresStep-by-step playbooks the agent follows when a conversation matches.
- TroubleshootingWhat to check when the widget does not show, an agent cannot answer, training fails or a channel is silent.
Something not working as described here? See Troubleshooting.