Ga naar hoofdinhoud

Factory Agent - AI-gegenereerde codedocumentatie

Overzicht van de codebeschrijving door Factory Agent​

Factory Agent levert AI-gegenereerde codedocumentatie rechtstreeks binnen het SEW Platform, waardoor engineeringteams automatiseringsprojecten eenvoudiger kunnen begrijpen, onderhouden en oplossen. Via de Project View analyseert Factory Agent automatisch de projectstructuur, logica, variabelen en code-artefacten om heldere, leesbare documentatie te produceren.

Deze functionaliteit helpt teams om sneller in te werken, kennislacunes te verkleinen en de onderhoudbaarheid op lange termijn te verbeteren—vooral in omgevingen waar impliciete kennis of legacy-codebases handmatig geschreven documentatie lastig te onderhouden maken. De uitvoer van Factory Agent wordt op aanvraag gegenereerd, zodat de documentatie altijd de meest actuele versie van het in SEW opgeslagen project weerspiegelt.

Naast documentatie ondersteunt Factory Agent ook AI-ondersteunde codevergelijking (code differencing) voor dezelfde set ondersteunde leveranciers. Via de Compare Projects View kunnen gebruikers met deze functie twee versies van hetzelfde project vergelijken en een duidelijke, gestructureerde samenvatting krijgen van wat er is gewijzigd. De vergelijking van Factory Agent richt zich specifiek op wijzigingen tussen versies binnen een project en biedt daarmee dieper inzicht in aanpassingen, refactoring of onbedoelde bewerkingen. Zo kunnen engineers wijzigingen snel valideren, begrijpen hoe die wijzigingen de functionele werking van het apparaat beïnvloeden, werk beoordelen vóór implementaties en een auditklaar inzicht behouden in hoe een project zich in de loop van de tijd ontwikkelt.

Compatibiliteitsmatrix Factory Agent leveranciers & PLC-talen​

SEW-EURODRIVE biedt een AI-gestuurde tool die op bestandsniveau gedetailleerde documentatie voor elk project genereert. Deze tool identificeert afhankelijkheden binnen het bestand en integreert deze naadloos in de documentatie.

Momenteel worden deze leveranciers en bestandsformaten ondersteund:

VendorStructured Text / SCLLadder LogicFBD
Beckhofftruetruefalse
BoschRexrothtruetruefalse
CODESYStruetruetrue
Rockwell Automationtruetruefalse
SEW MOVIRUN opentruetruefalse
Siemens TIA Portaltruetruefalse
WAGOtruetruefalse

Codedocumentatie genereren​

Begin met het selecteren van het project waarvoor u documentatie wilt genereren uit de hoofdprojectlijst. Klik op het gewenste project om de detailweergave en de beschikbare documentatieopties te openen.

Ondersteunde bestanden selecteren

Kies in de Project Viewer een bestand dat documentatiegeneratie ondersteunt.

Documentatiegeneratie starten

  1. Selecteer het gewenste bestand in de Project Viewer
  2. Klik op de knop "Explain" om het proces voor documentatiegeneratie te starten
  3. Er verschijnt een voortgangsbalk die de huidige status van het generatieproces weergeeft

Achtergrondverwerking: De documentatiegeneratie verloopt als achtergrondproces, zodat u de pagina kunt verlaten of uw browser kunt sluiten zonder de bewerking te onderbreken. U kunt later terugkeren om de voortgang te bekijken of de voltooide documentatie te raadplegen.

info

Note: Alleen bestanden die aan de ondersteunde formaatcriteria voldoen, zijn beschikbaar voor documentatiegeneratie. Raadpleeg het gedeelte Overzicht voor een volledige lijst met compatibele bestandstypen en -formaten.

Factory Agent voor codevergelijking (pre-release-functie)​

Begin met het selecteren van het project waarvan u de verschillen tussen projectversies wilt vergelijken uit de hoofdprojectlijst. Klik op het gewenste project om de detailweergave en de beschikbare documentatieopties te openen en selecteer 2 versies om te vergelijken. Selecteer vervolgens "Compare Versions" om de tool voor versievergelijking te openen.

Selecteer in de projectweergave een element dat verschillen vertoont. Doorgaans worden die elementen weergegeven in blauw (gewijzigd), groen (toegevoegd) of rood (verwijderd) - wit betekent geen wijziging. Wanneer de vergelijkingsweergave wordt getoond, selecteert u "Explain" in het blok waarvoor u een uitleg van het verschil wilt zien. De uitleg van het verschil wordt onder het blok weergegeven.

Detailniveaus van documentatie​

Standaard genereert het systeem uitgebreide documentatie die een volledige analyse biedt met gedetailleerde toelichtingen en diepgaande dekking. Gebruikers kunnen echter overschakelen naar de samengevatte versie als zij de voorkeur geven aan een beknopter overzicht.

  • Uitgebreid: Biedt gedetailleerde toelichtingen, een volledige analyse en diepgaande dekking (standaard)
  • Samengevat: Biedt essentiële informatie en kernbegrippen in een compacte vorm