> ## 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.

# Example requests

> Friendly AI agent requests for T3AA: missing alt text, drafts, decorative images, accessibility scans, Fix Hub suggestions, PageSpeed, summaries, and voice-over — including English and German examples.

Talk to the AI agent the way you would ask a colleague. Copy an example below, change the names or file UIDs, and send it.

* Select the page first. *This page* means the page shown in the agent's context line.
* For every change, you get a preview first. Nothing is saved until you click **Apply**.

## Try these first

Three safe requests to get to know T3AA in the agent:

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

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

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Summarize the content of this page.
```

The first two **only read**. The third returns a summary; nothing is saved until you approve a later write preview.

## Alt text

**"Which images still need alt text?"**

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

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Welche Bilder haben keinen Alt-Text?
```

Decorative images are left out of this list.

**"Show drafts waiting for approval."**

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Which alt text drafts wait for approval?
```

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Welche Alt-Text-Entwürfe warten auf Freigabe?
```

The reply can show **Showing X of Y drafts**.

**"Generate drafts for a folder."** (asks before changing)

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Generate alt text for all images in this folder.
```

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Fill missing alt texts in user_upload/team.
```

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Queue alt text for "user_upload" folder, then show me the drafts. Do not approve them until I say so.
```

**"Approve drafts."** (asks before changing)

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Approve these alt text drafts.
```

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Approve all pending alt text drafts.
```

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Alt-Text-Entwürfe freigeben.
```

**"This image is only decoration."** (asks before changing)

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

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

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Mark this "/user_upload/hero.webp" image as decorative.
```

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Dieses Bild als dekorativ markieren.
```

**"Read or update metadata for one file."**

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
What is the alt text of file 128?
```

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
What is the public URL of file UID 21? Quote public_url from the metadata exactly.
```

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Generate alt text, title, and description for file 128.
```

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Write alt text for this "/user_upload/photo.webp" image and save it.
```

If a file already has image texts, the agent may ask whether to **Regenerate all**, **Fill empty fields only**, or **Keep current texts**.

> [!NOTE]
>
> Asking to **delete** images without alt text only **lists** them. The agent does not delete files.

## Accessibility scans and Fix Hub

**"Scan this page."** (asks before changing; uses scan quota)

```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.
```

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

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Führe einen WCAG-Scan auf dieser Seite aus.
```

*"Scan this page…"* and *"Run a WCAG scan…"* open a **scan** preview (confirmation required). *"Check this page for accessibility problems"* / *"What accessibility issues…"* **only read** the last scan result.

**"Show the last scan."** (only reads)

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

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Show the last accessibility scan result.
```

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Welche Barrierefreiheitsprobleme hat diese Seite?
```

This only reads the last scan result. The agent offers a scan, and asks you to confirm it, only when you ask it to scan.

**"How do I fix them?"** (only reads; AI suggestions)

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
How do I fix these accessibility issues?
```

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Suggest a fix for the missing alt text issues on this page.
```

## PageSpeed

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
How fast is this page?
```

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Check the PageSpeed score of the homepage.
```

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Wie schnell lädt diese Seite?
```

> [!NOTE]
>
> Google PageSpeed must be able to reach the public URL of the page. On local DDEV hosts such as `*.ddev.site`, the tool often fails with *Unable to resolve …*. Use a publicly reachable staging or production URL for real scores. The agent’s PageSpeed result is **not** saved to the T3AA Lighthouse report in the backend. See [Troubleshooting](https://docs.t3planet.de/en/latest/en/latest/ExtNsT3AA/AskAiAgent/Troubleshooting/Index.md#pagespeed-unable-to-resolve).

## Summaries, simplify, and voice-over

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Summarize the content of this page.
```

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Give me a short summary of content element 412.
```

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Create a simplified text version of this page in German.
```

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Fasse den Inhalt dieser Seite zusammen.
```

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Create a voice-over for this page.
```

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Erstelle ein Voice-over für diese Seite.
```

* **Summarize / simplify** use `t3aa_summarize_content` and **return text** (they do not write the page by themselves). A named page number is passed as `pageId`; a named language (for example German) is passed on. If the agent then offers to save the text on the page, you get a separate write preview — nothing is stored until **Apply**.
* **Voice-over** asks before changing and uses the editor’s default audio provider (OpenAI or ElevenLabs) and AI text-to-speech credits.

## Related

* [T3AA tools](https://docs.t3planet.de/en/latest/en/latest/ExtNsT3AA/AskAiAgent/Tools/Index.md)
* [Your first accessibility request](https://docs.t3planet.de/en/latest/en/latest/ExtNsT3AA/AskAiAgent/StepByStep/Index.md)
* [Feature Guide](https://docs.t3planet.de/en/latest/en/latest/ExtNsT3AA/FeatureGuide/Index)


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