> ## Documentation Index
> Fetch the complete documentation index at: https://docs.custral.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Inspect the page

> Point the assistant at what you see (a record, a row, or a whole chart) and ask it to act.

## Overview

**Inspect** lets you hand the assistant a specific thing on your screen instead of describing it. Click the crosshair in the assistant composer, click any element on the page, and it's attached as context, with a screenshot so the assistant can *see* it. You can then ask the assistant to act on exactly what you selected: summarize a record, explain a row, or **filter a chart**.

## How it works

Inspect snaps your click to the smallest meaningful unit under the cursor:

* a **table cell** or a **record pill** (hold `⇧` while hovering to grab the whole **row** instead),
* a **paragraph, heading, or block of text**, or
* a **whole dashboard block** (a chart, table, or report card) when there's no smaller unit to grab (pointing at a chart's plot area selects the entire block).

What gets attached depends on what you picked:

* A **record / conversation / document** is attached by identity, so the assistant pulls its live data by id.
* A **dashboard block** is attached as the block itself (its screenshot plus its identity), so the assistant knows *which* block and can change what it shows.
* Anything else is attached as its visible text plus a screenshot.

Because a picked block carries the block's identity, the assistant can target it directly. Ask it to filter a chart and it adds a filter to **just that block** (not the dashboard's filter bar), and the chart updates in place. Whether the change applies immediately or asks first depends on the assistant's [permission mode](/ai/permissions), in **Ask** mode it confirms before writing.

## Using it

<Steps>
  <Step title="Open the assistant">
    Press `⌘I` (or open the assistant widget) and click the crosshair icon in the composer, "Select an element on the page as context."
  </Step>

  <Step title="Pick what you mean">
    Hover the page. A highlight follows your cursor and the hint shows what's snapped (e.g. `td`, `tr · record`, or `div · block`). Hold `⇧` for the whole row. Click to attach it; press `Esc` to cancel.
  </Step>

  <Step title="Ask the assistant to act">
    The selection appears as a context chip (a chart shows a **Block** chip). Now ask in plain language, for example, on a selected chart: *"filter this to open deals"* or *"only show this quarter."*
  </Step>

  <Step title="Confirm the result">
    A filtered block updates in place. On a chart, you'll see it re-query with the new filter. Ask again to change or clear it (*"remove that filter"*).
  </Step>
</Steps>

## Troubleshooting

| Symptom                                                                     | Likely cause                                                                  | What to check                                                                                        |
| --------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| Hovering a chart highlights a tiny label, not the whole card                | The cursor is over a text/legend element, which is a smaller snappable unit   | Move over the chart's plot area (empty space). The hint should read `· block`, then click            |
| The picked block chip says "Selection", not "Block"                         | You selected text/an element inside the block, not the block card             | Re-pick over the chart body so the whole card highlights                                             |
| "Filter this chart" changes the dashboard's filter bar instead of the block | The assistant applied a view filter rather than a per-block filter            | Make sure the **chart itself** is the attached context (a Block chip), not the page/view             |
| The assistant says it filtered the block but nothing changed                | The filter value didn't match a real option, or the write is pending approval | Check the assistant's reply for the exact value it used; in **Ask** mode, approve the pending action |
| The chart doesn't update until reload                                       | The dashboard tab wasn't connected when the change landed                     | Reload once; live updates require the open dashboard's realtime connection                           |

## Related

<CardGroup cols={2}>
  <Card title="Permissions" icon="shield-halved" href="/ai/permissions">
    Which assistant actions run automatically and which ask first.
  </Card>

  <Card title="Tools" icon="screwdriver-wrench" href="/ai/tools/overview">
    Everything the assistant can do on your workspace.
  </Card>

  <Card title="Dashboards" icon="chart-line" href="/surfaces/views/types/dashboard">
    The blocks and charts you can point the assistant at.
  </Card>

  <Card title="Chat Agents" icon="comments" href="/ai/chat-agents/overview">
    Reusable personas with scoped objects and tool gating.
  </Card>
</CardGroup>


## Related topics

- [AI](/ai/overview.md)
- [Workspace Audit](/data/audits/workspace.md)
- [Tools](/ai/tools/overview.md)
- [Pages](/surfaces/navigation/pages.md)
- [What the assistant can do](/ai/tools/library.md)