Top Questions
Top Questions provides a high-level overview of the topics that your users are asking about across all conversations. It helps you understand what your customers care about by automatically clustering similar questions into broader themes.
How top questions work
For a selected time period (calendar week, month, or quarter), Kapa analyzes all conversations to determine common themes within your conversations. This can help you understand the broad topics that your users are interested in, rather than focusing on individual conversations or questions.
Tip, use the "copy for LLM" button to copy this data into an LLM to analyse your topic.
Viewing conversations
Each cluster gives you the option to view all conversations that were considered when building the theme. Click the "show x conversations" dropdown to view the individual conversations, across all languages.
Export
You can export Top Questions data to a CSV file for further analysis. To export, click the Export button on the Top Questions page. The exported CSV contains all clusters and their associated conversations for the selected time period.
Recommended workflow
The recommended way to act on your Top Questions is to use the Analyze Top Questions skill with an AI agent.
- Install the skill from the kapa-skills repository into your documentation repository
- Export your Top Questions for the time period you want to analyze
- Invoke the skill with your AI agent from within your documentation repository
The skill will turn your data export into a directory of individual topic files to track progress. You then go through each topic one by one together with your agent. Your most common topics are obviously already documented. The question is whether your documentation covers them in the best possible way. Users may be approaching a topic from a different angle than how you have written about it, or explanations may not be clear enough to address what people really want to know. For each topic, the agent analyzes the conversations in the cluster and reviews your documentation repository to identify these kinds of issues. You make the call, optionally improve the documentation on the spot, and move on to the next one. Progress is tracked so you can resume across multiple sessions.
Where Coverage Gaps helps you address topics where Kapa had no information at all, Top Questions helps you make sure your most important topics are documented as well as possible.
You can optionally connect a Kapa hosted MCP server to the skill, which lets the agent check what Kapa actually retrieves for a given question and discover if a topic is already covered in knowledge sources outside your documentation repository.
FAQ
Why is the total count of processed conversation different from my total conversation count?
We include the first question in a conversation thread and exclude the following:
- Threads not tagged as 'off-topic'
- Duplicate questions
What time periods are available?
Questions are clustered on a weekly, monthly, and quarterly basis. You can switch the interval period in the UI.
Why can't I see my top questions?
Top Questions needs at least 150 conversations that are not tagged as 'off-topic' to generate meaningful clusters. Try extending the time period to a longer period, or wait for more users to submit questions.