# Ask Mesh

Ask Mesh answers questions about your Mesh data, such as identities, non-human
identities, machines, software and certificates, and questions about how Mesh
works, from this documentation. Your administrator turns it on for your
organization.

To open it, select **Ask Mesh** in the lower-right corner of any page. You can
also press **⌘K** (macOS) or **Ctrl+K** (Windows) to search Mesh by name, then
ask your text as a question.

The controls below have a small **ⓘ** help button beside them in the product.
It opens a short explanation and a link to the matching section of this page.

## What Ask Mesh is asking about

The row under the panel's title shows what your questions are about:

- **All of Mesh**: questions are about your whole organization. Ask Mesh also
  knows which page you're on, so "what does this page show?" gets an answer
  about that page.
- **A named item** (a person, a non-human identity or an asset): on that item's
  page, questions are about it. Select **×** on the chip to ask about your
  whole organization instead.
- **This widget | All of Mesh**: on a workspace, one panel holds both the chat
  of the widget you opened and Ask Mesh. **This widget** talks about that
  widget; **All of Mesh** asks Ask Mesh.

## Suggested questions

A row of suggested questions sits above the question box. They fit the page
you're on, for example the riskiest identities on the identity dashboard.
Select one to ask it. Select **×** to hide the row; it comes back the next time
you open Ask Mesh or go to another page.

## Open in results

When an answer lists assets (machines, software or certificates), it offers
**Open in results**. This opens the list in the results view: the same query,
run again on live data, in the answer's order. An answer that lists several
kinds of assets offers one button for each.

The results view shows the rows the answer read. To get every row that
matches, use **Export CSV** in the results view.

## Download a report

Select the download icon under an answer, then **PDF report** or **Excel
report**. Every report holds:

- the question, the time of the data (**Data as of** or **Read live at**), and
  the sources the answer read;
- how the answer was produced: each tool, its query, where it read the data
  and when;
- the answer's text and its tables, up to 500 rows per table. A table that is
  longer says how many rows it has and that the report holds the first 500.

Some answers get a report shaped for what they hold, with a summary first. In
Excel the summary is the first sheet.

| The answer | Report |
|---|---|
| Lists certificates by expiry date, soonest first, or filtered to an expiry window | **Expiring certificates**: how many match, the window, the next certificate to expire and how many have already expired, then the certificates soonest first with the days left; expired ones are marked. A list in an expiry window that the answer ordered latest first keeps that order. |
| Reads compliance or post-quantum (PQC) readiness data | **Compliance report**: the compliance data read and how many assets match, then the tables. |
| Lists machines, software or certificates, including certificates ordered latest expiry first | **Inventory**: how many match, with any filters. |
| Anything else | The standard report. |

Numbers in a summary come only from the answer's own data. A summary leaves out
a line when the data it needs isn't in the answer.

An answer you reopen after reloading the page no longer has the details of
how it was produced, or the rows it read. Its report says so instead of leaving
those sections out. A list answer reopened this way gets the standard report,
not the shaped one; a compliance answer is still a **Compliance report**.

You can't download a report while you're signed in as another user.

## How did you get this?

Under every answer, **How did you get this?** lists the tools the answer used,
the query each one ran, the data each one read and when. **Data as of** means
the data itself carried that time; **Read live at** is when Mesh read it. An
answer you reopen after reloading the page keeps only the tool names and which
ones failed.
