Konfiguration der Extension / Backend-Benutzergruppe

Im nachfolgenden Abschnitt findest du alle vorhandenen Konfigurationsmöglichkeiten der AI Suite. In den eckigen Klammern wird als erster Wert der jeweilige Konfigurations-Key und als zweiter Wert der jeweilige Datentyp angegeben. Ab den Versionen 13.0.0/12.6.0/11.3.0 können alle Extension-Konfigurationen durch benutzergruppenspezifische Konfigurationen überschrieben werden.

Extension-Einstellungen

Alle Einstellungen im Überblick

Lizenz & Server

Lizenzdaten des Servers und, falls deine Seite durch einen Zugriffsschutz gesichert ist, die HTTP-Basis-Authentifizierung. Letztere ist seit den Versionen 12.7.0 und 13.1.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 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 der Site-Konfiguration ermittelt.

Standard: leer
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.

Eigene API-Keys

Dieser Reiter ist für alle Nutzer mit einer Subscription wichtig. 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 einem Plan nötig, der mit eigenen Provider-Schlüsseln arbeitet, und dort nur für die Web-Recherche im GDPR-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): Midjourney lässt sich derzeit noch nicht „out of the box“ mit dem Subscription-Modell verwenden. Bitte komm dazu direkt auf uns zu.
Enter your Midjourney ID (midjourneyId, string)

Ü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.

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.

Standard: entfällt
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 AI Plugin für Leichte Sprache in den Versionen 13.3.0/12.9.0 hinzu.

Standard: ChatGPT
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): Diese Einstellung existiert nicht mehr.

Sie steuerte, ob ein übersetzter Datensatz direkt in der Bearbeitungsmaske geöffnet wird oder ob du in der Übersicht des Listen-Moduls bleibst.

Standard: entfällt

Metadaten

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

Amount of metadata suggestions to be displayed (metadataSuggestionCount, options): Wie viele Vorschläge je Feld im Metadaten-Wizard angeboten werden, wählbar von 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 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

Allgemein

Medienspeicher, Datenschutz, Hintergrund-Tasks und die Einstellungen des Audit-Moduls. Letztere sind seit den Versionen 14.5.0/13.17.0/12.23.0 verfügbar und unter AI Audit ausführlich beschrieben.

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
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
Maximum number of CLI background tasks processed per scheduler run (maxTasks, int+): Begrenzt, wie viele Hintergrund-Tasks ein Durchlauf von ai-suite:process-tasks abarbeitet. Siehe CLI-Befehle.

Standard: 50
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

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. Ausgeschaltet wird nichts mehr erfasst und nirgends 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 Seitenmodul und die Hinweise an den KI-befüllten Feldern ein. Ausgeschaltet bleiben das Register und die maschinenlesbare Bildkennzeichnung erhalten, nur die sichtbare Kennzeichnung für die Redaktion entfällt.

Standard: an

Seit den Versionen 14.5.0/13.17.0/12.23.0 sind die Extension-Einstellungen in Kategorien und Unterkategorien neu gegliedert. Die Einstellungen selbst sind dieselben geblieben.

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-Diensten (z. B. DeepL, Google Translate oder ChatGPT) übermittelt werden sollen.

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

Fügt folgenden Block in eure 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.