Given most of the big customer support live chat providers (Zendesk included) are adding AI chatbots to their products, I thought it would help to share a few tips on how you can optimize your help documentation/center to ensure your AI gives users the best answers.
(generally speaking, it will also mean it is easier to access for people too!)
AI isn't a magic pill, it really is a case of garbage in, garbage out, so it's worth spending the time to think about how to address these points in your docs if you want to get the best bang for your buck when working with AI.
(For context, I have been working every day on this kind of thing for the last 18 months so have gotten to learn quite a few ins and outs over that time that I thought might be worth sharing!)
On with the tips:
Be clear, concise and unambiguous
Each article or question you answer should be short, to the point, and use language specific to the issue being addressed.
Think overly specific rather than general. Spell things out as if you are writing to someone who has never seen or heard of your product or business or understands what it does. Don’t worry too much about repetition across articles.
It is worth pointing out here too that having less “personality” or “brand” to your help content will likely be a good thing for the AI’s understanding (you have lots of other opportunities across your product to get this across!).
2. Think about formatting
You can’t go overboard when formatting for AI.
Think of it as ‘sign-posting’. Use lots of headings and subheadings to identify each section of the content or guide and use bullets or numbering to show the steps of a process.
This type of formatting helps the AI to ‘read’ and interpret what each piece of help content is about without it having to ‘read’ more information around it.
Also, make sure you use full stops at the end of sentences and bullet points, as otherwise when the text is extracted it will be harder for the AI to determine where sentences and phrases begin and end.
3. Drop the jargon, but think about keywords
AI won’t understand your company jargon or acronyms, but a lot of the time, your users won’t either.
So limit the use of it to improve the likelihood that your AI will understand what you are talking about.
Use a plain English explanation with jargon in brackets afterwards (if you want to educate your users), rather than the other way around.
Think about the words you can use to make it clear what the help article is about for the AI. Think about what a user might search for if they were asking the question.
If you had to summarize the help article in 2-3 words, what would they be and are they mentioned several times throughout the article?
4. Take care when using tables and images
Most of the time, the AI won’t read a table as a table, it will just take all the text from it, without knowing which text comes from which column.
So the fewer tables you use, the better, or, if you have to use them, keep them smaller, with 2-3 rows maximum.
The same goes for images, most AI chatbots won’t be able to interpret them, so don’t use them to explain core concepts or show diagrams or screenshots without explaining them in text format in the body of the article.
(Added bonus here - it will only help make your articles more accessible for those with visual impairments).
5. One help article, one topic
The less ‘overlap’ between help articles, the easier it will be for the AI to identify which article it should use to answer the user’s question.
Try not to put articles that cover different parts of the product or business in one article, but do make sure that anything about a specific topic is in one place as it gives the AI more contextual understanding for answering questions.
6. Answer in full, using context
When writing out help articles and FAQs, they are often framed as questions with a “yes” or “no” response. AI needs more context than this, so instead of just saying “yes” update answers to be “yes, it can <whatever your question was>”.
This will make it far easier for the AI to find these answers when searching.
In addition, if an answer or help article is a little longer, it helps if you can provide some more context or background to the problem the article solves or question it is answering. This will help the AI discover it, but also give it more background when it comes to actually answering the question.
7. Avoid conflicting or contradictory information
You shouldn’t have outdated information in your help content. This is especially important if you use AI as the chatbot finds it nearly impossible to distinguish between the old and the new content and therefore can give outdated responses.
The same principle applies if your business has multiple versions or products.
Unless each article specifically calls out which version or product it relates to, the AI will have no broader knowledge to draw from to determine the correct answer.
So make sure, when giving context, if there are product or version-specific differences, that you call these out explicitly in your help content.
If you find these useful let me know and I can share a blog post with examples and a bit more background with you too.
Feel free to ask any questions too, no AI questions are too dumb, we're all learning right now!
Read more here.