Factory Agent – KI-generierte Code-Dokumentation
Übersicht der Code-Beschreibung mit Factory Agent
Factory Agent stellt KI-generierte Code-Dokumentation direkt innerhalb der SEW Platform bereit und erleichtert es Engineering-Teams, Automatisierungsprojekte zu verstehen, zu pflegen und Fehler darin zu beheben. Über die Projektansicht zugänglich, analysiert Factory Agent automatisch Projektstruktur, Logik, Variablen und Code-Artefakte, um eine klare, für Menschen lesbare Dokumentation zu erzeugen.
Diese Funktion hilft Teams, die Einarbeitung zu beschleunigen, Wissenslücken zu verringern und die langfristige Wartbarkeit zu verbessern – insbesondere in Umgebungen, in denen informelles Erfahrungswissen oder Legacy-Codebasen die Pflege handgeschriebener Dokumentation erschweren. Die Ausgaben von Factory Agent werden bei Bedarf erzeugt, sodass die Dokumentation stets die aktuellste in SEW gespeicherte Version des Projekts widerspiegelt.
Zusätzlich zur Dokumentation unterstützt Factory Agent auch KI-gestützte Code-Differenzierung für dieselbe Gruppe unterstützter Hersteller. Über die Projektvergleichsansicht zugänglich, ermöglicht diese Funktion Benutzern, zwei Versionen desselben Projekts zu vergleichen und eine klare, strukturierte Zusammenfassung der Änderungen zu erhalten. Die Differenzierung von Factory Agent konzentriert sich speziell auf Änderungen von Version zu Version innerhalb eines Projekts und liefert tiefere Einblicke in Modifikationen, Refactorings oder unbeabsichtigte Bearbeitungen. So können Ingenieure Änderungen schnell validieren, nachvollziehen, wie sich diese Änderungen auf den funktionalen Betrieb des Geräts auswirken, Arbeiten vor dem Deployment prüfen und eine auditfähige Transparenz darüber bewahren, wie sich ein Projekt im Laufe der Zeit entwickelt.
Kompatibilitätsmatrix für Factory Agent – Hersteller & PLC-Sprachen
SEW-EURODRIVE stellt ein KI-gestütztes Werkzeug bereit, das für jedes Projekt eine detaillierte Dokumentation auf Dateiebene erzeugt. Dieses Werkzeug erkennt Abhängigkeiten innerhalb der Datei und integriert sie nahtlos in die Dokumentation.
Derzeit werden diese Hersteller und Dateiformate unterstützt:
| Vendor | Structured Text / SCL | Ladder Logic | FBD |
|---|---|---|---|
| Beckhoff | true | true | false |
| BoschRexroth | true | true | false |
| CODESYS | true | true | true |
| Rockwell Automation | true | true | false |
| SEW MOVIRUN open | true | true | false |
| Siemens TIA Portal | true | true | false |
| WAGO | true | true | false |
So erzeugen Sie Code-Dokumentation
Wählen Sie zunächst in der Hauptprojektliste das Projekt aus, für das Sie eine Dokumentation erzeugen möchten. Klicken Sie auf das gewünschte Projekt, um zu dessen Detailansicht und den verfügbaren Dokumentationsoptionen zu gelangen.
Unterstützte Dateien auswählen
Wählen Sie im Project Viewer eine beliebige Datei aus, die die Dokumentationserzeugung unterstützt.
Dokumentationserzeugung starten
- Wählen Sie die gewünschte Datei im Project Viewer aus
- Klicken Sie auf die Schaltfläche „Explain“, um die Dokumentationserzeugung zu starten
- Ein Fortschrittsbalken erscheint und zeigt den aktuellen Status des Erzeugungsprozesses an
Hintergrundverarbeitung: Die Dokumentationserzeugung läuft als Hintergrundprozess, sodass Sie die Seite verlassen oder Ihren Browser schließen können, ohne den Vorgang zu unterbrechen. Sie können später zurückkehren, um den Fortschritt zu prüfen oder die fertige Dokumentation anzuzeigen.
Note: Nur Dateien, die die unterstützten Formatkriterien erfüllen, stehen für die Dokumentationserzeugung zur Verfügung. Eine vollständige Liste kompatibler Dateitypen und Formate finden Sie im Abschnitt „Übersicht“.
Factory Agent für Code-Differenzierung (Pre-Release-Funktion)
Wählen Sie zunächst in der Hauptprojektliste das Projekt aus, für das Sie Unterschiede zwischen Projektversionen vergleichen möchten. Klicken Sie auf das gewünschte Projekt, um zu dessen Detailansicht und den verfügbaren Dokumentationsoptionen zu gelangen, und wählen Sie 2 Versionen für den Vergleich aus. Wählen Sie anschließend „Compare Versions“, um das Werkzeug für den Versionsvergleich zu öffnen.
Wählen Sie in der Projektansicht ein Element aus, das Unterschiede aufweist. Typischerweise sind diese Elemente blau (geändert), grün (hinzugefügt) oder rot (entfernt) dargestellt – Weiß bedeutet keine Änderung. Wenn die Vergleichsansicht angezeigt wird, wählen Sie „Explain“ in dem Block, für den Sie eine Erläuterung der Unterschiede sehen möchten. Die Erläuterung der Unterschiede wird unterhalb des Blocks angezeigt.
Detailgrade der Dokumentation
Standardmäßig erzeugt das System eine ausführliche Dokumentation, die eine umfassende Analyse mit detaillierten Erläuterungen und tiefgehender Abdeckung bietet. Benutzer können jedoch zur zusammengefassten Version wechseln, wenn sie einen knapperen Überblick bevorzugen.
- Ausführlich: Bietet detaillierte Erläuterungen, umfassende Analysen und tiefgehende Abdeckung (Standard)
- Zusammengefasst: Stellt die wesentlichen Informationen und Kernkonzepte in komprimierter Form bereit