---
title: "How it works"
manual: "AI Foundation"
version: "main"
permalink: "https://docs.typo3.org/permalink/nitsan/ns-t3af:ask-ai-agent-how@main"
source: "AskAiAgent/HowItWorks.rst"
rendered: "2026-10-13T14:11:01+00:00"
---

# How it works {#ask-ai-agent-how}

The AI agent works on **the page you are editing**. When you open it, it
takes that page as its context. It reads the page and its content when
needed, and every change it prepares applies to that page. Every request
follows the same four steps. The AI agent never skips step 3 for a change.

![AI agent window with the conversation list, the context line, a request, completed read steps, the Changes applied card with Undo, suggestions, and the message field highlighted](../Images/ask-ai-agent-be-result.png)

The numbers in the screenshot mark:

1.  **Conversations**, filtered by **This page** or
    **All pages**.
1.  The **context line**: the page the AI agent works on, with its site,
    language, and workspace.
1.  Your request.
1.  Read steps the AI agent ran, each marked **completed**.
1.  The applied change with **Open page**, **Edit**,
    **View on website**, and **Undo**.
1.  **What I can do**: suggested next requests for this page.
1.  The **message field** and the AI provider used for the conversation.
    Choose the provider in the dropdown below the message field (for example
    **Default: OpenAI**) before you send the first message. See
    [Change the AI provider](https://docs.typo3.org/permalink/nitsan/ns-t3af:ask-ai-agent-where-provider@main).

The four steps of every request:

1.  **Open on a page** — Select the page you are editing, then click
    **Ask AI Agent**. The context line shows that page with its
    language and workspace. "This page" in your request always means the page
    shown there.
1.  **Ask** — Type your request and press `Enter`. The AI agent selects
    the tools it needs. **Read tools** (for example `pages_get`) run
    immediately and return an answer.
1.  **Review and approve** — If the request needs a change, the AI agent
    prepares a **change card** for the page, marked **Preview — nothing changed yet**.
    Click **Apply** to write it, or **Cancel** to discard it.
1.  **Check the result** — After **Apply**, the card shows
    **Changes applied** with links to the record and an
    **Undo** button.

> [!IMPORTANT]
> The AI agent works with **your** backend permissions. It cannot read or
> change anything that your backend account cannot access.