All articles
Guides
How to write help articles an AI agent can use
Clear, specific articles make better answers. Here is the checklist our team uses when we help customers prepare their help center.

Theo Laurent
Head of Design
7 min read

Start with the question, not the feature
Customers ask about outcomes. Title articles the way people search: “How do I change my delivery address?” works better than “Address management”.
Keep one task per article. Long pages that cover five scenarios make it harder for any reader, person or agent, to find the one step that matters.
Write down the exceptions
Most escalations happen at the edges. If refunds work differently for gift cards or international orders, say so plainly in the article.
A quick checklist
One task per page. Clear eligibility rules. Exact steps. A note on what to do when the steps fail.



