Seit den Versionen 12.19.0 / 13.13.0 / 14.1.0 stellt die AI Suite Console-Commands bereit, mit denen Integratoren AI-Suite-Operationen, etwa Metadaten-Generierung und Übersetzungen, automatisiert über die Kommandozeile oder den TYPO3-Scheduler ausführen können. Begleitend gibt es das Backend-Modul „AI Suite CLI“ unter Werkzeuge als Status-Übersicht. Voraussetzung für die Ausführung ist die Berechtigung „Enable CLI workflow execution“ (enable_cli_workflow_execution); Details unter Berechtigungsmanagement.

Führt einen AI-Suite-Workflow (Metadaten-Generierung oder Übersetzung) aus und legt Tasks zur späteren CLI-Verarbeitung an. Wichtigste Optionen:

• --type, -t: Workflow-Typ page, pageTranslate, fileReferences, fileMetadata, fileMetadataTranslation
• --model, -m: zu verwendendes KI-Modell
• --start-from-pid: Start-Seiten-ID (für seitenbasierte Typen)
• --page-type, --depth, --column: Seitentyp-Filter, Traversierungstiefe, zu verarbeitende Spalte
• --sys-language: Systemsprache (locale-ID)
• --source-language, --target-language, --translation-scope (all | metadata | content): für Übersetzungs-Workflows
• --directory: zu verarbeitendes Verzeichnis, z. B. /, /user_upload/ oder 1:/user_upload/
• --show-only-empty, --show-only-used: nur leere Felder bzw. nur verwendete Dateien berücksichtigen

Fragt den AI-Server nach dem Status der CLI-verarbeiteten Hintergrund-Tasks ab und speichert fertige Ergebnisse. Dieser Befehl ist der ideale Kandidat für einen wiederkehrenden Scheduler-Task, der die per execute-workflow angelegten Aufgaben automatisch abarbeitet.

Wiederholt fehlgeschlagene CLI-Hintergrund-Tasks, aktuell beschränkt auf den Status task-error.

• --type, -t: Filter nach Task-Typ (gleiche Typen wie bei execute-workflow)
• --model, -m: überschreibt das verwendete KI-Modell (ohne Angabe wird das ursprüngliche Modell des Tasks genutzt)

Das Modul liegt im Bereich Werkzeuge. Es zeigt ausstehende und fehlgeschlagene CLI-Tasks, gruppiert nach Scope, inklusive Statistik und Typ-Filter. Zusätzlich wird angezeigt, ob der TYPO3-Scheduler verfügbar ist und ob der Befehl ai-suite:process-tasks bereits als Scheduler-Task eingerichtet wurde.

Der typische Ablauf: execute-workflow erzeugt die Tasks, process-tasks (idealerweise per Scheduler) verarbeitet sie, das CLI-Modul überwacht den Status und retry-tasks setzt fehlgeschlagene Tasks neu auf.

Relevante Einstellungen in den Global Settings: maxTasks (maximale Anzahl gleichzeitig verarbeiteter Hintergrund-Tasks) sowie der GDPR-Mode. Für die Hintergrundverarbeitung ist außerdem die Berechtigung „Enable background task handling“ erforderlich (siehe Berechtigungsmanagement).

Typische Aufrufe, jeweils per Klick kopierbar. [model] durch die Kennung des gewünschten KI-Modells ersetzen.

Seiten-Metadaten generieren

vendor/bin/typo3 ai-suite:execute-workflow -t page --start-from-pid=123 --depth=2 --show-only-empty -m [model]

Ganze Seite übersetzen

vendor/bin/typo3 ai-suite:execute-workflow -t pageTranslate --start-from-pid=123 --source-language=0 --target-language=1 --translation-scope=all -m [model]

File-Metadaten generieren

vendor/bin/typo3 ai-suite:execute-workflow -t fileMetadata --directory="1:/user_upload/" --show-only-empty -m [model]

Tasks verarbeiten (Scheduler)

vendor/bin/typo3 ai-suite:process-tasks

Fehlgeschlagene Tasks wiederholen

vendor/bin/typo3 ai-suite:retry-tasks -t page