Konfiguration der Extension / Backend-Benutzergruppe

Im nachfolgenden Abschnitt findest du alle vorhandenen Konfigurationsmöglichkeiten der AI Suite. In Klammern stehen jeweils der Konfigurationsschlüssel und der Datentyp. Seit den Versionen 13.0.0/12.6.0/11.3.0 können einzelne Extension-Konfigurationen durch benutzergruppenspezifische Konfigurationen überschrieben werden. Das betrifft ausschließlich die API-Schlüssel (aiSuiteApiKey, openAiApiKey, anthropicApiKey, aiModelHubApiKey, mittwaldAiModelHubApiKey, googleTranslateApiKey, deeplApiKey, midjourneyApiKey), die kostenlose Version der DeepL-API (deeplApiMode), die Midjourney-ID (midjourneyId) und den Ablageordner für Bild- und Mediendateien (mediaStorageFolder). Alle übrigen Einstellungen gelten für die gesamte Installation.

Extension-Einstellungen

Alle Einstellungen im Überblick

Lizenz & Server

Lizenzdaten des Servers, der Datenschutz-Schalter für DSGVO-konforme Modelle und, falls deine Seite durch einen Zugriffsschutz gesichert ist, die HTTP-Basic-Auth. Letztere ist seit den Versionen 13.1.0/12.7.0 verfügbar. Ohne sie kann die AI Suite eine geschützte Seite nicht abrufen, was unter anderem die Metadaten-Generierung betrifft.

AI Suite license Key (aiSuiteApiKey, string): Dein unter www.autodudes.de erzeugter Lizenzschlüssel. Ohne ihn arbeitet keine der KI-Funktionen.
AI Suite server (aiSuiteServer, string): Adresse des AutoDudes-Servers. In aller Regel unverändert lassen.

Standard: https://api.autodudes.de/
System domain (aiSuiteSystemDomain, string): Seit den Versionen 14.5.0/13.17.0/12.23.0. Die Domain, für die diese Installation lizenziert ist. Sie wird für CLI- und Cron-Läufe gebraucht, bei denen kein HTTP-Host zur Verfügung steht. Bleibt das Feld leer, wird die Domain aus dem Backend-Host bzw. der Site-Konfiguration ermittelt.

Standard: leer
Only load GDPR-compliant libraries (forceGdpa, boolean): Beschränkt die Auswahl auf die KI-Modelle, die auf dem AI-Suite-Server als DSGVO-konform gekennzeichnet sind. Modelle ohne diese Kennzeichnung tauchen dann in keiner Auswahl mehr auf.

Standard: aus
Enable Basic Authentication (basicAuth.enable, boolean): Aktiviert die Anmeldung mit Benutzername und Passwort für alle Abrufe, die die AI Suite an deine Seite richtet.

Standard: aus
Username (basicAuth.user, string): Der Benutzername des Zugriffsschutzes, nicht der eines TYPO3-Backend-Benutzers.
Password (basicAuth.pass, string): Das zugehörige Passwort. Es wird in der Extension-Konfiguration im Klartext abgelegt, gilt also nur für den Zugriffsschutz und sollte nirgends sonst verwendet werden.

Audits

Die Einstellungen des Audit-Bereichs im Backend-Modul „AI Suite“. Sie sind seit den Versionen 14.5.0/13.17.0/12.23.0 verfügbar, liegen seit den Versionen 14.6.2/13.18.2/12.24.2 in einem eigenen Reiter und sind unter AI Audit ausführlich beschrieben.

WCAG conformance level for accessibility audits (auditWcagStandard, options): Wählbar sind WCAG 2 Level A, AA und AAA. Der Wert steuert den HTML_CodeSniffer-Durchlauf. Der zusätzlich eingesetzte axe-Durchlauf prüft gegen sein eigenes Regelwerk und ist davon unabhängig.

Standard: WCAG2AA
Default AI model for audit analyses (auditDefaultTextModel, string): Modellkennung, zum Beispiel Anthropic. Ist hier ein Modell gesetzt, entfällt die Modellauswahl im Audit-Formular. Bleibt das Feld leer, wählen die Redakteure pro Durchlauf selbst.

Standard: leer

Übersetzung

Umfasst die allgemeinen Übersetzungseinstellungen sowie die automatische Übersetzung beim Speichern. Letztere ist seit den Versionen 14.3.0/13.15.0/12.21.0 verfügbar und unter Automatische Übersetzung beim Speichern ausführlich beschrieben.

Use the following library for "Einfache Sprache" translations (easyLanguageLibrary, options): Wählbar sind OpenAI, Claude und Meta Llama-3.3 (70B-Instruct). Kam mit dem Plugin für „Einfache Sprache“ in den Versionen 13.3.0/12.9.0 hinzu.

Standard: ChatGPT
Disable whole translation functionality (disableTranslationFunctionality, boolean): Schaltet die gesamte Übersetzungsfunktion ab. Mit Bedacht verwenden, denn danach ist auch die automatische Übersetzung wirkungslos.

Standard: aus
Translate FlexForm fields (translateFlexFormFields, boolean): Mit Einführung der FlexForm-Übersetzungen in den Versionen 13.2.0/12.8.0 kam auch die Option zum Ein- und Ausschalten dieser Funktion hinzu.

Standard: an
Update DeepL glossaries (updateDeeplGlossaries, boolean): Wurde mit den Versionen 14.6.0/13.18.0/12.24.0 entfernt, da sie nicht mehr verwendet wurde.

Sie hielt die bei DeepL hinterlegten Glossare mit deinen Glossar-Einträgen in TYPO3 synchron, siehe Glossarfunktion. Die Synchronisation erfolgt heute über den Button „DeepL-Glossare synchronisieren“.

Standard: entfällt
Automatically translate content elements into all site languages on save (enableAutoTranslateOnSave, boolean): Schaltet die automatische Übersetzung ein. Ohne diesen Schalter bleiben die folgenden drei Einstellungen wirkungslos.

Standard: aus
Processing mode for automatic translation (autoTranslateMode, options): Drei Möglichkeiten: „Page module“ wendet fertige Übersetzungen beim Öffnen des Seiten-Moduls an und zeigt den Status im Seitenbaum. „CLI scheduler“ setzt voraus, dass ai-suite:process-tasks läuft. „Directly on save“ übersetzt synchron, blockiert also den Speichervorgang, und eignet sich nur bei wenigen Sprachen.

Standard: pageModule
Model used for automatic translation on save (autoTranslateModel, options): Wählbar sind OpenAI, DeepL, Google Translate, Claude und Mittwald AI.

Standard: ChatGPT
Safety cap: maximum number of content elements a single save may auto-translate (autoTranslateMaxElementsPerSave, int+): Ändert ein Speichervorgang mehr Elemente als hier erlaubt, etwa bei einer Massenbearbeitung, wird die automatische Übersetzung für diesen Vorgang übersprungen und die Redaktion erhält einen Hinweis. Der Wert 0 hebt die Grenze auf.

Standard: 15
Öffne den übersetzten Datensatz im Bearbeitungsmodus (openTranslatedRecordInEditMode, boolean): Wurde mit den Versionen 13.11.2/12.17.2 entfernt.

Sie steuerte, ob ein übersetzter Datensatz direkt in der Bearbeitungsmaske geöffnet wird oder ob du in der Übersicht des Moduls „Datensätze“ (in TYPO3 12: „Liste“) bleibst.

Standard: entfällt

Metadaten

Umfasst die Metadaten-Generierung im Assistenten sowie die automatische Generierung, die greift, sobald eine Datei in die Dateiliste hochgeladen wird.

Amount of metadata suggestions to be displayed (metadataSuggestionCount, options): Legt fest, wie viele Vorschläge der Metadaten-Assistent je Feld anbietet (1 bis 5).

Standard: 5
Minimum number of characters of fetched page content (minPlausiblePageContentLength, int+): Untergrenze an Zeichen, die eine abgerufene Seite haben muss, bevor ihr Inhalt zur Metadaten-Generierung an die KI geschickt wird. Schützt davor, dass aus einer nahezu leeren Seite Metadaten erfunden werden.

Standard: 100
Generate image titles automatically on file upload (metadataAutogenerateTitle, boolean): Standard: aus
Generate alternative text automatically on file upload (metadataAutogenerateAlternative, boolean): Standard: aus
Use the following library for autogenerated metadata generation on file upload (metadataAutogenerateModel, options): Standard: Vision
How to handle autogenerated file metadata? (metadataAutogenerateApproach, options): Entweder landen die Vorschläge in der TaskEngine und werden dort geprüft, oder der erste Vorschlag wird direkt gespeichert.

Standard: taskEngine
Own prompt for autogenerated file metadata on upload (metadataAutogeneratePrompt, string): Seit den Versionen 14.4.0/13.16.0/12.22.0. Ersetzt die vordefinierte Anweisung. Lässt du das Feld leer, bleibt die Standardanweisung aktiv.

Standard: leer
Detail-Plugin zur Anzeige von Datensätzen von EXT:news (singleNewsDisplayPage, int+): Wurde mit den Versionen 13.0.0/12.6.0/11.3.0 durch dynamische Abfragen während des Generierungsprozesses ersetzt.

Standard: entfällt
Immer URL für Metadatenanfragen verwenden (useUrlForRequest, boolean): Wurde mit den Versionen 13.0.0/12.6.0/11.3.0 entfernt.

Standard: entfällt

Medien

Die Ablage der mit der AI Suite erzeugten Bilder und Medien. Seit den Versionen 14.6.2/13.18.2/12.24.2 ein eigener Reiter.

Store image and media files at this folder (mediaStorageFolder, string): Relativer Pfad zum gewünschten Ordner, in dem mit der AI Suite erzeugte Bilder und Medien abgelegt werden, etwa ai-images/unterordner. Auch ein kombinierter Bezeichner wie 1:/user_upload/ai-images ist möglich. Existiert der Ordner nicht, wird er angelegt.

Standard: leer

CLI

Die Hintergrundaufgaben der CLI-Befehle. Seit den Versionen 14.6.2/13.18.2/12.24.2 ein eigener Reiter.

Maximum number of CLI background tasks processed per scheduler run (maxTasks, int+): Begrenzt, wie viele Hintergrundaufgaben ein Durchlauf von ai-suite:process-tasks abarbeitet. Die Grenze gilt auch für ai-suite:retry-tasks. Siehe CLI-Befehle.

Standard: 50

EU AI Act

Die Kennzeichnung KI-geschriebener Inhalte. Die Kategorie ist seit den Versionen 14.6.0/13.18.0/12.24.0 verfügbar und unter KI-Inhalte (EU AI Act) ausführlich beschrieben.

Record which records were written by an AI feature (provenanceTracking, boolean): Führt das Register, das als Nachweis nach Art. 50(2) EU AI Act dient und die Grundlage für die Kennzeichnung im Backend bildet. Ist die Option aus, wird nichts erfasst und nichts gekennzeichnet.

Standard: an
Disclose AI translations as AI-generated as well (provenanceDiscloseTranslations, boolean): Erfasst werden KI-Übersetzungen in jedem Fall. Die Option legt fest, ob sie auch als KI-generiert ausgewiesen werden. Eine getreue Übersetzung erhält die Bedeutung des Ausgangstexts und kann deshalb als ausgenommen gelten.

Standard: aus
Show the AI marking in the backend (provenanceShowLabels, boolean): Blendet das Badge im Seiten-Modul und die Hinweise an den KI-befüllten Feldern ein. Ist die Option aus, bleiben das Register und die maschinenlesbare Bildkennzeichnung erhalten, nur die sichtbare Kennzeichnung für die Redaktion entfällt.

Standard: an

Eigene API-Schlüssel

Dieser Reiter ist für alle wichtig, die „Bring your own keys“ nutzen. Die hier hinterlegten Schlüssel werden in Verbindung mit deinem Lizenzschlüssel verwendet. Gegliedert nach Textmodellen, Übersetzungsdiensten und Bildmodellen.

Enter your OpenAI API key (openAiApiKey, string)
Enter your Anthropic API key (anthropicApiKey, string)
Enter your AI Model Hub API key (aiModelHubApiKey, string): IONOS, wird auch für Flux genutzt.
Enter your Mittwald AI Model Hub API key (mittwaldAiModelHubApiKey, string): Für die Mittwald-Modelle. Seit den Versionen 14.6.0/13.18.0/12.24.0 verfügbar.
Enter your Staan API key (staanApiKey, string): Nur bei „Bring your own keys“ nötig, und dort nur für die Web-Recherche im DSGVO-Modus.
Enter your GoogleTranslate API key (googleTranslateApiKey, string)
Enter your DeepL API key (deeplApiKey, string)
Free version of DeepL API (deeplApiMode, boolean): Aktivieren, wenn du die kostenfreie DeepL-API nutzt. Die beiden Varianten sprechen unterschiedliche Endpunkte an.

Standard: aus
Enter your Midjourney API key (midjourneyApiKey, string): Mit „Bring your own keys“ ist Midjourney derzeit nicht nutzbar (siehe Pakete/Lizenzen). Die Felder sind bereits vorhanden, damit eine spätere Freischaltung ohne Update möglich ist.
Enter your Midjourney ID (midjourneyId, string)

Seit den Versionen 14.5.0/13.17.0/12.23.0 sind die Extension-Einstellungen in Kategorien und Unterkategorien gegliedert. Die Einstellungen selbst sind dieselben geblieben. Seit den Versionen 14.6.2/13.18.2/12.24.2 sind sie in acht Reiter aufgeteilt: „Lizenz & Server“, „Audits“, „Übersetzung“, „Metadaten“, „Medien“, „CLI“, „EU AI Act“ und „Eigene API-Schlüssel“.

Show larger version

Die Extension-Konfiguration ist in Reiter gegliedert: „Lizenz & Server“, „Audits“, „Übersetzung“, „Metadaten“, „Medien“, „CLI“, „EU AI Act“ und „Eigene API-Schlüssel“. Schlüssel und Adressen sind unkenntlich gemacht.
Show larger version

Im Reiter „Übersetzung“ legen wir im Bereich „Automatische Übersetzung beim Speichern“ fest, ob, wie und mit welchem Modell beim Speichern übersetzt wird.

Sprachzuordnung (Locale Mapping)

In manchen TYPO3-Installationen stimmen die in der Site-Konfiguration hinterlegten Sprachcodes nicht mit den Sprachcodes überein, die letzten Endes an die angebundenen KI-Dienste (z. B. DeepL, Google Translate oder ChatGPT) übermittelt werden sollen.

Über die optionale Konfiguration aiSuite.locales in der config.yaml deiner Site kannst du seit den Versionen 13.11.2/12.17.2 ein Mapping definieren, das den TYPO3-Sprachcode auf den gewünschten Ziel-Locale abbildet.

Füge folgenden Block in deine Site-Konfiguration (config/sites/<identifier>/config.yaml) ein:

aiSuite:
locales:
en: en-GB
…

Links steht der TYPO3-Sprachcode (ISO 639-1, z. B. en, de, fr), rechts der Locale, der an die KI-Dienste übermittelt werden soll.