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

# Your first accessibility request

> Step by step: open the AI agent on a page, find images without alt text, review a decorative-image preview, and cancel safely without writing.

This walkthrough uses one page and three requests, from safe to more powerful. Use a test page, or a draft workspace, for your first try.

## Step 1: Open the AI agent on your page

1. Select the page in the page tree, for example in **Content > Layout**.
2. Click **Ask AI Agent** in the top bar, or press `Ctrl/Cmd+Shift+K`.
3. On first use, read the AI notice and confirm it.
4. Check the context line below the title. It must show the page you want to work on.
5. Choose an AI provider in the footer if needed (for example **OpenAI**).

> [!TIP]
>
> If the context line shows the wrong page, close the agent, select the right page, and open it again.

## Step 2: Start with a request that only reads

Type a request that does not change anything:

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Which images have no alt text?
```

The agent runs the T3AA step **Find images without alt text** (marked **completed**) and answers with file paths and UIDs. Decorative images are left out. Nothing is written. This is the safest way to see how the agent works with T3AA.

![Agent answer listing images without alt text](https://mintcdn.com/t3planet/_G0piFclModgPSU7/en/latest/ExtNsT3AA/AskAiAgent/images/t3aa-agent-missing-alt.webp?fit=max\&auto=format\&n=_G0piFclModgPSU7\&q=85\&s=40849c023b13869a7f809eeb1971afc8)

> [!NOTE]
>
> The list can still include many fileadmin assets (for example PWA icons). Prefer a follow-up such as *"Only list images in fileadmin/user\_upload"* or use storage UID `1` with a smaller limit when you work through MCP. See [Troubleshooting](https://docs.t3planet.de/en/latest/en/latest/ExtNsT3AA/AskAiAgent/Troubleshooting/Index.md#noisy-missing-alt-list).

## Step 3: Preview a change, then cancel

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Mark file 141 as decorative.
```

You can also pass a file path instead of a UID, for example `Mark this "/user_upload/hero.webp" image as decorative.`

![Preview card for Mark an image as decorative with Cancel available](https://mintcdn.com/t3planet/_G0piFclModgPSU7/en/latest/ExtNsT3AA/AskAiAgent/images/t3aa-agent-write-preview.webp?fit=max\&auto=format\&n=_G0piFclModgPSU7\&q=85\&s=c7c913e2b5acac95fd62601e8d507311)

1. The card is marked **Preview — nothing changed yet**.
2. Check the **Parameters**: file UID or file path, language, decorative flag, and page.
3. Read the hint at the bottom. In **Live**, it may say *On confirm this goes live on the website.*
4. Click **Cancel** (or **Discard**) to write nothing. After cancel, the agent confirms that nothing was written.

![After Cancel: nothing was written to the file](https://mintcdn.com/t3planet/_G0piFclModgPSU7/en/latest/ExtNsT3AA/AskAiAgent/images/t3aa-agent-write-declined.webp?fit=max\&auto=format\&n=_G0piFclModgPSU7\&q=85\&s=42d3711a9aa8e2f5588b69fa4be502ec)

You can click **Apply** instead when you are ready to save. For documentation and first practice, **Cancel** is the safe choice.

## Step 4: Optional — ask about accessibility issues

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
What accessibility issues does this page have?
```

This **only reads** the last scan result. It does not start a new scan.

To run a new scan (and use scan quota), ask for it explicitly:

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Scan this page for accessibility problems.
```

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Run a WCAG scan on this page.
```

Those requests show a **scan** preview. Confirm with **Apply** only when you intend to scan. The screenshot below is the **issues** answer (read-only), not a scan preview.

![Accessibility issues response in the agent (read-only)](https://mintcdn.com/t3planet/_G0piFclModgPSU7/en/latest/ExtNsT3AA/AskAiAgent/images/t3aa-agent-a11y-issues.webp?fit=max\&auto=format\&n=_G0piFclModgPSU7\&q=85\&s=345a007882b9fc59d96fa04e42d96692)

## Next steps

* Browse all T3AA actions in [T3AA tools](https://docs.t3planet.de/en/latest/en/latest/ExtNsT3AA/AskAiAgent/Tools/Index.md).
* Copy requests from [Example requests](https://docs.t3planet.de/en/latest/en/latest/ExtNsT3AA/AskAiAgent/ExampleRequests/Index.md).
* For module workflows (queues, Fix Hub, bulk scans), see the [Feature Guide](https://docs.t3planet.de/en/latest/en/latest/ExtNsT3AA/FeatureGuide/Index).
* If something does not work, see [Troubleshooting](https://docs.t3planet.de/en/latest/en/latest/ExtNsT3AA/AskAiAgent/Troubleshooting/Index.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.