All articles

Knowledge · 3 min read

What goes into a business knowledge base that agents can actually use

Your agents are only as good as what they can read. Here is how to organise the facts of your business so answers stay right and consistent.

By the Makardo Team

Sage, Business Strategist

When an AI agent gives a wrong answer about your business, missing or conflicting information can be part of the problem. A company knowledge base gives agents an organised reference for the business facts they are allowed to access. It also tends to help the humans in your business just as much.

Shared company facts, not a shared brain

Every Makardo agent has its own brain and separate agent-specific knowledge. The shared company knowledge base contains business information such as prices, policies and processes; it does not merge everything every agent knows. You set access for each agent, including which company information, tools and other agents it can use.

Agents can work autonomously, self-evolve and connect with one another to get work done. Those capabilities operate within the access settings and approval requirements you choose for each agent. Collaboration is not a reason to give every agent access to everything.

Start with the questions you answer most

Do not begin by documenting everything. Begin by listing the questions customers, staff and suppliers ask you most often, then write the answer you actually give. This is the fastest route to a knowledge base that earns its keep, because it covers the situations agents will meet first.

The core sections

  • What you sell: each product or service, who it is for, what is included, what is not, and current prices.
  • Policies: returns, refunds, cancellations, delivery, payment terms, and the exceptions you are willing to make.
  • Processes: how an order, booking, project or onboarding moves from start to finish, step by step.
  • Tone of voice: how you sound, words you use and avoid, and a few example messages you were happy with.
  • People and roles: who handles what, and when something should be passed to a person.
  • Boundaries: topics agents should never answer, such as legal, medical or financial advice, and what to say instead.

Write for a literal reader

Agents take your words seriously. If your returns policy says thirty days but you quietly accept returns at forty, the agent will say thirty. That is a feature, but it means your knowledge base must say what you actually do. Where you allow judgement, say so explicitly: returns after thirty days are considered case by case and must be passed to the owner.

Examples beat descriptions

Describing your tone as friendly but professional helps a little. Including five real replies you were proud of helps a lot. The same goes for proposals, onboarding emails and reports. A handful of good examples gives an agent a pattern to follow and gives you a benchmark to compare drafts against.

Mark what is sensitive

Not every agent needs every page. Staff information, supplier pricing, margins and anything personal should be labelled so permissions can keep them with the agents and people who need them. A shared knowledge base does not mean everything is shared with everyone.

Keep it alive

A knowledge base decays quietly. Prices change, a supplier is replaced, a policy is updated after a difficult customer. Three habits keep it healthy:

  1. Every page has a named owner and a last reviewed note.
  2. When you correct an agent draft, ask whether the knowledge base caused the error, and fix it there.
  3. Once a quarter, skim the most-used pages and remove anything no longer true.

Let agents admit what they do not know

The most valuable instruction in any knowledge base is permission to say I do not know. An agent that pauses and asks when the answer is missing is far safer than one that fills the gap with something plausible. Each of those pauses is also a signal pointing straight at the next page you should write.

Building a good knowledge base takes some effort upfront, but it is effort you only spend once per fact. After that, every agent on the team, and every new person you hire, starts from the same clear page.

Want to apply this to your business?

Send a request and our team will review it and get back to you about next steps.

Become a founding member

Tell us a little about your business. We'll reply by email.