SnapAgent 그래프 에디터 사용 가이드

1. 개요 (Overview)

SnapAgent 그래프 에디터(SnapCodex Graph-Cost Engine)는 건축 도면(CAD/SKP) 데이터로부터 기하정보를 추출하고, 마감재를 자동 매핑하여 공사비를 산출하는 전 과정을 시각적으로 연결하고 제어하는 워크플로우 툴입니다.

각 노드는 고유한 AI 에이전트(Tony, Roony, Jessi 등)의 작업을 나타내며, 노드 간 연결을 통해 데이터의 흐름을 설계할 수 있습니다.

2. 노드 조작 방법 (Node Operation)

• 노드 캔버스 이동: 빈 캔버스를 클릭하고 드래그하여 패닝(Panning)합니다. 마우스 휠로 줌인/줌아웃이 가능합니다.
• 노드 연결: 한 노드의 핸들(출력)을 클릭하고 다른 노드의 핸들(입력)로 드래그하여 연결합니다.
• 노드 실행: 노드를 선택하면 표시되는 하단 패널(Bottom Panel)에서 '노드 실행(Execute Node)' 버튼을 눌러 작업을 시작합니다.

3. 실제 NAS 연동 (NAS Data Integration)

강화된 실무 환경을 위해 좌측 '사내 NAS 파일' 탭은 목업 데이터가 아닌 Poby 서버의 실제 NAS 파일 시스템(`grid.snapcodex.com/api/webdav`)과 연동됩니다.

• 프로젝트별 최신 DWG 도면 파일 및 내역서 CSV 파일을 실시간으로 확인하고 Input 노드의 데이터소스로 지정할 수 있습니다.

4. PM 승인 프로세스 (Human-in-the-loop)

각 노드의 실행 결과(예: 실 경계 추출, 자재 단가 매핑)는 즉각 확정되지 않습니다. 에이전트 실행 완료 후 결과값(Data Map)은 에이전트 대시보드(Agent Dashboard)의 [PM 승인 대기] 목록으로 전송되며, 담당 PM의 검토 및 승인(isApproved=true) 후 다음 노드로 데이터가 흘러가는 안전장치가 마련되어 있습니다.