ecu.test agent¶
Der ecu.test agent hilft dir, Testschritte mit KI zu erzeugen. Er liest die aktuelle Blockbeschreibung und den relevanten Workspace-Kontext aus und fügt passende Testschritte für dich ein. Dafür verbindet er sich mit deinem aktiven globalen Mapping, globalen Konstanten, konfigurierten Bibliotheksworkspaces und analysiert das aktuelle Package. Er kann zudem aus deinen vorhandenen Packages lernen, wenn du Referenzimplementierungen bereitstellst.
Um den agent in deinem Workspace zu nutzen, musst du ihn mit dem agent-Service verbinden und nach deinen Bedürfnissen konfigurieren.
Einrichtung¶
Verwende , um den agent zu verbinden und zu konfigurieren.
Verbindung¶
Url: Basis-URL des agent-Services.
Api-token: Authentifizierungs-Token für den Dienst. Du kannst das Token ein-/ausblenden.
Proxy-Einstellungen: Optional kannst du einen Proxy konfigurieren. Unterstützte Modi: Kein Proxy, Systemproxy, Benutzerdefiniert (mit optionaler Authentifizierung). Browser-/PAC-Proxys werden derzeit nicht unterstützt.
Info
Klicke auf Check, um die Konnektivität zu verifizieren. Bei Erfolg zeigt der Dialog OK. Wenn du mit unserem Dienst verbunden bist, werden zudem deine verbleibenden Credits angezeigt.
Referenzimplementierungs-Kontexte¶
Um die Qualität der generierten Schritte zu verbessern, kannst du dem agent erlauben, aus deinen vorhandenen Packages zu lernen. Wiederkehrende Muster und Lösungen werden erkannt und auf den aktuellen Block übertragen. Das kann die Qualität der generierten Schritte deutlich verbessern.
Füge einen oder mehrere benannte Kontexte hinzu. Jeder Kontext verweist auf einen Ordner, der Packages als „Referenzimplementierungen“ enthält.
Klicke auf Generieren, um für diesen Ordner Referenzen zu erzeugen. Der Status zeigt „Aktuell“, „Veraltet“ oder „Nicht generiert“ einschließlich des Erstellungsdatums.
Im Testfall-Editor kannst du im Dropdown der Toolbar Mit agent generieren den zu verwendenden Kontext auswählen.
Details siehe Referenzimplementierungen.
Filtereinstellungen¶
Hier kannst du konfigurieren, wie viele Elemente jeder Kategorie der agent bei der Generierung berücksichtigen soll. Das ist eine Art Vorfilterung, um die an den Dienst gesendeten Datenmengen zu begrenzen.
Signal-Mappings: Anzahl der berücksichtigten Signal-Mappings.
Jobs: Anzahl der berücksichtigten Tool- und Port-Jobs.
Package-Mappings: Anzahl der berücksichtigten Package-Mappings.
Package aus Bibliotheks-Workspaces: Anzahl der berücksichtigten Bibliotheks-Package.
Packagevariablen: Anzahl der berücksichtigten Packagevariablen.
Globale Konstanten: Anzahl der berücksichtigten globalen Konstanten.
Referenzimplementierungs-Blöcke: Anzahl der einbezogenen, am besten passenden Referenz-Blöcke.
Info
Die Summe aller Filterlimits darf 50 nicht überschreiten. Höhere Werte können die Qualität verbessern, erhöhen jedoch Anfragengröße und Latenz.
Benutzerdefinierte Anweisungen¶
Mit diesen Anweisungen kannst du den agent weiter an die individuellen Bedürfnisse deines Projekts anpassen und die Generierungsqualität verbessern.
Info
Formuliere klare Anweisungen (z. B. Stilregeln, Namenskonventionen, bevorzugte/zu vermeidende Elemente).
So erzeugst du Testschritte¶
Wähle im Testfall-Editor einen Block aus, dessen Inhalt du generieren möchtest. Klicke mit der rechten Maustaste und verwende , um Testschritte für diesen Block zu erzeugen.
Du kannst auch die Schaltfläche in der Toolbar (Dropdown-Menü) verwenden:
: Generiert nur für die ausgewählten Blöcke.
: Generiert nur für Blöcke, die noch keine Schritte haben.
: Generiert für alle Blöcke.
Info
Wähle im selben Dropdown einen Referenzimplementierungs-Kontext aus, um den agent zu steuern. Es sind nur Kontexte auswählbar, für die in den Einstellungen Referenzen generiert wurden. Details siehe Referenzimplementierungen. Prüfe die generierten Schritte, bevor du den Testfall ausführst.
Info
Gib eine klare Blockbeschreibung an (Aktion, Parameter, Erwartung), siehe So verbesserst du die Qualität der generierten Testschritte.
Unterstützte Testschritte¶
Der agent kann diese Testschritte generieren und parametrisieren:
Mappings lesen und prüfen (mit optionalen Toleranz- und Zeitoptionen)
Mappings schreiben
Warten
Berechnungen durchführen und prüfen
Tool- und Port-Jobs parametriert aufrufen
Package-Aufruf (Workspace- oder Bibliotheks-Package mit Ein-/Ausgabeparametern)
If-Then-Else
MultiCheck
Falls der agent keine passenden Schritte generieren kann, fügt er ein To-do hinzu und informiert dich, welche zusätzlichen Informationen ggf. fehlen. Wenn die Antwort des agent nicht verarbeitet werden kann, wird ein Kommentar eingefügt, damit du die Blockbeschreibung anpassen und es erneut versuchen kannst.
Welche Informationen der agent berücksichtigt¶
Der agent stellt aus deinem Projekt einen Kontext zusammen, um die Generierung zu steuern. Elemente werden mithilfe der Filterlimits unter gefiltert.
Aktuelle Blockbeschreibung: Aktion, Parametrierung und Erwartung.
Aktuelle Package-Implementierung: Andere Blöcke aus dem geöffneten Package.
Packagevariablen: Parameter und Rückgabewerte des aktuellen Packages, einschließlich Typ und Beschreibung.
Signal-Mappings: Signal-Mappings aus dem globalen Mapping mit Namen, Pfaden, Typen und Beschreibungen.
Tool- und Port-Jobs aus dem globalen Mapping mit Namen und Beschreibungen.
Package-Mappings: Zugeordnete Packages aus dem globalen Mapping mit Name, Beschreibung und Pfad. Der Agent berücksichtigt auch Parameter-/Rückgabebezeichner und Beschreibungen dieser Packages.
Package aus Bibliotheks-Workspaces: In konfigurierten Bibliotheksworkspaces gefundene Packages.
Globale Konstanten: Globale Konstanten der aktuellen Konfiguration mit Werten und Beschreibungen.
Referenzimplementierungen: Die ähnlichsten Blöcke aus dem ausgewählten Referenzimplementierungs-Kontext.
Deine benutzerdefinierten Anweisungen, wie in den Einstellungen definiert.
So verbesserst du die Qualität der generierten Testschritte¶
Sei in Blöcken konkret¶
Aktion: Beschreibe das Ziel, nicht die Lösung.
Parametrierung: Gib relevante Eingaben, Einschränkungen, Bereiche und Einheiten an.
Erwartung: Nenne beobachtbare Ergebnisse, Schwellenwerte, Toleranzen und Zeiten.
Benutzerdefinierte Anweisungen verwenden¶
Füge Stil- und Namenskonventionen hinzu (z. B. Variablenpräfixe, erforderliche Einheiten, erlaubte Mappings).
Hebe die Verwendung bestimmter Signale, Variablen oder Konstanten hervor bzw. schränke sie ein.
Wende testspezifische Strategien an (z. B. nach dem Lesen warten, Toleranzen hinzufügen, eine bestimmte Aktion stets am Beginn/Ende eines Testfalls ausführen usw.).
Wende domänenspezifische Logik oder Regeln an.
Halte es klar, konkret und konsistent; verwende Aufzählungen oder kurze Sätze.
Filtereinstellungen anpassen¶
Erhöhe Limits für Kategorien, die für deinen Block am wichtigsten sind, halte die Summe jedoch unter 50.
Sollen nur Package-Aufrufe generiert werden, setze das Limit der Signal-Mappings auf 0; umgekehrt, wenn ausschließlich Signal-Mappings gewünscht sind.
Niedrigere Limits können Latenz und Kosten reduzieren.
Gute Metadaten pflegen¶
Füge klare Beschreibungen zu Mappings, Variablen, globalen Konstanten und Packages hinzu.
Referenzimplementierungen verwenden¶
Erzeuge Referenzen für repräsentative Packages und wähle diesen Kontext in der Toolbar aus. Generiere erneut, wenn sich die Quell-Packages ändern.
Referenzimplementierungen¶
Referenzimplementierungen ermöglichen es dem agent, aus deinen vorhandenen Packages zu lernen. Wiederkehrende Muster und Lösungen werden erkannt und auf den aktuellen Block übertragen. Das kann die Qualität der generierten Schritte deutlich verbessern.
Kontext hinzufügen¶
Öffne .
Klicke auf die Registerkarte +, gib einen Namen ein und lege den Pfad fest (workspace-relative Pfade werden unterstützt).
Klicke auf Generieren, um die Referenzen für diesen Ordner zu erzeugen.
Der Status zeigt Aktuell mit dem Erzeugungsdatum. Er wird Veraltet, wenn sich Quelldateien ändern.
Anstatt auf Generieren zu klicken, kannst du auch aktivieren. In diesem Fall werden die Referenzen automatisch aktualisiert, sobald du im Testfall-Editor Testschritte erzeugst. Diese Einstellung beeinflusst den aktuell selektierten Kontext.
Kontext auswählen¶
Öffne im Testfall-Editor das Dropdown und wähle den gewünschten Kontext. Nur Kontexte mit erzeugten Referenzen sind aktiviert.
Der agent berücksichtigt die am besten passenden Blöcke (gemäß deinem Limit). Die Übereinstimmung basiert auf der semantischen Ähnlichkeit zwischen der aktuellen Blockbeschreibung und den Referenzblöcken.
Info
Falls Referenzen für den ausgewählten Kontext fehlen oder veraltet sind, wirst du aufgefordert, diese zu erzeugen, bevor der agent Schritte generieren kann.
Info
Packages oder Verzeichnisse mit einem vorangestellten Punkt (z.B. .hiddenPackage.pkg) gelten
als versteckt und werden nicht in die Referenzen aufgenommen.
Warnung
Das Generieren von Referenzimplementierungen kann je nach Anzahl und Größe der Packages einige Zeit in Anspruch nehmen. Wir empfehlen, nur repräsentative Packages zu verwenden, welche typische Lösungen für deine Testszenarien enthalten.