Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
49 changes: 49 additions & 0 deletions blog/posts/2026-04-22-ask-the-prometheus-docs-with-kapa-ai.md
Original file line number Diff line number Diff line change
@@ -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.

<!-- more -->

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
Binary file added public/assets/blog/2026-04-22/ask-ai-answer.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/assets/blog/2026-04-22/ask-ai-insights.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/assets/blog/2026-04-22/ask-ai-search.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading