run_autotest – Autotests ausführen und Ergebnis auswerten (ALBERT | AI Tool)

Hinweise:

Diese Dokumentation bezieht sich auf die aktuellste Version des Plugins ALBERT | AI Dev (Bestandteil der ALBERT | AI Suite). Aktualisieren Sie das hier beschriebene Plugin, um die Dokumentation verwenden zu können.
Wie Sie die KI-Tools in Ihren KI-Voreinstellungen verwenden, erfahren Sie hier: ALBERT | AI agents tools einrichten

Anzeigename: Runs automated tests from a specified path (test folder, subfolder, or single test JS file)

Interner Name: agorum_ai_dev_run_autotest

Was macht das Tool?

Das Tool führt Autotests in agorum core aus und liefert das Ergebnis an die KI zurück. Sie können damit einen ganzen Testordner, einen Unterordner oder eine einzelne Testdatei (JavaScript) ausführen.

Das Tool sammelt dabei alle Ausgaben, die die Tests mit console.log oder console.trace schreiben, und liefert sie zusammen mit dem Testergebnis und einer Zusammenfassung zurück. So sieht die KI nicht nur, ob ein Test fehlschlägt, sondern auch die Werte, die zur Fehlersuche ausgegeben wurden.

Die Tests laufen mit den Rechten des Benutzers, der das Tool aufruft. Ein Testlauf ist auf höchstens 10 Minuten begrenzt.

Achtung: Das Tool führt Programmcode aus. Tests, die Objekte anlegen, ändern oder löschen, tun das tatsächlich im System. Führen Sie Autotests deshalb in einer Entwicklungs- oder Testumgebung aus.

Empfohlener Einsatzzweck

Das Tool ist für die Entwicklung von Konfigurationsprojekten gedacht, im Developer Studio und mit externen Coding Agents wie Claude Code oder Codex:

Fachlogik, die die KI geschrieben hat, durch Autotests absichern und den Test sofort ausführen
Fehler eingrenzen, indem die KI gezielt console.log-Ausgaben in Code oder Test ergänzt und das Ergebnis des Testlaufs auswertet, statt zu vermuten
Nach einer Korrektur die betroffene Testdatei ausführen und zum Abschluss den gesamten Testordner als Regressionsnachweis

Für den Einsatz im Chat ist das Tool nicht vorgesehen. Es ist Bestandteil der Toolgruppe agorum_ai_dev_external_development_tools und steht damit auch über MCP zur Verfügung.

Funktionsbeschreibung

Parameter	Beschreibung
path (Pflicht)	Pfad zu den Tests, die ausgeführt werden sollen. Möglich sind: ein Testordner, etwa `/agorum/roi/customers/<Projekt>/test/js` ein Unterordner davon eine einzelne Testdatei, etwa `/agorum/roi/customers/<Projekt>/test/js/my-test.js`

Rückgabe

Feld	Beschreibung
success	Der Testlauf wurde ausgeführt. Das sagt nichts darüber, ob die Tests bestanden wurden - siehe `summary`.
path	Der übergebene Pfad.
tests	Das vollständige Ergebnis je Testdatei mit Gruppen und einzelnen Tests. Ein fehlgeschlagener Test enthält die Fehlermeldung samt Stacktrace.
log	Alle Zeilen, die während des Testlaufs mit `console.log` oder `console.trace` ausgegeben wurden.
summary	Zusammenfassung mit `total` (Anzahl der Tests), `passed` (ohne Fehler, dazu zählen auch übersprungene Tests) und `failed` (fehlgeschlagen).

Kann der Testlauf nicht gestartet werden, etwa weil der Pfad nicht existiert, liefert das Tool eine Fehlermeldung mit dem Pfad und der Ursache.

Beispiel-Prompt

Führe die Autotests in /agorum/roi/customers/my.project/test/js aus.
Wenn ein Test fehlschlägt, zeige mir die Fehlermeldung und die Log-Ausgaben dazu
und schlage eine Korrektur vor.

Tipps und Tricks

Tipp: Lassen Sie nach einer einzelnen Korrektur nur die betroffene Testdatei ausführen - das geht schneller und das Ergebnis ist übersichtlicher. Den gesamten Testordner führen Sie zum Abschluss aus. Entfernen Sie console.log-Ausgaben, die nur der Fehlersuche dienten, wieder aus dem Code. Wie Autotests in agorum core aufgebaut werden, beschreibt das Entwicklungswissen im Bereich agorum-core-development/autotest, das Sie zusätzlich in Ihre KI-Voreinstellung einbinden sollten.