---
title: "Where the AI agent opens"
manual: "AI Foundation"
version: "main"
permalink: "https://docs.typo3.org/permalink/nitsan/ns-t3af:ask-ai-agent-where@main"
source: "AskAiAgent/WhereOpens.rst"
rendered: "2026-10-13T14:11:01+00:00"
---

# Where the AI agent opens {#ask-ai-agent-where}

**On this page**

-   [Where to find it in the backend](https://docs.typo3.org/permalink/nitsan/ns-t3af:where-to-find-it-in-the-backend@main)
-   [Overview](https://docs.typo3.org/permalink/nitsan/ns-t3af:overview@main)
-   [Open the AI agent in three steps](https://docs.typo3.org/permalink/nitsan/ns-t3af:open-the-ai-agent-in-three-steps@main)
-   [The AI agent window, part by part](https://docs.typo3.org/permalink/nitsan/ns-t3af:the-ai-agent-window-part-by-part@main)
-   [Change the AI provider](https://docs.typo3.org/permalink/nitsan/ns-t3af:change-the-ai-provider@main)
-   [Where to find what](https://docs.typo3.org/permalink/nitsan/ns-t3af:where-to-find-what@main)
-   [Next steps](https://docs.typo3.org/permalink/nitsan/ns-t3af:next-steps@main)

The AI agent opens on the page you are editing. This page shows where to find it
in the TYPO3 backend, what each part of the window does, and where you manage it.

## Where to find it in the backend {#ask-ai-agent-where-screens}

Select a tab to see each place in the TYPO3 backend. The numbers match the
orange markers in the screenshots.

**1\. Full backend view**

![TYPO3 backend showing AI Foundation > AI Agent > Overview with the Ask AI Agent button, the AI Foundation module, the AI Agent module tab, its five tabs, the tool counters and the keyboard shortcut setting marked 1 to 6](../Images/ask-ai-agent-be-where.png)

1.  **Ask AI Agent** in the top bar.
1.  **AI Universe > AI Foundation** in the module menu.
1.  The **AI Agent** module tab.
1.  Its five tabs.
1.  Tool counters.
1.  **Keyboard shortcut**.

**2\. Ask AI Agent**

![Backend top bar with the Ask AI Agent button and the keyboard shortcut Ctrl/Cmd+Shift+K marked 1](../Images/ask-ai-agent-be-where-topbar.png)

-   Opens the AI agent for the page you are editing.
-   The button shows the active keyboard shortcut, by default
    `Ctrl/Cmd+Shift+K`.
-   The red bar above it shows the current workspace. An applied
    change is saved in the **selected workspace**: in
    **Workspace: LIVE** it is public immediately; in a draft
    workspace it stays in that workspace until it is published.

**3\. AI Foundation module**

![Backend module menu with AI Foundation marked 2 below AI Universe](../Images/ask-ai-agent-be-where-module-menu.png)

Open this module to manage AI Foundation: providers, permissions, and
the AI agent.

**4\. AI Agent module tab**

![AI Foundation module navigation with the AI Agent tab marked 3 and its five tabs Overview, Severity policy, Governance, Audit and Demand signals marked 4](../Images/ask-ai-agent-be-where-module-tabs.png)

-   **Overview** — status, tools, and keyboard shortcut.
-   **Severity policy**, **Governance**,
    **Audit**, **Demand signals** — see
    [AI Agent module tabs](https://docs.typo3.org/permalink/nitsan/ns-t3af:ask-ai-agent-tabs@main).

**5\. Status and shortcut**

![Overview tab with the tool counters marked 5 and the Keyboard shortcut setting marked 6](../Images/ask-ai-agent-be-where-status.png)

-   **Tool counters** show how many tools are registered, how many you
    can run now, and how many are locked.
-   **Keyboard shortcut** sets how the AI agent opens in this browser.
    `Ctrl/Cmd+Shift+K` is recommended because it keeps
    `Ctrl/Cmd+K` for TYPO3 Live Search.

## Overview {#ask-ai-agent-where-overview}

This page shows **where you open the AI agent** in the TYPO3 backend, **what
each part of the AI agent window does**, and **where you manage it**. After
reading it, you know:

-   how to open the AI agent on the page you are editing,
-   what the icons, the context line, the progress list, and the message field
    of the window do,
-   where to choose the AI provider for a conversation,
-   where its settings and status are:
    **AI Foundation > AI Agent**.

The AI agent is an assistant for **the page you are working on**. You open
it while you edit a page; it opens as a window on top of the page, so you
never leave your work. The page, its site, language, and workspace are shown
in the **context line** of the window. The AI agent uses this page as its
context, and every change it prepares applies to this page.

> [!NOTE]
> The AI agent is not a general chat for every backend module. Select the
> page first, then open the AI agent.

> [!IMPORTANT]
> -   **Select the page first:** open the page in the page tree, for example
>     in **Content > Layout**.
> -   **Open the AI agent:** click **Ask AI Agent** in the backend top
>     bar, or press `Ctrl+Shift+K` (Windows, Linux) /
>     `Cmd+Shift+K` (macOS).
> -   **Check the context line:** it must show the page you want to change.
> -   **Choose the AI provider:** use the provider dropdown below the message
>     field, for example **Default: mistral**, **before you send the
>     first message**.
> -   **Nothing is saved until you click** **Apply**.
> -   **Settings and status:** **AI Foundation > AI Agent**.

## Open the AI agent in three steps {#open-the-ai-agent-in-three-steps}

1.  Open the page you want to work on: go to **Content > Layout**
    and select the page in the page tree.
1.  Click **Ask AI Agent** in the top bar, or press
    `Ctrl/Cmd+Shift+K`.
1.  The AI agent window opens on top of the page. Check that the context line
    shows the right page, then type your request in the message field at the
    bottom and press `Enter`.

To see the settings and status of the AI agent, open
**AI Universe > AI Foundation** in the module menu and select the
**AI Agent** module tab.

## The AI agent window, part by part {#ask-ai-agent-where-window}

The screenshots in this section are taken from a TYPO3 v14 backend with
AI Foundation installed. The **orange numbers** in each screenshot match the
numbered list below it.

### The whole window {#the-whole-window}

![The AI agent window opened on top of the Layout module, with the conversation list, the context line, the request, the steps, the result card, What I can do, and the message field marked 1 to 7](../Images/ask-ai-agent-be-result.png)

1.  **Conversations** — your earlier conversations. **This page**
    lists the conversations about the current page, **All pages**
    lists all of them. Use **Filter by title** to find one, and
    **+** to start a new one.
1.  **Context line** — the page the AI agent works on (see
    [Context line](https://docs.typo3.org/permalink/nitsan/ns-t3af:ask-ai-agent-where-context@main)).
1.  **Your request** — the message you sent, shown on the right.
1.  **Steps** — what the AI agent did to answer, for example
    **Read the page**. Click a step to see its details.
1.  **Result card** — the outcome. After a change is applied, it shows
    **Changes applied** with the buttons **Open page**,
    **Edit**, **View on website**, and **Undo**.
1.  **What I can do** — suggested next requests for this page, for example
    **Summarize this page** or **Create a subpage**. Click a
    suggestion to send it.
1.  **Message field** — type your next request (see
    [Message field, AI provider, and send](https://docs.typo3.org/permalink/nitsan/ns-t3af:ask-ai-agent-where-composer@main)).

### Header icons {#ask-ai-agent-where-header}

![Header of the AI agent window with the icons Show conversations, Summarize conversation, New conversation, Full screen, How the AI Agent works, Settings and Close, and the context line, marked 1 to 8](../Images/ask-ai-agent-be-header-parts.png)

1.  **Show conversations** — shows or hides the list of conversations on the
    left.
1.  **Summarize conversation** — writes a short summary of a long
    conversation, so you can continue with less history. The icon appears
    after a few messages.
1.  **New conversation** — starts an empty conversation. Use it for a new
    task, or to change the AI provider.
1.  **Full screen** — enlarges the window to the full backend area. Click
    again to return.
1.  **How the AI Agent works** — opens a short help panel with the rules of
    the AI agent and the AI provider in use.
1.  **Settings** — opens **AI Foundation > AI Agent**. Only shown to
    users who may open these settings.
1.  **Close** — closes the window. The conversation is kept; open the AI
    agent again to continue.
1.  **Context line** — see below.

Below the title, the line *Ask for anything on this screen. It drafts, you
approve, inside the conversation.* summarizes the principle: the AI agent
prepares a change, and you decide whether it is applied.

### Context line {#ask-ai-agent-where-context}

The context line (marker 8 above) shows **what the AI agent works on**, from
left to right:

-   the backend module, for example **Layout**,
-   the language, for example **English**,
-   the brand profile from **AI Foundation > AI Context**, for example
    **Brand: T3planet**,
-   the workspace, for example **Workspace: Live**,
-   the page and its ID, for example **QA Mounted (ID 2)**.

> [!WARNING]
> Always check the context line before you send a request. The AI agent
> works on this page and site unless you name something else. An applied
> change is saved in the **selected workspace**: in **Workspace: Live**
> it is public immediately; in a draft workspace it stays in that workspace
> until it is published.

### Progress {#ask-ai-agent-where-progress}

![Progress list of the AI agent with three steps, the status Waiting for your approval and the step counter 1/3, marked 1 to 3](../Images/ask-ai-agent-be-progress-parts.png)

For a request with several steps, the AI agent shows its plan in
**Progress**, directly above the message field.

1.  **Steps** — the planned steps. A crossed-out step is done, the bold step
    is the current one, the grey steps are next.
1.  **Status** — what the AI agent is doing now. **Waiting for your
    approval** means a change is ready; review it in the conversation and
    click **Apply** or **Cancel**.
1.  **Step counter** — the current step and the total, for example
    **1/3**. Click the arrow to collapse or expand the list.

### Message field, AI provider, and send {#ask-ai-agent-where-composer}

![Message field of the AI agent with the text area, the plus button, the hint AI-generated content can be wrong, the AI provider dropdown and the send button, marked 1 to 5](../Images/ask-ai-agent-be-composer-parts.png)

1.  **Message field** — type your request, for example *Add a text element
    with a short introduction to this page*. Press `Enter` to send,
    `Shift+Enter` for a new line.
1.  **Attach (+)** — **Add files or photos** attaches an image or
    document to your request. **Actions** lists the actions you can
    ask for.
1.  **Hint** — *AI-generated content can be wrong. Please verify before you
    approve.* Always review a change before you click **Apply**.
1.  **AI provider dropdown** — below the message field, next to the send
    button. It selects the AI provider that answers in this conversation.
    **Default: …** uses the default provider of the site, for example
    **Default: mistral** or **Default: OpenAI**. See
    [Change the AI provider](https://docs.typo3.org/permalink/nitsan/ns-t3af:ask-ai-agent-where-provider@main).
1.  **Send** — sends the request. While the AI agent works, a
    **Stop** button is shown instead.

## Change the AI provider {#ask-ai-agent-where-provider}

The AI provider answers your request. You select it in the **dropdown below
the message field** of the AI agent window, next to the send button.

1.  Open the AI agent on your page and click **New conversation** (**+**
    in the header).
1.  Open the dropdown next to the send button. It shows the default provider,
    for example **Default: mistral**.
1.  Select the provider you want to use.
1.  Type your request and send it.

> [!NOTE]
> -   **The provider is fixed per conversation.** After the first answer, the
>     dropdown is locked. To use another provider, start a new conversation.
> -   The dropdown is shown only when more than one provider is available.
>     Add providers in **AI Foundation > AI Providers**.
> -   Use a provider that supports **tool calling**. See
>     [Before you start](https://docs.typo3.org/permalink/nitsan/ns-t3af:ask-ai-agent-before@main).

## Where to find what {#where-to-find-what}

| What | Where |
| --- | --- |
| **Open the AI agent** | Select the page you are editing, then backend top bar > **Ask AI Agent**, or press `Ctrl+Shift+K` (Windows, Linux) / `Cmd+Shift+K` (macOS). |
| **Check which page is used** | AI agent window > context line below the title. |
| **Choose the AI provider** | AI agent window > dropdown below the message field, before the first message of a conversation. |
| **Start over / switch provider** | AI agent window > header > **+** (New conversation). |
| **Status and tools** | **AI Foundation > AI Agent > Overview** |
| **Settings (limits, conversations)** | **AI Foundation > AI Features** \> **AI Agent** card > **Configure**. See [AI agent settings](https://docs.typo3.org/permalink/nitsan/ns-t3af:ask-ai-agent-feature-settings@main). |
| **Who may use it** | Backend user group > **Access Lists > Custom module options > AI Foundation capabilities** \> **AI Agent access** |
| **Restrict tools per group** | **AI Foundation > AI Permissions** \> **Limits** \> **AI Agent tools** |

> [!NOTE]
> If **Ask AI Agent** is not shown in your top bar, your backend user
> group does not have **AI Agent access**. Ask your administrator.

## Next steps {#next-steps}

-   [How it works](https://docs.typo3.org/permalink/nitsan/ns-t3af:ask-ai-agent-how@main) — the four steps of every request.
-   [Before you start](https://docs.typo3.org/permalink/nitsan/ns-t3af:ask-ai-agent-before@main) — requirements before the first use.
-   [Use the AI agent step by step](https://docs.typo3.org/permalink/nitsan/ns-t3af:ask-ai-agent-steps@main) — open the AI agent on a page, ask, and apply a
    change step by step.
-   [Keyboard shortcuts](https://docs.typo3.org/permalink/nitsan/ns-t3af:ask-ai-agent-shortcuts@main) — change the keyboard shortcut.
-   [AI Agent module tabs](https://docs.typo3.org/permalink/nitsan/ns-t3af:ask-ai-agent-tabs@main) — the five tabs of the AI Agent module.
-   [AI agent settings](https://docs.typo3.org/permalink/nitsan/ns-t3af:ask-ai-agent-feature-settings@main) — limits, retention, and conversation
    settings (administrators).