AI insights

See what your users are actually asking GitBook Assistant — and identify knowledge gaps where your docs fall short

This feature is available on the Ultimate site plan.

AI insights shows what your visitors are asking and how effectively GitBook Assistant responds using your content.

To open AI insights, click on Insights from your site’s overview.

AI insights dashboard

The AI insights dashboard gives you a snapshot of your site through four key metrics:

• Savings: Estimated effort saved through questions answered by GitBook Assistant

• Questions: The unique questions asked by visitors

• Answered: The percentage of questions successfully addressed

• Topics: Your content insights sorted by shared themes

Click any topic to open the topic detail view.

AI insights screen.

Topics

The Topics view shows how individual topics perform over time and lists the questions related to each one.

Topic detail view in AI insights.

Questions in this topic

GitBook groups questions in a topic by Type or Recency. Use this to review recurring needs, spot documentation gaps, and understand whether your site is answering questions in that area successfully.

Click any question to open the question detail view.

Questions

The Questions view shows how GitBook Assistant handled an individual visitor question and which content supported the response.

When you click a question, the detail view opens. At the top of the screen, you can review the question itself, how often visitors asked it, its type, and the topics it belongs to.

Question detail view in AI insights.

Conversations and answer quality

Below the summary, you can review the conversations tied to the question and see whether GitBook answered it fully, partially, or not at all. The conversation panel also shows the full Assistant exchange, including any follow-up questions and responses.

Sources and context

The sources section shows which pages, records, or connected content GitBook used to answer the question. Use this to verify the AI drew from the right content — and to find places where relevant pages exist but weren't surfaced.

FAQ

How do I use AI insights?

AI insights gives your team an overview of how visitors interact with your documentation when searching for answers.

Filtering AI insights helps you identify content gaps. You can filter for:

• The questions visitors ask most often

• Questions visitors search for that don't have answers

• Topics your documentation doesn't cover

Addressing these gaps helps visitors find answers more quickly — and understand your product faster.

Coming soon: We’re working on features to help your team fix your content gaps automatically, through GitBook Agent.

See Agent audit to learn more.