Installation
ChEddi wird wie jede andere TYPO3-Extension installiert. Alle benötigten Abhängigkeiten, insbesondere die AI Suite und AI Suite MCP, werden dabei automatisch mitinstalliert und müssen nicht separat hinzugefügt werden.
Seit Version 0.3.0 bringt ChEddi die Bibliotheken zum Lesen von Anhängen selbst mit und läuft damit auch in TYPO3-Installationen ohne Composer (Classic Mode) unter TYPO3 12, 13 und 14. Vorausgesetzt werden mindestens AI Suite 14.6.1/13.18.1/12.24.1 und, seit Version 0.4.0, AI Suite MCP 0.11.x. Leere nach jedem Update alle Caches.
Extension per Composer installieren
composer require autodudes/cheddi
-
Show larger version
ChEddi ist eine eigene Extension und baut auf der AI Suite und auf AI Suite MCP auf. Sie kommt per Composer oder über das TYPO3 Extension Repository ins Projekt. Danach leeren wir den TYPO3- und den PHP-Cache.
Voraussetzungen
| Abhängigkeit | Version | Wofür |
|---|---|---|
| TYPO3 CMS | 14.3.x/13.4.x/12.4.x (mindestens 13.4.1 bzw. 12.4.11) | Backend-Extension, unterstützt v12, v13 und v14 parallel |
| PHP | 8.1 oder neuer (ab TYPO3 13 PHP 8.2) | |
autodudes/ai-suite | 14.6.1/13.18.1/12.24.1 (je Major, vorgegeben durch AI Suite MCP 0.11) | Infrastruktur, Rechtemodell, gemeinsame Dienste |
autodudes/ai-suite-mcp | 0.11.0 bis 0.11.x | Tool-Registry und Rechteprüfung der Tools |
typo3/cms-workspaces | 14.3.x/13.4.x/12.4.x (mindestens 13.4.1 bzw. 12.4.11) | Pflicht. Der Standard-Schreibmodus leitet bestätigte Änderungen über einen Entwurf |
typo3/cms-scheduler | 14.3.x/13.4.x/12.4.x (mindestens 13.4.1 bzw. 12.4.11) | Pflicht. Für das automatische Aufräumen alter Konversationen |
typo3/cms-reports | 14.3.x/13.4.x/12.4.x (mindestens 13.4.1 bzw. 12.4.11) | Pflicht seit Version 0.3.0. Für den Umgebungsbericht im Statusbericht (System → Berichte, ab TYPO3 14: Verwaltung → Berichte) |
| PDF-, Word- und Tabellen-Bibliotheken | Textextraktion aus angehängten Dokumenten. Seit Version 0.3.0 mitgeliefert, damit ChEddi auch ohne Composer läuft |
Schritte im Backend
- Extension aktivieren. Sie bringt ihre Datenbanktabellen mit, führe also anschließend den Datenbankvergleich aus.
- Berechtigung vergeben. Die betroffenen Backend-Gruppen brauchen das Recht „Chat-Oberfläche aktivieren“ (Enable Chat Interface,
enable_cheddi_interface). Ohne dieses Recht wird der Chat gar nicht erst eingebunden, siehe Berechtigungen. - Modellrechte prüfen. Jede Gruppe braucht zusätzlich das Recht für mindestens ein chatfähiges Modell. Fehlt es, bleibt die Modellauswahl leer und der Eingabebereich zeigt einen Hinweis.
Leere danach alle Caches.
-
Show larger version
Mit freigeschaltetem Recht, mindestens einem ChEddi-Modell und gültigem API-Schlüssel der AI Suite begrüßt uns ChEddi und nennt Schreibmodus, Datenschutz und Web-Recherche.
Kein eigener API-Schlüssel
Server-Adresse und API-Schlüssel werden nicht bei ChEddi hinterlegt, sondern aus der Konfiguration der AI Suite gelesen (aiSuiteServer und aiSuiteApiKey), samt der Overrides je Backend-Gruppe.
Fehlt der API-Schlüssel, startet der Chat keinen Turn. Der Eingabebereich bleibt gesperrt und zeigt denselben Hinweis wie das Backend-Modul „AI Suite“.
-
Show larger version
Fehlt der API-Schlüssel der AI Suite, bleibt der Eingabebereich gesperrt. ChEddi weist darauf hin, den Schlüssel in der Extension-Konfiguration zu hinterlegen.