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.
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 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)
-
Hält die bei DeepL hinterlegten Glossare mit deinen Glossar-Einträgen in TYPO3 synchron, siehe Glossarfunktion.
Standard:
an - 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-taskslä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 wie1:/user_upload/ai-imagesist 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-tasksabarbeitet. 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
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.