Skip to content

Knowledge base or tool? ​

The assistant can know things in four ways. Choosing the wrong one is the most common reason an answer is out of date, or slow, or wrong.

Put it in…When the informationExamples
The website (learned automatically)Is already on your site and changes at the speed of the siteServices, process, policies, FAQs, product descriptions
Your own answers / files (Knowledge)Is not on the site, or must be said exactlyA price list PDF, the warranty terms, holiday hours
The promptIs a rule about how to answer, or corrects the website"Always say + GST", "the free audit is no longer a video", what is quote-only
A toolChanges by the hour, or is about this visitorOrder status, stock, availability, their account, their plan

Questions to ask ​

Does it change faster than you re-learn the site? The site is re-learned weekly (or when you ask). Stock, prices with sales, delivery status and availability change faster: use a tool.

Is it about this one visitor? Their order, their invoices, their booking: a tool, and for anything private, with signed-in visitors or a check your API makes.

Is it a rule, not a fact? "Never quote prices for custom work", "offer a callback after two questions": the prompt. Facts in the prompt go stale; rules don't.

Is the website wrong? Fix the page if you can. If not (or not yet), say so in the prompt: the prompt wins over the website.

Mixing them ​

Most good setups use all four. A shop's assistant, for example:

  • Website: what each product is, sizing guides, the returns policy.
  • Your own answers: "Click & collect orders are held for 7 days."
  • Prompt: "Say prices are right now; never hold stock."
  • Tools: product search with live prices, stock by store, order tracking.

Signs you chose wrong ​

You seeProbably
Old prices or "in stock" for sold-out itemsLive data in the knowledge base: move it to a tool
"Let me check" for a question every visitor asksA tool for something stable: put it in the knowledge base or the prompt
The assistant contradicts your siteThe site is out of date: fix the page, or correct it in the prompt
It answers about one customer from another's detailsPrivate data without verification: use signed-in visitors

See: Knowledge base, Prompt and instructions, Tools, Tutorials.

MIT licensed. Runs in your own Cloudflare account.