--- title: "Administration" manual: "TYPO3 LLM Extension" version: "0.35" permalink: "https://docs.typo3.org/permalink/netresearch/nr-llm:administration@0.35" source: "Administration/Index.rst" modified: "2026-09-16T22:09:16+00:00" --- # Administration This guide walks you through managing AI providers, models, configurations, and tasks in the TYPO3 backend. It also covers the AI-powered wizards that automate most of the setup. ## The LLM backend module All AI **management** happens in **AI**; editors run prepared tasks and decide approvals in the separate **Web > AI Tasks** module ([Backend user permissions](https://docs.typo3.org/permalink/netresearch/nr-llm:administration-permissions@0.35)). The **Overview** is a guided starting point: - a **usage & cost** band across the top — 30-day cost, requests and tokens, the per-provider request mix, and a daily-requests sparkline (empty until the first request); - a unified **Set up & manage** grid where each module card carries its own setup state — *green* when it is configured, a blue *Next* flag on the single recommended step, and *Empty* on an optional module with no entries yet — so the next action is always visible without a separate wizard. Each card links to its module; - the **Providers** card shows a live, **token-free** reachability indicator per configured provider (a model-list/health ping, never a completion); - a **For developers** section showing how to call the same configuration from PHP via `LlmServiceManager`. The Overview's docheader carries a **Governance** tab — the read-only **effective policy** readout ([ADR-140](https://docs.typo3.org/permalink/netresearch/nr-llm:adr-140@0.35)). It lists the four governance keys that carry a decision (`privacy.level`, `privacy.retentionDays`, `tools.dataClassEnforcement`, `skills.minTrustLevel`) with the value the runtime applies right now and the class that resolved it. Two things it deliberately does not do: it never changes a value — instance-wide keys are set in the Install Tool under **Settings > Extension Configuration > nr_llm** — and it never shows a value it did not get from a resolver, so a row that cannot be answered reads `unknown` rather than a default. Because the reads go through the runtime resolvers, the tab shows what is *in force*: a mistyped `tools.dataClassEnforcement` reads `enforce`, because the gate is fail-closed ([ADR-113](https://docs.typo3.org/permalink/netresearch/nr-llm:adr-113@0.35)). The keys, their fallbacks and recommended settings are documented under [Effective policy](https://docs.typo3.org/permalink/netresearch/nr-llm:administration-governance@0.35). Two rows say more than their value alone: - `tools.dataClassEnforcement = observe` is annotated as applying to built-in tools only. Tools reached through an MCP server are always enforced against the trust-zone ceiling ([ADR-115](https://docs.typo3.org/permalink/netresearch/nr-llm:adr-115@0.35)), so an MCP tool can be dropped while this row reads `observe`. - Every `privacy.retention.` override that deviates from `privacy.retentionDays` gets its own row underneath it. Categories left at `0` resolve to the global window and are not listed — see [Data retention & purge](https://docs.typo3.org/permalink/netresearch/nr-llm:administration-data-retention@0.35) for the full set. ![The LLM Overview — a usage-and-cost band, a status-coloured module card grid, and a developer section](../Images/backend-dashboard.png) The admin module tree has fourteen sections accessible from the left-hand navigation: - **Overview** — guided dashboard: usage & cost, per-module setup state, and the developer guide - **Providers** — API connections - **Models** — available LLM models - **Configurations** — use-case presets - **Tasks** — one-shot prompt templates - **Snippets** — tagged reusable prompt fragments - **Get Started** — pick a use case and install a matching pack of configuration, tasks and snippets (admin-only) - **Setup wizard** — guided provider, model and configuration setup (admin-only) - **Skills** — GitHub-hosted `SKILL.md` sources (admin-only) - **Tools** — enable or disable the agent tools (admin-only) - **MCP servers** — configure external MCP servers and import their tool catalogues (admin-only) - **Playground** — run the agent tool loop interactively (admin-only) - **Agent runs** — review and decide runs paused for approval or input (admin-only) - **Analytics** — usage and cost dashboard (admin-only) Editors do not use this tree: their surface is the separate **Web > AI Tasks** module, opened per backend group through the [permission grants](https://docs.typo3.org/permalink/netresearch/nr-llm:administration-permissions@0.35). - [Managing providers](https://docs.typo3.org/permalink/netresearch/nr-llm:managing-providers@0.35) - [Managing models](https://docs.typo3.org/permalink/netresearch/nr-llm:managing-models@0.35) - [Managing configurations](https://docs.typo3.org/permalink/netresearch/nr-llm:managing-configurations@0.35) - [Managing tasks](https://docs.typo3.org/permalink/netresearch/nr-llm:managing-tasks@0.35) - [Managing prompt snippets](https://docs.typo3.org/permalink/netresearch/nr-llm:managing-prompt-snippets@0.35) - [Get Started: use-case packs](https://docs.typo3.org/permalink/netresearch/nr-llm:get-started-use-case-packs@0.35) - [Managing skills](https://docs.typo3.org/permalink/netresearch/nr-llm:managing-skills@0.35) - [Running tools](https://docs.typo3.org/permalink/netresearch/nr-llm:running-tools@0.35) - [MCP servers](https://docs.typo3.org/permalink/netresearch/nr-llm:mcp-servers@0.35) - [AI-powered wizards](https://docs.typo3.org/permalink/netresearch/nr-llm:ai-powered-wizards@0.35) - [Per-user AI budgets](https://docs.typo3.org/permalink/netresearch/nr-llm:per-user-ai-budgets@0.35) - [Backend user permissions](https://docs.typo3.org/permalink/netresearch/nr-llm:backend-user-permissions@0.35) - [Verifying the specialized services](https://docs.typo3.org/permalink/netresearch/nr-llm:verifying-the-specialized-services@0.35) - [Usage analytics](https://docs.typo3.org/permalink/netresearch/nr-llm:usage-analytics@0.35) - [Agent runs](https://docs.typo3.org/permalink/netresearch/nr-llm:agent-runs@0.35) - [Data retention & purge](https://docs.typo3.org/permalink/netresearch/nr-llm:data-retention-purge@0.35) - [Effective policy](https://docs.typo3.org/permalink/netresearch/nr-llm:effective-policy@0.35)