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

# Ask AI agent

> Use the AI agent in the TYPO3 backend to run T3AA accessibility features in plain language: missing alt text, alt drafts, WCAG scans, Fix Hub suggestions, PageSpeed, summaries, and voice-over. Nothing is saved until you approve.

The **AI agent** is a chat window inside the TYPO3 backend. You describe an accessibility task in plain language, for example *"Which images have no alt text?"* or *"What accessibility issues does this page have?"*. The agent reads the page you are working on, picks the right T3AA tool, and prepares the change. You review the change and decide whether it is saved.

The AI agent UI ships with **AI Foundation** (`ns_t3af`). When **T3AA** (`ns_t3aa`) is installed with AI Foundation, it adds **14 T3AA MCP tools** to the agent: alt text, accessibility scans and issues, Fix Hub suggestions, PageSpeed, content summary, and voice-over.

> [!NOTE]
>
> The chat window, providers, preview/Apply flow, and keyboard shortcut are part of AI Foundation. T3AA only adds the accessibility tools. For the shared UI chrome, see [AI Foundation: Ask AI agent](https://docs.t3planet.de/en/latest/en/latest/ExtNsT3AF/AskAiAgent/Index).

![TYPO3 backend top bar with the Ask AI Agent button and Ctrl/Cmd+Shift+K](https://mintcdn.com/t3planet/_G0piFclModgPSU7/en/latest/ExtNsT3AA/AskAiAgent/images/t3aa-agent-topbar-button.webp?fit=max\&auto=format\&n=_G0piFclModgPSU7\&q=85\&s=fff016f6ab3fb4cccbc93065df518026)

![Empty AI agent window on Non-Composer TYPO3 v14 — Start a conversation](https://mintcdn.com/t3planet/_G0piFclModgPSU7/en/latest/ExtNsT3AA/AskAiAgent/images/t3aa-agent-window-empty.webp?fit=max\&auto=format\&n=_G0piFclModgPSU7\&q=85\&s=4b82f3ccc2e07965e9be9dc91e584241)

## Agent chat vs the AI Accessibility module

| Surface | What it is |
| - | - |
| **Ask AI Agent** (top bar) | Chat on the current page. Uses T3AA MCP tools plus AI Foundation core tools. |
| **AI Accessibility** module | Standalone tabs: Dashboard, AI Alt Text, Scans, Fix Hub, Voiceover, and related screens. See the [Feature Guide](https://docs.t3planet.de/en/latest/en/latest/ExtNsT3AA/FeatureGuide/Index). |

Both paths use the same T3AA business logic. Prefer the agent when you want a quick, page-scoped request; prefer the module for bulk queues, dashboards, and long-running jobs.

## Get started in three steps

**1. Select the page**

Select the page you want to work on in the page tree, for example in **Content > Layout**. The AI agent uses this page as its context.

**2. Click Ask AI Agent**

Click **Ask AI Agent** in the center of the backend top bar, or press `Ctrl/Cmd+Shift+K`. The AI agent window opens on top of the page.

**3. Ask, review, apply**

Type your request, for example *"Which images have no alt text?"*, and press Enter. For a change, review the preview card, then click **Apply** to save it or **Cancel** to discard it.

> [!WARNING]
>
> * Nothing is saved until you click **Apply**. **Cancel** or **Discard** writes nothing.
> * An applied change is saved in the **selected workspace**. In **Live**, it is public immediately. See [Live or draft workspace](https://docs.t3planet.de/en/latest/en/latest/ExtNsT3AF/AskAiAgent/HowItWorks/Index.md#live-or-draft-workspace) in the AI Foundation manual.
> * The AI agent has **your** backend permissions, never more.
> * T3AA tools also need an active T3AA license and a configured AI provider in AI Foundation.

## Read the pages in this order

| Page | What you learn |
| - | - |
| [Where the AI agent opens](https://docs.t3planet.de/en/latest/en/latest/ExtNsT3AA/AskAiAgent/WhereOpens/Index.md) | Where to find the AI agent, and what each part of its window does. |
| [How it works](https://docs.t3planet.de/en/latest/en/latest/ExtNsT3AA/AskAiAgent/HowItWorks/Index.md) | How a request runs, read vs write tools, and what you need before you start. |
| [Your first accessibility request](https://docs.t3planet.de/en/latest/en/latest/ExtNsT3AA/AskAiAgent/StepByStep/Index.md) | Step by step: find missing alt text, review a write preview, and cancel safely. |
| [T3AA tools](https://docs.t3planet.de/en/latest/en/latest/ExtNsT3AA/AskAiAgent/Tools/Index.md) | All 14 T3AA tools, their names in the agent, and the matching feature pages. |
| [Example requests](https://docs.t3planet.de/en/latest/en/latest/ExtNsT3AA/AskAiAgent/ExampleRequests/Index.md) | Ready-to-use requests for alt text, scans, Fix Hub, PageSpeed, and voice-over. |
| [Troubleshooting](https://docs.t3planet.de/en/latest/en/latest/ExtNsT3AA/AskAiAgent/Troubleshooting/Index.md) | Verified failures and how to solve them. |

## Related

* [AI Foundation: Ask AI agent](https://docs.t3planet.de/en/latest/en/latest/ExtNsT3AF/AskAiAgent/Index): UI, settings, and AI Agent module tabs.
* [Feature Guide](https://docs.t3planet.de/en/latest/en/latest/ExtNsT3AA/FeatureGuide/Index): Dashboard, AI Alt Text, Scanner, Fix Hub, Voiceover, and other module workflows.
* [AI Foundation MCP Server](https://docs.t3planet.de/en/latest/en/latest/ExtNsT3AF/Integrations/MCPServer/Index.md): use the same T3AA tools from Cursor, Claude Desktop, or other MCP clients.


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