How to Write a Customer Service Knowledge Base Your Agent Will Actually Use

The biggest mistake store owners make when setting up an AI agent for customer service: they give it too little context. The agent is only as good as what you tell it about your business.

Here's a framework for building a CS knowledge base that makes your agent genuinely useful from day one.

The Five Sections Every KB Needs

1. Products and Variants

For each product: what it is, what it's made of, sizing/dimensions, key benefits, common questions, and what it's NOT (what customers sometimes think it is that it isn't). This is where most stores are too thin. Don't just copy your product description - go deeper.

2. Policies - Exactly as Written

Return policy, refund policy, shipping policy, subscription cancellation policy. Write them in plain language, not legalese. Include edge cases: what happens if a product arrives damaged? What if someone is one day outside the return window? Define the agent's authority - what can it approve without escalating?

3. Shipping and Fulfillment

Every shipping zone you support. Estimated transit times by zone. Carrier information. What happens when something is lost in transit. Holiday cutoff dates. This alone handles 30-40% of inbound tickets.

4. Escalation Paths

Be explicit: what situations does the agent escalate to a human? Suggested triggers: refund requests over \, legal threats or charge disputes, any mention of media or public complaint, multiple failed resolutions on the same ticket. The agent needs clear guardrails.

5. Brand Voice

How do you talk to customers? Formal or casual? Do you use first names? What's your sign-off? Include 3-5 example responses to common scenarios so the agent matches your voice, not a generic AI voice.

Maintenance

Your KB is a living document. Any time you change a policy, add a product, or adjust shipping zones - update the KB the same day. An agent working from stale information is worse than no agent.

At eclawmerce, building the knowledge base is part of our Agent Setup service. We interview you, audit your existing CS history, and build a KB that's ready for production - not a demo.

See what's included in Agent Setup ?