Installation
ChEddi wird wie jede andere TYPO3-Erweiterung installiert. Alle benötigten Abhängigkeiten, insbesondere die AI Suite und der MCP-Server, 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.0/13.18.0/12.24.0 und AI Suite MCP 0.9.0. Leere nach jedem Update alle Caches.
1. Erweiterung per Composer installieren
composer require autodudes/cheddi
Voraussetzungen
| Abhängigkeit | Version | Wofür |
|---|---|---|
| TYPO3 CMS | 12.4.11 bis 14.3.x | Backend-Extension, unterstützt v12, v13 und v14 parallel |
| PHP | ab 8.1 | |
autodudes/ai-suite | 12.24.0 bis 14.x | Infrastruktur, Rechtemodell, gemeinsame Dienste |
autodudes/ai-suite-mcp | 0.9.0 bis 0.9.x | Tool-Registry und Rechteprüfung der Tools |
typo3/cms-workspaces | 12.4.11 bis 14.3.x | Pflicht. Der Standard-Schreibmodus leitet bestätigte Änderungen über einen Entwurf |
typo3/cms-scheduler | 12.4.11 bis 14.3.x | Pflicht. Für das automatische Aufräumen alter Konversationen |
typo3/cms-reports | 12.4.11 bis 14.3.x | Pflicht seit Version 0.3.0. Für den Umgebungsbericht im Modul 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 „Enable Chat 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.
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 AI-Suite-Modul.