diff --git a/blog/posts/2026-04-22-ask-the-prometheus-docs-with-kapa-ai.md b/blog/posts/2026-04-22-ask-the-prometheus-docs-with-kapa-ai.md new file mode 100644 index 000000000..e016d9f80 --- /dev/null +++ b/blog/posts/2026-04-22-ask-the-prometheus-docs-with-kapa-ai.md @@ -0,0 +1,49 @@ +--- +title: Ask the Prometheus docs with Kapa.ai +created_at: 2026-04-22 +kind: article +author_name: Arthur Silva Sens (@ArthurSens) +--- + +Prometheus documentation now includes a new Kapa.ai integration. This is available as part of the [partnership between CNCF and Kapa.ai](https://contribute.cncf.io/blog/2026/04/09/reducing-support-tax-cncf-kapa-ai/), which helps CNCF projects make their documentation and knowledge more accessible. + +You can now use the `Ask AI` entry on `prometheus.io` to ask questions in natural language and get answers grounded in Prometheus documentation. For the Prometheus team, it is also a useful way to understand what people are trying to learn from the docs and where the docs still need work. + + + +The `Ask AI` option is available directly from the docs search box: + +![Prometheus docs search field showing the Ask AI option](/assets/blog/2026-04-22/ask-ai-search.png) + +## How this helps users + +This makes the docs easier to use in a few different ways. You can ask full questions instead of guessing the exact search keywords, and you can describe a problem in your own words even if you do not know the Prometheus terminology yet. + +It can also be helpful if English is not your first language, since you can often ask in your preferred language instead of translating your question into English keywords first. And because the answers are grounded in the docs, you also get links back to the relevant pages to keep exploring. + +## Try it on prometheus.io + +The next time you are reading the Prometheus docs, open search and click `Ask AI`. + +Once you ask a question, Kapa responds with an answer grounded in the Prometheus docs and links back to the relevant documentation: + +![Prometheus Docs AI answering a question about installing Prometheus with links to the docs](/assets/blog/2026-04-22/ask-ai-answer.png) + +## Why we are adding it + +For the Prometheus team, this is not only a way to answer questions faster. It is also a feedback loop for improving the docs. + +Kapa shows us what people ask and how confidently those questions can be answered from the existing documentation. That helps us identify missing topics, unclear explanations, and places where the right content exists but is still hard to find. + +Looking at these questions over time gives us a practical way to spot recurring themes and prioritize documentation improvements: + +![Kapa question insights showing user questions, confidence levels, and topic tags](/assets/blog/2026-04-22/ask-ai-insights.png) + +If Kapa gives you a useful answer, great. If it does not, that also helps us improve the docs. + +Ask something simple. Ask something specific. Ask something you think should already be obvious from the docs. + +From now on, asking questions is also a great way of helping the Prometheus community! + +> NOTE: Conversations using the Kapa integration are recorded and anonym-ised. +> For more information, please read https://docs.kapa.ai/analytics/overview \ No newline at end of file diff --git a/public/assets/blog/2026-04-22/ask-ai-answer.png b/public/assets/blog/2026-04-22/ask-ai-answer.png new file mode 100644 index 000000000..af994e6d5 Binary files /dev/null and b/public/assets/blog/2026-04-22/ask-ai-answer.png differ diff --git a/public/assets/blog/2026-04-22/ask-ai-insights.png b/public/assets/blog/2026-04-22/ask-ai-insights.png new file mode 100644 index 000000000..a97a7ed2e Binary files /dev/null and b/public/assets/blog/2026-04-22/ask-ai-insights.png differ diff --git a/public/assets/blog/2026-04-22/ask-ai-search.png b/public/assets/blog/2026-04-22/ask-ai-search.png new file mode 100644 index 000000000..b675e3cb7 Binary files /dev/null and b/public/assets/blog/2026-04-22/ask-ai-search.png differ