> For the complete documentation index, see [llms.txt](https://docs.telm.ai/telmai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.telm.ai/telmai/ask-ai.md).

# Ask AI

Chat with Telmai's AI agent to add connections and assets, investigate incidents, and ask about your data.

**Ask AI** lets you work with Telmai in plain language. You can ask about your data, incidents, monitors and connections, add a connection or assets from the chat, and have the agent investigate an incident and suggest what to do next.

{% hint style="info" %}
Ask AI is available only when the owners of your Telmai environment have installed it and turned it on for your tenant. It isn't turned on from Administration; ask them or Telmai support. **Administration** > **Ask AI** shows whether it's on; see [Administration](/telmai/administration.md#ai). When it's off, Ask AI is hidden from the side menu and the header.
{% endhint %}

You can use Ask AI in two places:

* The **Ask AI page**, from **Ask AI** at the top of the side menu.
* The **Ask AI panel**, from the **Ask AI** button in the header. The panel opens beside the page you are on.

## The Ask AI page

<figure><img src="https://604868671-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkO3-a8YVu1iq1jP__S%2Fuploads%2Fgit-blob-0c7b4732f2bd8822c1fdba2cc291b3fdd839761d%2Fask-ai-page-2026-11-04.png?alt=media" alt="The Ask AI page with the message box and action cards"><figcaption><p>The Ask AI page.</p></figcaption></figure>

Type a question in the message box, or start with one of the actions below it:

| Action                       | What it does                                                                                                                    |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| Add a new connection         | Connect a warehouse, lake or database from the chat.                                                                            |
| Add assets from a connection | Pick a connection, choose the tables and start monitoring them.                                                                 |
| Investigate an incident      | Pick an open incident. The agent explains what most likely caused it and suggests a next step.                                  |
| See what changed recently    | New and resolved incidents and DQ score changes from the last 24 hours.                                                         |
| Tell me about an asset       | Health, open incidents, monitors and lineage for any asset. When you have an asset open, it reads **Tell me about this asset**. |
| How do I…?                   | Starts a question about how to do something in Telmai.                                                                          |

The connection and asset actions only appear if your role lets you add connections or assets.

Click **New chat** to start over. Ask AI does not keep a history of past conversations, so copy anything you want to keep.

{% hint style="warning" %}
AI can make mistakes. Check answers before acting on them.
{% endhint %}

## The Ask AI panel

The **Ask AI** button in the header opens the same chat in a panel docked to the right of the page, so you can keep working while you ask. On narrow screens the panel covers the page instead.

* **Context line** — questions from the panel carry the context shown at the top of the panel: the asset you have open, or an incident you attached. Remove the context to ask a general question.
* **Open in Ask AI** — continues the conversation on the full Ask AI page.
* **New chat** — starts over.
* Press `Esc` or click the close button to close the panel.

The panel offers the same actions as the Ask AI page in short form: **Add connection**, **Add assets**, **Investigate incident**, **What changed**, **Tell me about an asset** (or **Tell me about this asset**) and **How do I…?**

<figure><img src="https://604868671-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkO3-a8YVu1iq1jP__S%2Fuploads%2Fgit-blob-008076acb5732a0da3ae60bf1a236c7eb7b553d7%2Fask-ai-panel-2026-11-04.png?alt=media" alt="The Ask AI panel docked to the right of the Home page"><figcaption><p>The Ask AI panel, opened from the header on Home.</p></figcaption></figure>

## Investigate an incident with AI

From an incident in [Incidents](/telmai/monitoring-data/incident-portal.md), click **Investigate with AI** in the incident's **Summary**. The agent looks at the incident and returns:

* the most likely root cause, and
* a suggested next step, with a link when the step is something you can do in Telmai.

Click **Continue in chat** to ask follow-up questions in the Ask AI panel with the incident attached. The **Ask AI** button in the incident header also opens the panel with the incident attached.

## Usage and limits

AI requests use tokens. Your tenant may have limits on how many tokens it can use per day, week or month.

* Click **Usage** on the Ask AI page or panel to see how much of each limit has been used and when it resets. When you approach or reach a limit, the button shows a dot, and its tooltip reads **Usage: near the limit** or **Usage: limit reached**. Everyone who can use Ask AI sees **Usage**. Tenant admins also get a settings icon in it that opens the AI settings.
* When a limit is reached, Ask AI, **Investigate with AI**, recommended rules and catalog classification show a message saying so until the limit resets.

Tenant admins see the full usage in **Administration** > **Ask AI**. See [Administration](/telmai/administration.md#ai).

## Related

* [AI Security and Governance](/telmai/security-and-compliance/ai-security-and-governance.md) — how Telmai's AI handles your data.
* [Telmai MCP Server](/telmai/integrations/telmai-mcp-server.md) — use Telmai from your own AI client.
