Factory Agent - Documentación de código generada por IA
Descripción general de la descripción de código de Factory Agent
Factory Agent proporciona documentación de código generada por IA directamente dentro de la SEW Platform, lo que facilita a los equipos de ingeniería comprender, mantener y solucionar problemas de los proyectos de automatización. Accesible a través de la Vista de proyecto, Factory Agent analiza automáticamente la estructura del proyecto, la lógica, las variables y los artefactos de código para generar documentación clara y legible para las personas.
Esta capacidad ayuda a los equipos a acelerar la incorporación, reducir las brechas de conocimiento y mejorar la mantenibilidad a largo plazo, especialmente en entornos donde el conocimiento tribal o las bases de código heredadas dificultan el mantenimiento de la documentación escrita a mano. Los resultados de Factory Agent se generan bajo demanda, lo que garantiza que la documentación refleje la versión más actual del proyecto almacenada en SEW.
Además de la documentación, Factory Agent también admite la comparación de código asistida por IA para el mismo conjunto de fabricantes compatibles. Accesible a través de la Vista de comparación de proyectos, esta función permite a los usuarios comparar dos versiones del mismo proyecto y recibir un resumen claro y estructurado de lo que cambió. La comparación de Factory Agent se centra específicamente en los cambios entre versiones dentro de un proyecto, proporcionando una visión más profunda de las modificaciones, la refactorización o las ediciones no intencionadas. Esto permite a los ingenieros validar rápidamente los cambios, comprender cómo dichos cambios afectan al funcionamiento del dispositivo, revisar el trabajo antes de las implementaciones y mantener una visibilidad lista para auditorías sobre cómo evoluciona un proyecto a lo largo del tiempo.
Matriz de compatibilidad de fabricantes y lenguajes PLC de Factory Agent
SEW-EURODRIVE proporciona una herramienta impulsada por IA que genera documentación detallada para cada proyecto a nivel de archivo. Esta herramienta identifica las dependencias dentro del archivo y las integra en la documentación de forma fluida.
Actualmente, se admiten estos fabricantes y formatos de archivo:
| Fabricante | Texto estructurado / SCL | Lógica de escalera | 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 |
Cómo generar documentación de código
Comience seleccionando en la lista principal de proyectos aquel para el que desea generar documentación. Haga clic en el proyecto deseado para acceder a su vista detallada y a las opciones de documentación disponibles.
Selección de archivos compatibles
En el Visor de proyectos, elija cualquier archivo que admita la generación de documentación.
Inicio de la generación de documentación
- Seleccione el archivo deseado en el Visor de proyectos
- Haga clic en el botón "Explain" para iniciar el proceso de generación de documentación
- Aparecerá una barra de progreso que muestra el estado actual del proceso de generación
Procesamiento en segundo plano: la generación de documentación se ejecuta como un proceso en segundo plano, lo que le permite salir de la página o cerrar el navegador sin interrumpir la operación. Puede volver más tarde para consultar el progreso o ver la documentación completada.
Note: Solo los archivos que cumplan los criterios de formato compatibles estarán disponibles para la generación de documentación. Consulte la sección Descripción general para ver una lista completa de los tipos y formatos de archivo compatibles.
Factory Agent para comparación de código (función en prelanzamiento)
Comience seleccionando en la lista principal de proyectos aquel cuyas diferencias entre versiones desea comparar. Haga clic en el proyecto deseado para acceder a su vista detallada y a las opciones de documentación disponibles, y seleccione 2 versiones para comparar. Desde aquí, seleccione "Compare Versions" para abrir la herramienta de comparación de versiones.
Desde la vista del proyecto, seleccione un elemento que muestre diferencias. Normalmente, esos elementos aparecerán en azul (modificado), verde (añadido) o rojo (eliminado); el blanco representa que no hay cambios. Cuando se muestre la vista de comparación, seleccione "Explain" en el bloque del que desee ver una explicación de las diferencias. La explicación de las diferencias se mostrará debajo del bloque.
Niveles de detalle de la documentación
De forma predeterminada, el sistema genera documentación detallada que proporciona un análisis exhaustivo con explicaciones detalladas y una cobertura en profundidad. No obstante, los usuarios pueden cambiar a la versión resumida si prefieren una visión general más concisa.
- Detallada: ofrece explicaciones detalladas, análisis exhaustivo y cobertura en profundidad (predeterminada)
- Resumida: proporciona la información esencial y los conceptos clave en un formato condensado