---
title: "Backend module"
manual: "Ai3 Core"
version: "main"
permalink: "https://docs.typo3.org/permalink/wegewerk/ai3_core:usage-backend-module@main"
source: "Usage/BackendModule.rst"
rendered: "2026-10-23T16:30:49+00:00"
---

# Backend module {#usage-backend-module}

The *Ai3* backend module is located under **Web > Ai3** in the
TYPO3 backend main menu. It provides three views accessible via the
sub-navigation:

## Dashboard {#usage-dashboard}

## Zak_ai management {#usage-zakaimgmt}

This Dashboard guides you through the Zak_ai registration process:

1.  **Generate a Secret** and Provide an e-mail address.
1.  Put this secret in the \`\`ZAKAI_SECRET'' environment variable.

![](Zak_ai_dashboard_step_2.png)

1.  **Request API key** — Sends a `POST /accounts` request to Zak_ai.
    The registration status changes to *Requested*. Zak_ai sends an email containing your api key.

![](Zak_ai_dashboard_step_3.png)

1.  **Save API key** After receiving the confirmation e-mail from
    Zak_ai, Put the API Key in the \`\`ZAKAI_API_KEY'' environment variable.
1.  **Activate API key** Click *Activate API key* to call `PUT /accounts`. The status
    changes to *Done*.

![](Zak_ai_dashboard_step_4.png)

The dashboard looks like this when the registration is complete.

![](Zak_ai_dashboard.png)

## Restart the Onboarding process {#restart-the-onboarding-process}

The progress of the onboarding process is saved in the TYPO3 Registry (sys_registry) table.
If the API key has not been received, this must be reset:

delete from sys_registry where entry_namespace='ai3'

Then delete the env-var ZAKAI_SECRET and the process can start again from the beginning.

## Generation task overview {#usage-generatetask-view}

This view lists all `GenerationTask` records stored in the database.
Each row shows the capability, target record (table / field / UID),
current status, prompt, and generated result.

This view is intended for developers to see what the queue status looks like

See [Generation task](https://docs.typo3.org/permalink/wegewerk/ai3_core:developer-generation-task@main) for the full field reference.

![](Zak_ai_queue.png)

For these  `GenerationTasks` to actually be executed, a scheduler entry for `ai3_core:process_tasks` must be created.

![](Zak_ai_scheduler.png)