Factory Agent – dokumentácia kódu generovaná umelou inteligenciou
Prehľad popisu kódu vo Factory Agent
Factory Agent poskytuje dokumentáciu kódu generovanú umelou inteligenciou priamo v rámci SEW Platform, čím uľahčuje inžinierskym tímom porozumenie, údržbu a riešenie problémov automatizačných projektov. Factory Agent, dostupný cez Project View, automaticky analyzuje štruktúru projektu, logiku, premenné a artefakty kódu a vytvára prehľadnú, ľudsky čitateľnú dokumentáciu.
Táto schopnosť pomáha tímom zrýchliť zaškolenie, znížiť medzery v znalostiach a zlepšiť dlhodobú udržiavateľnosť – najmä v prostrediach, kde nepísané znalosti alebo staršie kódové základne sťažujú udržiavanie ručne písanej dokumentácie. Výstupy Factory Agent sa generujú na požiadanie, čím sa zabezpečuje, že dokumentácia zodpovedá najaktuálnejšej verzii projektu uloženej v SEW.
Okrem dokumentácie podporuje Factory Agent aj porovnávanie kódu s podporou AI pre rovnakú množinu podporovaných výrobcov. Táto funkcia, dostupná cez Compare Projects View, umožňuje používateľom porovnať dve verzie toho istého projektu a získať prehľadné, štruktúrované zhrnutie vykonaných zmien. Porovnávanie vo Factory Agent sa zameriava špecificky na zmeny medzi verziami v rámci projektu a poskytuje hlbší pohľad na úpravy, refaktoring alebo neúmyselné zásahy. Inžinierom to umožňuje rýchlo overiť zmeny, pochopiť, ako tieto zmeny ovplyvňujú funkčnú prevádzku zariadenia, skontrolovať prácu pred nasadením a udržiavať prehľad pripravený na audit o tom, ako sa projekt v čase vyvíja.
Matica kompatibility výrobcov a PLC jazykov pre Factory Agent
SEW-EURODRIVE poskytuje nástroj poháňaný umelou inteligenciou, ktorý generuje podrobnú dokumentáciu pre každý projekt na úrovni súborov. Tento nástroj identifikuje závislosti v rámci súboru a bezproblémovo ich integruje do dokumentácie.
Aktuálne sú podporovaní títo výrobcovia a tieto formáty súborov:
| Výrobca | 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 |
Ako generovať dokumentáciu kódu
Začnite tým, že v hlavnom zozname projektov vyberiete projekt, pre ktorý chcete vygenerovať dokumentáciu. Kliknutím na požadovaný projekt otvoríte jeho detailné zobrazenie a dostupné možnosti dokumentácie.
Výber podporovaných súborov
V Project Viewer vyberte ľubovoľný súbor, ktorý podporuje generovanie dokumentácie.
Spustenie generovania dokumentácie
- Vyberte požadovaný súbor v Project Viewer
- Kliknutím na tlačidlo „Explain“ spustíte proces generovania dokumentácie
- Zobrazí sa indikátor priebehu s aktuálnym stavom procesu generovania
Spracovanie na pozadí: Generovanie dokumentácie prebieha ako proces na pozadí, takže môžete stránku opustiť alebo zavrieť prehliadač bez prerušenia operácie. Neskôr sa môžete vrátiť a skontrolovať priebeh alebo zobraziť dokončenú dokumentáciu.
Poznámka: Na generovanie dokumentácie budú dostupné len súbory, ktoré spĺňajú kritériá podporovaných formátov. Úplný zoznam kompatibilných typov a formátov súborov nájdete v časti Prehľad.
Factory Agent pre porovnávanie kódu (funkcia pred vydaním)
Začnite tým, že v hlavnom zozname projektov vyberiete projekt, pre ktorý chcete porovnať rozdiely medzi verziami. Kliknutím na požadovaný projekt otvoríte jeho detailné zobrazenie a dostupné možnosti dokumentácie a vyberte 2 verzie na porovnanie. Následne vyberte „Compare Versions“, čím otvoríte nástroj na porovnanie verzií.
V zobrazení projektu vyberte prvok, ktorý vykazuje rozdiely. Takéto prvky sú spravidla modré (zmenené), zelené (pridané) alebo červené (odstránené) – biela znamená žiadnu zmenu. Keď sa zobrazí porovnávacie zobrazenie, vyberte „Explain“ v bloku, pre ktorý chcete vidieť vysvetlenie rozdielu. Vysvetlenie rozdielu sa zobrazí pod blokom.
Úrovne podrobnosti dokumentácie
V predvolenom nastavení systém generuje podrobnú dokumentáciu, ktorá poskytuje komplexnú analýzu s detailnými vysvetleniami a dôkladným pokrytím. Používatelia však môžu prepnúť na zhrnutú verziu, ak uprednostňujú stručnejší prehľad.
- Podrobná: Ponúka detailné vysvetlenia, komplexnú analýzu a dôkladné pokrytie (predvolené)
- Zhrnutá: Poskytuje základné informácie a kľúčové koncepty v skrátenej forme