Building a help center your AI agent can learn from
How to write and organise help articles that work for customers reading them and for an AI agent answering from them, plus how to keep knowledge fresh.
A help center used to have one audience: customers who preferred to look things up themselves. Now it has two. The same articles also teach your AI agent what to say. Write them well and both audiences get accurate answers. Write them badly and the AI repeats your confusion back to customers, at speed.
Here is how to build a help center that serves both.
One source of truth
The most important decision is to keep your answers in one place. If shipping times live in a help article, a website page, three saved replies and an old document, they will drift apart. The AI may find the outdated version.
Choose your help center as the source of truth for policies and how-to steps. Link to it from your website and saved replies, rather than copying the text.
In Inboxbee, help articles are published to a public help site, and the AI agent uses them as knowledge too. You can also scan pages from your website, upload files and add Q&A pairs.
One question per article
Long articles that cover everything about a topic are hard to search and hard for an AI to quote accurately. Prefer short, focused articles:
- "How to reset your password", not "Account settings guide".
- "How long does delivery take?", not "Everything about shipping".
- "How to cancel your subscription", not "Billing FAQ".
Use the customer's words in the title. If people ask "How do I get my money back?", don't title the article "Refund eligibility criteria".
Put the answer first
Start each article with the direct answer in one or two sentences, then add details, steps and exceptions. This helps customers who skim, and it helps the AI pick out the core answer instead of an edge case from the fourth paragraph.
A simple structure:
- The answer, in a sentence or two.
- Steps, as a numbered list, if there are any.
- Exceptions and conditions, clearly labelled.
- What to do if it doesn't work, including how to reach a person.
Be explicit, not implied
People can fill gaps from context. AI is better when nothing has to be inferred. A few habits help:
- Spell out conditions: "Returns are accepted within 30 days of delivery, if the item is unused," rather than "Standard return rules apply."
- Avoid "see above" and "as mentioned". Each article should stand on its own.
- Name things the same way everywhere. If your product calls them "workspaces", don't call them "accounts" in one article.
- State what you don't do. "We don't offer phone support" prevents the AI from making something up.
Write for any language
Customers write in many languages, and the AI agent replies in the language the customer uses. Plain, simple sentences translate more accurately than idioms, jokes or long nested sentences. Write for clarity first; tone can come from your team's own replies.
Use Q&A pairs for the short stuff
Not every answer deserves a full article. Quick facts such as "Do you have a free trial?" or "Which payment methods do you accept?" work well as Q&A pairs in your AI knowledge. Keep them consistent with your articles.
Scan your website, but check what it picks up
Scanning your website is a fast way to give the AI broad knowledge about your products and policies. Review the result:
- Include the pages that answer questions: pricing, shipping, returns, product details, contact.
- Leave out pages that could confuse it, such as old announcements or internal-looking pages.
- Rescan after major site changes.
Test with real questions
Before relying on the AI, test it in the private test chat with real questions from your inbox. Ask them the way customers do, with typos and missing details. When an answer is wrong or vague, fix the article, not just the AI settings. Then check that questions outside your knowledge are handed over to a person. See when AI should hand over to a human.
Keep it fresh
Knowledge goes stale. Build a simple routine:
- When something changes, such as a price, policy or feature, update the article the same day.
- Every month, look at questions the AI handed over most and add or improve articles for them.
- Every quarter, remove articles for things you no longer offer.
Reports show the AI resolution and handoff rate, which tells you whether your knowledge is improving.
Summary
- Make the help center your single source of truth.
- One question per article, titled in the customer's words.
- Answer first, then steps and exceptions.
- Be explicit and write plainly.
- Use Q&A pairs for quick facts and review website scans.
- Test with real questions and update continuously.
A good help center makes customers more independent, your team faster and your AI more accurate, all from the same work.