TYPO3 für Künstliche Intelligenz anpassen: Gute Struktur bringt bessere Ergebnisse

Programme mit Künstlicher Intelligenz arbeiten in TYPO3-Projekten. Wir nennen diese Programme KI-Agenten. Oft machen KI-Agenten Fehler. Das liegt nicht an fehlender Rechenleistung. Das liegt an schlechtem Code. Der Code ist oft zu unübersichtlich. Der KI-Agent versteht den Zusammenhang nicht. Dann macht er Fehler. Das kostet viel Zeit.

Der Aufbau des Codes ist sehr wichtig. Er ist wichtiger als die Version der Künstlichen Intelligenz. Das hat ein Test von der Firma LangChain gezeigt. Ein KI-Agent wurde dort viel besser. Er machte vorher 52 Prozent der Aufgaben richtig. Danach machte er fast 67 Prozent richtig. Die Entwickler haben die Künstliche Intelligenz nicht getauscht. Sie haben nur die Arbeitsumgebung verbessert. Der KI-Agent bekam klarere Regeln. Er bekam schnellere Rückmeldungen.

Der Aufbau des Codes bestimmt die Qualität von der Künstlichen Intelligenz.

Dieser Artikel erklärt zwei wichtige Dinge. Was macht TYPO3 schon für maschinenlesbaren Code? Maschinenlesbar bedeutet: Ein Computer kann den Code gut verstehen. Und was können Sie in Ihrem eigenen Projekt tun?

Inhaltsverzeichnis  

Warum gut lesbarer Code jetzt wichtig ist  

Früher haben nur Menschen den Code gelesen. Sie hatten Zeit zum Lernen. KI-Agenten arbeiten anders. Sie haben nur wenig Zeit. Sie müssen das Wichtigste schnell finden. Lange Texte sind ein Problem für KI-Agenten. Sie vergessen oft den Mittelteil. Sie merken sich nur den Anfang und das Ende. Das nennt man Aufmerksamkeitskurve. Große Textmengen machen dieses Problem noch schlimmer.

Für TYPO3 bedeutet das: Zu viel Text im Code ist schlecht. Wiederholungen sind schlecht. Versteckte Regeln sind schlecht. Ein KI-Agent macht dann schnell Fehler. Er wählt falsche Wege. Er fragt unnötig oft nach.

Was TYPO3 schon mitbringt  

TYPO3 verbessert sich seit einigen Jahren. Diese Änderungen helfen der Künstlichen Intelligenz sehr. Das war am Anfang gar nicht der Plan. Darum eignet sich TYPO3 heute sehr gut für KI-Agenten. Es funktioniert oft besser als andere Systeme.

Schema API und Record API  

Seit Version 13.2 gibt es die Schema API. API ist das englische Wort für Schnittstelle. Entwickler greifen damit besser auf Daten zu. Sie nutzen keine direkten Arrays mehr. Ein Array ist eine unübersichtliche Liste im Code. Die Record API wandelt Daten automatisch um. Das ist sehr gut für KI-Agenten. Sie müssen weniger Listen durchsuchen. Sie erkennen Daten viel besser. TYPO3 verändert die Schema API aber vielleicht noch. Die Arbeiten daran laufen noch.

Genaue Regeln in Extbase  

TYPO3 Version 13 verlangt genaue Regeln. Wir nennen das strikte Typisierung. Der Code muss klar benennen, was er tut. In Version 14 geht das weiter. TYPO3 nutzt dort nur noch neue PHP-Attribute. Das ist ein großer Gewinn für KI-Agenten. Sie können diese Attribute gut lesen. Sie können den Code besser prüfen.

Fluid 5.0 prüft strenger  

Fluid macht die Vorlagen für das Design. In TYPO3 14 prüft Fluid die Daten strenger. Falsche Daten fallen sofort auf. Das System zeigt sofort einen Fehler an. Der Fehler bleibt nicht versteckt. Das hilft KI-Agenten sehr. Sie merken sofort, wenn sie einen Fehler machen.

PSR-14 Events  

TYPO3 tauscht alte Technik gegen neue Events aus. Events sind Ereignisse im System. Diese Events haben klare Regeln. KI-Agenten finden diese Events viel leichter. Sie können die Events fehlerfrei nutzen.

Inhaltsblöcke  

Es gibt neue Inhaltsblöcke für TYPO3. Entwickler schreiben alles in eine einzige Datei. Die Datei heißt config.yaml. Das System erstellt den Rest automatisch. Das ist viel einfacher für KI-Agenten. Die Inhaltsblöcke kommen aus der TYPO3-Gemeinschaft.

Hilfen für den Wechsel  

Es gibt Programme für den Wechsel auf TYPO3 14. Diese Programme heißen Rector und Fractor. Sie verändern alten Code vollautomatisch. Die TYPO3-Gemeinschaft hat das bezahlt. KI-Agenten sparen dadurch sehr viel Zeit. Sie müssen alte Muster nicht mehr suchen.

Was Sie in Ihrem Projekt tun können  

TYPO3 liefert ein gutes Fundament. Aber Ihr Projekt ist sehr wichtig. Sie müssen den Aufbau gut planen. Sie müssen klare Regeln aufschreiben.

Neue Regeln für Daten  

Alter Code in TYPO3 ist oft sehr lang. Ein KI-Agent muss viele Zeilen lesen. PHP 8.4 bringt eine neue Funktion. Sie heißt Property Hooks. Damit sparen Entwickler sehr viel Code. Die Regeln stehen direkt bei den Daten. Das ist viel übersichtlicher.

<?php
declare(strict_types=1);

final class Article extends AbstractEntity
{
  protected string $title = '';

  public function getTitle(): string
  {
      return $this->title;
  }

  public function setTitle(string $title): void
  {
      $this->title = trim($title);

<?php
declare(strict_types=1);

final class Article extends AbstractEntity
{
  public string $title = '' {
      set {
          $value = trim($value);
          if ($value === '') {
              throw new \InvalidArgumentException('Title must not be empty');
          }
          $this->title = $value;
      }
  }
}

Inhaltsblöcke statt langen Listen  

TCA ist ein wichtiges System in TYPO3. Aber TCA ist eine sehr lange Liste. KI-Agenten können diese Liste schlecht lesen. Inhaltsblöcke sind viel besser. Die Erklärung steht in einer einfachen Datei. Die Datei heißt YAML. Ändern Sie einen Inhalt? Dann ändern Sie nur eine einzige Datei.

name: webconsulting/faq-item
title: FAQ Item
typeName: wc_faq_item
fields:
- identifier: question
  type: Text
  required: true
- identifier: answer
  type: Textarea
- identifier: teaser_image
  type: File

Der DataHandler speichert Daten  

Ein KI-Agent ändert Daten in TYPO3. Dafür muss er den richtigen Weg nehmen. Dieser Weg heißt DataHandler. Der DataHandler beachtet alle Regeln. Er prüft Rechte und Verbindungen. Andere Wege sehen manchmal schneller aus. Aber sie machen das System kaputt. Nutzen Sie immer den DataHandler.

<?php
declare(strict_types=1);

use TYPO3\CMS\Core\DataHandling\DataHandler;
use TYPO3\CMS\Core\Utility\GeneralUtility;

$data = [
  'tt_content' => [
      'NEW123' => [
          'pid' => 42,
          'CType' => 'textmedia',
          'header' => 'KI-fitte TYPO3-Architektur',
      ],
  ],
];

Regeln für das Projekt  

Ein KI-Agent braucht immer feste Regeln. Sonst rät er einfach. Forscher haben das genau getestet. Feste Regeln machen den KI-Agenten viel besser. Er macht weniger Fehler. Schreiben Sie eine Datei mit Regeln. Die Datei heißt oft AGENTS.md. Alle Werkzeuge verstehen diese Datei. Das ist der Standard.

ALWAYS use TYPO3 DataHandler for write operations on TCA-managed records.
NEVER inject DataHandler via the constructor of another service.
ALWAYS prefer Content Blocks over manual TCA/SQL for new content types.
ALWAYS use PHP attributes (#[AsEventListener]) instead of Services.yaml tags.
ALWAYS run PHPStan and tests before proposing a refactoring as complete.
NEVER bypass Schema API with direct $GLOBALS['TCA'] access in new code.

Die richtige Arbeitsumgebung  

Die Arbeitsumgebung ist wichtiger als der Code. Wir nennen das Harness Engineering. Es gibt automatische Tests in der Umgebung. Es gibt Prüfprogramme. Es gibt feste Regeln. Entwickler müssen diese Umgebung bauen. Dann kann der KI-Agent gut arbeiten.

Die Firma OpenAI hat das erfolgreich getestet. Wenige Entwickler bauten eine gute Umgebung. Die KI-Agenten schrieben dann eine Million Zeilen Code. Alles funktionierte perfekt.

Ein gutes TYPO3-Projekt braucht diese Dinge:

Klare Vorgaben statt Text  

Normale Texte sind schlecht für KI-Agenten. Normale Texte sind oft ungenau. 20 KI-Agenten lösen eine Aufgabe auf 20 verschiedene Arten. Das hat ein Test bewiesen. Die Vorgaben müssen maschinenlesbar sein.

Nutzen Sie klare Verträge im Code. Der KI-Agent kennt diese Muster schon. Er macht dann genau das Richtige.

Ein Plan für alte TYPO3-Projekte  

Fazit  

Sie machen TYPO3 fit für die Künstliche Intelligenz. Das hilft Maschinen und Menschen. Beide arbeiten mit weniger Code besser zusammen. Alles wird klarer und sicherer.

TYPO3 hat einen großen Vorteil. Das System modernisiert sich bereits. Gute Werkzeuge sind schon da. Sie können die Werkzeuge sofort nutzen. Sie müssen nur damit anfangen.

Es gibt drei sehr wichtige Dinge für Ihr Projekt. Erstens: Schreiben Sie kürzeren Code. Zweitens: Machen Sie klare Verträge im Code. Drittens: Sichern Sie alles mit automatischen Tests ab.

Wir helfen Ihnen sehr gerne dabei. Wir prüfen Ihren aktuellen Code. Das nennen wir Architektur-Review. Das ist ein sehr guter Start. Sprechen Sie uns an.