Konfiguration

ChEddi bringt zwölf eigene Einstellungen mit. Sie liegen in der Extension-Konfiguration unter Admin-Werkzeuge → Einstellungen (ab TYPO3 14: System → Einstellungen) bei cheddi und sind in fünf Kategorien gegliedert. Mit Version 0.3.0 sind die beiden Einstellungen zur Inhaltssuche entfallen.

Server-Adresse und API-Schlüssel stehen bewusst nicht darunter, die kommen aus der Konfiguration der AI Suite. Die ChEddi-Einstellungen kennen im Gegensatz dazu keine Overrides je Backend-Gruppe.

Vererbung: Inherit und strengere Werte

Vier Einstellungen stehen im Auslieferungszustand auf „Inherit“. Sie haben je eine Entsprechung in AI Suite MCP oder in der AI Suite und verhalten sich dann genau wie diese. Damit ist ChEddi ohne eine einzige Einstellung sofort konsistent zum Rest der Installation.

Bei Tabellenliste, rohem HTML und DSGVO-Modus gilt eine feste Regel: Ein gesetzter Wert darf nur strenger sein als die Quelle, nie großzügiger. Konkret:

Die Tabellenliste chatExcludedTables wird zur MCP-Liste hinzugefügt und kürzt sie nie.
chatAllowRawHtmlWrite = Yes kann nicht erlauben, was MCP verbietet.
chatForceGdpa = No nimmt den Chat nicht aus einer installationsweiten DSGVO-Pflicht heraus.

Den Schreibmodus und das ausführliche Protokoll kannst du dagegen frei abweichend setzen.

Der Sinn dahinter: Der Chat sitzt näher am Redakteur als ein externer MCP-Client. Es soll nicht möglich sein, über den bequemeren Weg mehr zu dürfen als über den technischen.

Breaking Change in 0.3.0

Mit Version 0.3.0 entfallen chatSearchAdditionalTables und chatExcludeAdditionalTablesFromSearch, bestehende Werte werden ignoriert. Hintergrund ist, dass AI Suite MCP ab Version 0.9.0 die durchsuchbaren Tabellen selbst aus der TCA ermittelt. Hattest du Tabellen über die zweite Einstellung aus der Suche genommen, werden sie jetzt wieder durchsucht. Trage sie unter chatExcludedTables ein, wenn sie draußen bleiben sollen. Leere nach dem Update alle Caches.

Extension-Einstellungen

Alle Einstellungen im Überblick

Chat

Modellauswahl, Datenschutz und die Lebensdauer der Konversationen.

GDPR compliant mode (chatForceGdpa): Beschränkt die Modellauswahl auf die DSGVO-konformen ChEddi-Modelle, derzeit IONOS Qwen3.5. Die Web-Recherche läuft dann nur über einen EU-Suchanbieter des AI-Suite-Servers und bleibt aus, wenn es keinen gibt oder er die Sprachregion der Website nicht bedient, siehe Web-Recherche. „Inherit“ folgt der Einstellung forceGdpa der AI Suite. Steht dort „Yes“, bleibt der Chat auch mit „No“ hier eingeschränkt.

Standard: Inherit from AI Suite
Session lifetime (days) (chatSessionLifetimeDays): Tage, die eine Konversation ohne Aktivität bestehen bleibt, bevor sie vom Aufräum-Lauf als gelöscht markiert wird. Sieben Tage später wird sie endgültig entfernt, zusammen mit ihren Nachrichten, ihrem Änderungsprotokoll und ihren Anhängen. Ein Anhang bleibt erhalten, wenn er aus dem Ordner „cheddi“ verschoben wurde oder anderswo verwendet wird. Siehe Betrieb.

Standard: 20

Writes

Wohin bestätigte Änderungen geschrieben werden.

Write mode (chatWriteMode): Wohin bestätigte Änderungen geschrieben werden. „Draft workspace“ legt sie in einem Entwurf ab, der bei Bedarf automatisch angelegt wird und ext:workspaces voraussetzt. „Live“ schreibt direkt auf die Live-Seite. „Inherit“ folgt mcpWriteMode. Setze den Wert ausdrücklich, wenn der Redaktionschat sich anders verhalten soll als die technische MCP-Nutzung. Siehe Entwurf oder Live.

Standard: Inherit from MCP
Allow raw HTML write (chatAllowRawHtmlWrite): Ob ChEddi rohes Markup unverändert in Code-Editor-Felder schreiben darf, etwa in ein Inhaltselement vom Typ „HTML“, das TYPO3 ungefiltert ausgibt. „Inherit“ folgt mcpAllowRawHtmlWrite. Auch hier gilt: nur strenger, nie großzügiger. Steht MCP auf „No“, bleibt ein Schreibvorgang aus dem Chat ebenfalls abgelehnt. Wird ein Schreibvorgang abgelehnt, wird nichts gespeichert, der bestehende Wert bleibt also erhalten.

Standard: Inherit from MCP

Tools & tables

Welche Tools und Tabellen ChEddi überhaupt sehen darf. Beide Listen ergänzen bestehende Sperren und kürzen sie nie: die Tool-Liste die eingebaute Sperrliste, die Tabellenliste die Liste aus AI Suite MCP. Die TYPO3-Backend-Rechte gelten zusätzlich.

Excluded tools (chatExcludedTools): Tool-Namen, die ChEddi niemals anbieten darf, zusätzlich zu einer eingebauten Sperrliste. Diese enthält bereits Massenläufe, Medien-Upload, Workspace-Vergleich und Server-Diagnose, also Dinge, für die es ein Backend-Modul gibt.

Die Liste wird bei jedem Turn identisch angewendet. Das ist Absicht: Ein Katalog, der sich von Turn zu Turn ändert, zerstört den Cache des Anbieters für den Prompt-Anfang und kostet messbar mehr, als er spart.

Standard: leer
Excluded tables (chatExcludedTables): Tabellen, die ChEddi weder lesen noch schreiben darf, zusätzlich zur MCP-Liste. Leer bedeutet: genau die MCP-Liste. Der Ausschluss gilt auch für Administratoren.

Standard: leer
Additional searchable tables (chatSearchAdditionalTables): Wurde mit Version 0.3.0 entfernt, bestehende Werte werden ignoriert.

Welche Tabellen die Volltextsuche durchsucht, ermittelt der MCP-Server seit Version 0.9.0 selbst aus der TCA. Eigenständige Datensatztabellen wie die Nachrichten von EXT:news sind damit automatisch dabei.

Standard: entfällt
Exclude auto-detected tables from search (chatExcludeAdditionalTablesFromSearch): Wurde mit Version 0.3.0 entfernt, bestehende Werte werden ignoriert.

Eine Tabelle, die du hier aus der Suche herausgenommen hattest, wird seitdem wieder durchsucht. Soll sie außen vor bleiben, trage sie unter „Excluded tables“ (chatExcludedTables) ein. Das sperrt sie allerdings auch für Lesen und Schreiben.

Standard: entfällt

Web research

Einstellungen der Web-Recherche. Sie greifen erst, wenn die Backend-Gruppe das Recht enable_web_research besitzt, siehe Web-Recherche.

Trusted sources (chatWebResearchAllowedDomains): Domains, auf die die Recherche beschränkt wird. Leer, also die Voreinstellung, durchsucht das offene Web und ist die Empfehlung.

Das ist ein harter Filter, keine Gewichtung: Eine Frage, deren Antwort auf keiner der Domains steht, liefert gar keine Quellen, und ein Assistent ohne Quellen fällt auf sein Gedächtnis zurück. Nutze die Liste nur, wenn ein Thema wirklich auf bekannte Quellen begrenzt ist, halte sie kurz und prüfe sie regelmäßig. Eine vergessene Liste verengt jede weitere Recherche. Höchstens zehn Domains werden übertragen.

Standard: leer
Excluded sources (chatWebResearchBlockedDomains): Domains, die die Recherche nie zurückgibt. Für die meisten Installationen das sicherere Instrument. Wird ignoriert, solange eine Positivliste gesetzt ist, denn beide Anbieter akzeptieren nur eine der beiden Listen. Höchstens zehn Domains werden übertragen.

Standard: leer
Country override (chatWebResearchCountry): Zweistelliger ISO-Ländercode, für den die Treffer lokalisiert werden. Leer nimmt die Region der Standardsprache der Site, was für fast jede Installation richtig ist. Setze ihn, wenn die Redaktion für einen anderen Markt schreibt als die Website selbst.

Standard: leer
Searches per turn (chatWebResearchMaxSearches): Wie viele Suchen ein einzelner Turn ausführen darf. 0 überlässt die Entscheidung dem Server. Ein höherer Wert bringt bei Vergleichsfragen mehr Tiefe und kostet je Suche eine Pauschale, ein niedrigerer deckelt einen ausufernden Rechercheturn.

Logging

Protokollierung des Chats.

Verbose INFO log (chatLogVerbose): Schreibt die ausführliche Ablaufverfolgung nach var/log/cheddi.log: gewähltes Modell, angebotene und aufgerufene Tools, abgerechnete Credits. „Inherit“ folgt mcpLogVerbose. Das Warnprotokoll unter var/log/cheddi_warnings.log läuft davon unabhängig immer mit. Schalte es im Produktivbetrieb ab, sobald die Überwachung steht. Das senkt Schreiblast und die Menge personenbezogener Daten im Protokoll.

Standard: Inherit from MCP
Log redaction patterns (chatLogRedactionPatterns): Zusätzliche reguläre Ausdrücke, deren Treffer im Protokoll durch [REDACTED] ersetzt werden. Eingebaut sind bereits Bearer-Tokens, 64-stellige Hex-Hashes und E-Mail-Adressen, dazu die Muster aus der MCP-Konfiguration. Deine Muster werden zusätzlich angewendet.

Standard: leer

Show larger version

ChEddi konfigurieren wir unter Admin-Werkzeuge → Einstellungen (ab TYPO3 14: System → Einstellungen) in der Extension-Konfiguration von cheddi. Die Einstellungen sind in fünf Kategorien geordnet. Unter Chat stehen der DSGVO-Modus und die Lebensdauer der Konversationen. Steht der DSGVO-Modus auf Inherit, gilt die Einstellung der AI Suite.
Show larger version

Unter Writes legen wir fest, ob ChEddi in einen Entwurf oder live schreibt. Steht ein Wert auf Inherit, gilt die Einstellung von AI Suite MCP.