Factory Agent - AI 생성 코드 문서화
Factory Agent 코드 설명 개요
Factory Agent는 SDA Platform 내에서 직접 AI 생성 코드 문서를 제공하여, 엔지니어링 팀이 자동화 프로젝트를 더 쉽게 이해하고 유지보수하며 문제를 해결할 수 있도록 지원합니다. Project View를 통해 접근할 수 있는 Factory Agent는 프로젝트 구조, 로직, 변수 및 코드 아티팩트를 자동으로 분석하여 명확하고 사람이 읽기 쉬운 문서를 생성합니다.
이 기능은 팀이 온보딩 속도를 높이고, 지식 격차를 줄이며, 장기적인 유지보수성을 개선하는 데 도움이 됩니다. 특히 암묵지나 레거시 코드베이스로 인해 수기 문서를 유지하기 어려운 환경에서 유용합니다. Factory Agent 출력물은 필요 시 온디맨드로 생성되므로, 문서는 SDA에 저장된 프로젝트의 최신 버전을 반영합니다.
문서화 외에도 Factory Agent는 동일한 지원 벤더 집합에 대해 AI 지원 코드 차이 비교(code differencing) 도 지원합니다. Compare Projects View를 통해 접근할 수 있는 이 기능을 사용하면 동일한 프로젝트 의 두 버전을 비교하고 변경 사항에 대한 명확하고 구조화된 요약을 받을 수 있습니다. Factory Agent의 차이 비교는 프로젝트 내 버전 간 변경 사항에 특히 초점을 맞추어, 수정, 리팩터링 또는 의도하지 않은 편집에 대한 심층적인 통찰을 제공합니다. 이를 통해 엔지니어는 변경 사항을 신속하게 검증하고, 해당 변경이 장치의 기능적 동작에 미치는 영향을 이해하며, 배포 전에 작업을 검토하고, 프로젝트가 시간이 지남에 따라 어떻게 발전하는지에 대한 감사 대응이 가능한 가시성을 유지할 수 있습니다.
Factory Agent 벤더 및 PLC 언어 호환성 매트릭스
Software Defined Automation은 파일 수준에서 각 프로젝트에 대한 상세 문서를 생성하는 AI 기반 도구를 제공합니다. 이 도구는 파일 내의 종속성을 식별하고 이를 문서에 매끄럽게 통합합니다.
현재 다음 벤더 및 파일 형식이 지원됩니다:
| 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 |
코드 문서를 생성하는 방법
먼저 메인 프로젝트 목록에서 문서를 생성하려는 프로젝트를 선택합니다. 원하는 프로젝트를 클릭하여 상세 보기와 사용 가능한 문서화 옵션에 접근합니다.
지원 파일 선택
Project Viewer에서 문서 생성을 지원하는 파일을 선택합니다.
문서 생성 시작
- Project Viewer에서 원하는 파일을 선택합니다
- "Explain" 버튼을 클릭하여 문서 생성 프로세스를 시작합니다
- 생성 프로세스의 현재 상태를 표시하는 진행률 표시줄이 나타납니다
백그라운드 처리: 문서 생성은 백그라운드 프로세스로 실행되므로, 작업을 중단하지 않고 페이지를 벗어나거나 브라우저를 닫을 수 있습니다. 나중에 다시 돌아와 진행 상황을 확인하거나 완료된 문서를 볼 수 있습니다.
Note: 지원되는 형식 기준을 충족하는 파일만 문서 생성에 사용할 수 있습니다. 호환되는 파일 유형 및 형식의 전체 목록은 개요 섹션을 참조하십시오.
코드 차이 비교를 위한 Factory Agent (사전 출시 기능)
먼저 메인 프로젝트 목록에서 프로젝트 버전 간 차이를 비교하려는 프로젝트를 선택합니다. 원하는 프로젝트를 클릭하여 상세 보기와 사용 가능한 문서화 옵션에 접근한 후 비교할 2개의 버전을 선택합니다. 여기에서 "Compare Versions" 를 선택하여 버전 비교 도구를 엽니다.
프로젝트 보기에서 차이가 표시된 요소를 선택합니다. 일반적으로 해당 요소는 파란색(수정됨), 초록색(추가됨) 또는 빨간색(제거됨)으로 표시되며, 흰색은 변경 없음을 의미합니다. 비교 보기가 표시되면 차이 설명을 보고자 하는 블록에서 "Explain"을 선택합니다. 차이 설명은 해당 블록 아래에 표시됩니다.
문서 상세 수준
기본적으로 시스템은 상세한 설명과 심층적인 내용을 포함한 포괄적 분석을 제공하는 상세 문서(verbose documentation) 를 생성합니다. 다만 사용자가 더 간결한 개요를 선호하는 경우 요약 버전 으로 전환할 수 있습니다.
- Verbose: 상세한 설명, 포괄적인 분석 및 심층적인 내용을 제공합니다 (기본값)
- Summarized: 핵심 정보와 주요 개념을 압축된 형식으로 제공합니다