Factory Agent – AI által generált kóddokumentáció
A Factory Agent kódleírás áttekintése
A Factory Agent közvetlenül az SEW Platformon belül biztosít AI által generált kóddokumentációt, ezzel megkönnyítve a mérnöki csapatok számára az automatizálási projektek megértését, karbantartását és hibaelhárítását. A Project View nézeten keresztül elérhető Factory Agent automatikusan elemzi a projekt struktúráját, logikáját, változóit és kódelemeit, hogy áttekinthető, ember által olvasható dokumentációt készítsen.
Ez a képesség segít a csapatoknak felgyorsítani a betanulást, csökkenteni a tudásbeli hiányosságokat és javítani a hosszú távú karbantarthatóságot – különösen olyan környezetekben, ahol a szájhagyomány útján terjedő tudás vagy az örökölt kódbázisok megnehezítik a kézzel írt dokumentáció karbantartását. A Factory Agent kimenetei igény szerint generálódnak, így biztosítva, hogy a dokumentáció a projekt SEW-ben tárolt legfrissebb verzióját tükrözze.
A dokumentáción túl a Factory Agent AI-támogatott kódösszehasonlítást is támogat ugyanazon támogatott gyártók körében. A Compare Projects View nézeten keresztül elérhető funkció lehetővé teszi, hogy a felhasználók összehasonlítsák ugyanazon projekt két verzióját, és világos, strukturált összefoglalót kapjanak a változásokról. A Factory Agent összehasonlítása kifejezetten a projekten belüli verzióról verzióra történő változásokra összpontosít, mélyebb betekintést nyújtva a módosításokba, a refaktorálásba vagy a nem szándékolt szerkesztésekbe. Ez lehetővé teszi a mérnökök számára, hogy gyorsan validálják a változtatásokat, megértsék, hogyan hatnak ezek a változások az eszköz funkcionális működésére, telepítés előtt átnézzék a munkát, és auditra kész átláthatóságot tartsanak fenn arról, hogyan fejlődik a projekt az idő során.
Factory Agent gyártói és PLC-nyelvi kompatibilitási mátrix
A SEW-EURODRIVE olyan AI-alapú eszközt biztosít, amely fájlszinten részletes dokumentációt generál minden projekthez. Ez az eszköz azonosítja a fájlon belüli függőségeket, és zökkenőmentesen beépíti azokat a dokumentációba.
Jelenleg a következő gyártók és fájlformátumok támogatottak:
| 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 |
Hogyan generáljunk kóddokumentációt
Kezdje azzal, hogy a fő projektlistából kiválasztja azt a projektet, amelyhez dokumentációt szeretne generálni. Kattintson a kívánt projektre a részletes nézet és az elérhető dokumentációs beállítások megnyitásához.
Támogatott fájlok kiválasztása
A Project Viewer nézetben válasszon ki bármely olyan fájlt, amely támogatja a dokumentáció generálását.
A dokumentációgenerálás elindítása
- Válassza ki a kívánt fájlt a Project Viewer nézetben
- Kattintson az „Explain” gombra a dokumentációgenerálási folyamat elindításához
- Megjelenik egy folyamatjelző sáv, amely a generálási folyamat aktuális állapotát mutatja
Háttérben történő feldolgozás: A dokumentációgenerálás háttérfolyamatként fut, így a művelet megszakítása nélkül elnavigálhat az oldalról vagy bezárhatja a böngészőjét. Később visszatérhet a folyamat állapotának ellenőrzéséhez vagy az elkészült dokumentáció megtekintéséhez.
Megjegyzés: Csak azok a fájlok érhetők el dokumentációgenerálásra, amelyek megfelelnek a támogatott formátumok kritériumainak. A kompatibilis fájltípusok és formátumok teljes listáját az Áttekintés részben találja.
Factory Agent kódösszehasonlításhoz (előzetes kiadású funkció)
Kezdje azzal, hogy a fő projektlistából kiválasztja azt a projektet, amelynek verziói közötti különbségeket össze szeretné hasonlítani. Kattintson a kívánt projektre a részletes nézet és az elérhető dokumentációs beállítások megnyitásához, majd válasszon ki 2 összehasonlítandó verziót. Innen válassza a „Compare Versions” lehetőséget a verzió-összehasonlító eszköz megnyitásához.
A projektnézetben válasszon ki egy olyan elemet, amely eltéréseket mutat. Ezek az elemek jellemzően kék (módosított), zöld (hozzáadott) vagy piros (eltávolított) színnel jelennek meg – a fehér azt jelenti, hogy nincs változás. Amikor megjelenik az összehasonlító nézet, válassza az „Explain” lehetőséget abban a blokkban, amelyhez az eltérés magyarázatát szeretné látni. Az eltérés magyarázata a blokk alatt jelenik meg.
Dokumentációs részletességi szintek
Alapértelmezés szerint a rendszer részletes dokumentációt generál, amely átfogó elemzést nyújt kifejtett magyarázatokkal és mélyreható lefedettséggel. A felhasználók azonban átválthatnak az összefoglalt változatra, ha tömörebb áttekintést részesítenek előnyben.
- Részletes: Kifejtett magyarázatokat, átfogó elemzést és mélyreható lefedettséget kínál (alapértelmezett)
- Összefoglalt: A lényeges információkat és kulcsfogalmakat tömörített formában adja meg