# Quick Start

This guide walks through the end-to-end flow for a new user.

***

## 1. Open Telmai in Fabric

1. Navigate to your Microsoft Fabric workspace
2. Click **New item**
3. Select **Monitor Set** from the item list
4. The Telmai workload opens inside a Fabric iframe

***

## 2. Grant Consent (First Use Only)

On first use, a Fabric consent popup appears requesting permissions:

* Fabric.Extend
* Azure Storage (user impersonation)
* Power BI Service

Click **Accept**. If a tenant admin has already granted org-wide consent, this step is skipped for all users in your organization.

***

## 3. Connect a Data Asset

![](/files/hz0EFD7QA5zVHKnJdimq)

1. Click **Add Assets** (or navigate to the Onboarding page)
2. Browse: select a **Workspace**, then a **Lakehouse** or **Warehouse**, then select one or more **tables**
3. Click **Deploy Monitors**

Telmai will:

* Register each selected table as a monitored asset
* Automatically create 4 default monitors: [Record Count, Freshness, Completeness, Schema](/user-guide/monitor-types.md)
* Analyze the table's ingestion pattern to recommend the best monitoring configuration

***

## 4. View Your Monitors

![](/files/qnGfQ0U9hsktAdjFF6ze)

* Go to the **Monitor Dashboard**
* See all assets with their current monitor health status
* Click an asset to view individual monitor configuration and metric history

***

## 5. Run a Scan

![](/files/TxSNLe4ku6Dgr94t25NG)

Monitors run automatically on their configured schedule (default: every 6 hours).

To run immediately:

* Click **Run Now** on an asset or monitor
* Watch progress in real time on the [**Scan Jobs**](/user-guide/scan-jobs.md) page

***

## 6. Review Incidents

![](/files/yt217qKh3hUbXC8MPHFk)

When a DQ check fails, an Incident is created automatically.

* Go to the [**Incidents**](/user-guide/incidents.md) page to see all open issues
* Each incident shows: severity, affected asset, metric value vs threshold, detection time
* Click **Correlate with AI** to group related incidents by root cause

***

## 7. Configure Alerts

* Go to [**Administration**](/user-guide/administration.md) → **Alert Channels**
* Add a Slack, Teams, Email, or Webhook channel
* Assign the channel to monitors in the monitor configuration panel

***

## 8. Use the AI Copilot

![](/files/8tj46nZzsAxPhkTbPSrh)

Click the **Ask AI** button (bottom right) to open the Copilot panel. Example questions:

* "What are the most critical open incidents?"
* "Which assets haven't been scanned in the last 24 hours?"
* "Show me the completeness trend for the orders table"

See [AI Copilot](/user-guide/copilot.md) for more.


---

# Agent Instructions: 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:

```
GET https://fabric-docs.telm.ai/getting-started/quick-start.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.