> For the complete documentation index, see [llms.txt](https://docs.hivel.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hivel.ai/using-hivel/cockpit/understand-metric-trends-with-ai-insights.md).

# Understand metric trends with AI Insights

Hivel already shows you the numbers - but now the AI Insights explains what they mean. When you review metrics on the Cockpit board, AI Insights automatically interprets trends and provides context for your team's engineering performance, so you can spend less time asking "why" and more time acting.

<div data-with-frame="true"><figure><img src="/files/hh09fDCDhjAjqAYB9QUw" alt=""><figcaption></figcaption></figure></div>

### How AI Insights works

AI Insights analyzes the data currently selected on your Cockpit board and generates interpretation based on that snapshot. You'll see insights that help you identify patterns, understand performance shifts, and spot early potential bottlenecks

**When you'll see insights:**

* Whenever you view a Cockpit board with time-range or filter selection applied
* For any combination of metrics on your dashboard

**When insights aren't generated:**

* Single-day selections (insufficient data for meaningful trend interpretation)

### What insights include

Insights provide context in two ways:

**Trend interpretation**: Why a metric is moving up, down, or staying flat based on your selected data

**Relative context**: Comparison metrics that help you understand performance in relation to other dimensions (e.g., how a metric compares across teams or time periods)

### Next steps you can take

Once you've reviewed insights on a board, drill into specific dashboards to investigate bottlenecks in more detail or dig deeper into root causes.

### What is required to enable this

Like all the other AI related features - this requires an AI consent for us to start generating these insights.

The AI consent can be enabled in the **Configurations section -> AI -> AI Insights**

<div data-with-frame="true"><figure><img src="/files/9Mx2AW7cvlqO74f39vT5" alt="" width="372"><figcaption><p>In Cockpit, the toggle will enable/disable the insights</p></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/0kKac7g4V5R1nUniAfCU" alt="" width="563"><figcaption><p>AI Insights toggle in Configuration screen</p></figcaption></figure></div>

### Related articles

* [Understanding your Cockpit dashboard](/using-hivel/cockpit.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.hivel.ai/using-hivel/cockpit/understand-metric-trends-with-ai-insights.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.