Data Analysis

Data Analysis — 데이터 분석 풀 파이프라인

데이터의 탐색→정제→분석→시각화→보고서를 에이전트 팀이 협업하여 한 번에 수행한다.

실행 모드

에이전트 팀 — 5명이 SendMessage로 직접 통신하며 교차 검증한다.

에이전트 구성

워크플로우

Phase 1: 준비 (오케스트레이터 직접 수행)

1. 사용자 입력에서 추출한다:
   • 데이터 소스: 파일 경로, 포맷(CSV/Excel/JSON/DB), 크기
   • 분석 목적: 비즈니스 질문, 가설, 기대 결과
   • 제약 조건 (선택): 시간, 특정 분석 기법, 보고 대상
   • 도메인 정보 (선택): 업종, 변수 의미, 비즈니스 맥락
2. _workspace/ 디렉토리와 _workspace/scripts/ 하위 디렉토리를 생성한다
3. 입력을 정리하여 _workspace/00_input.md에 저장한다
4. 데이터 파일을 _workspace/data/에 복사한다
5. 기존 파일이 있으면 _workspace/에 복사하고 해당 Phase를 건너뛴다
6. 요청 범위에 따라 실행 모드를 결정한다

Phase 2: 팀 구성 및 실행

작업 3a(분석)와 3b(EDA 시각화)는 병렬 실행한다.

팀원 간 소통 흐름:

• explorer 완료 → cleaner에게 정제 권고 전달, analyst에게 분석 제안 전달, visualizer에게 분포 시각화 대상 전달
• cleaner 완료 → analyst에게 정제 데이터 위치와 변환 이력 전달
• analyst 완료 → visualizer에게 분석 결과 시각화 요청, reporter에게 인사이트 전달
• visualizer 완료 → reporter에게 시각화 목록 전달
• reporter는 모든 산출물을 교차 검증. 불일치 발견 시 해당 에이전트에 수정 요청 (최대 2회)

Phase 3: 통합 및 최종 산출물

1. _workspace/ 내 모든 파일을 확인한다
2. reporter의 보고서에서 필수 수정이 모두 반영되었는지 확인한다
3. 최종 요약을 사용자에게 보고한다:
   • 탐색 보고서 — 01_exploration_report.md
   • 정제 로그 — 02_cleaning_log.md
   • 분석 결과 — 03_analysis_results.md
   • 시각화 — 04_visualizations.md
   • 최종 보고서 — 05_final_report.md
   • 재현 스크립트 — scripts/ 디렉토리

작업 규모별 모드

기존 파일 활용: 이미 정제된 데이터가 있으면 explorer와 cleaner를 건너뛴다. 분석 결과가 있으면 analyst를 건너뛰고 시각화와 보고서만 진행한다.

데이터 전달 프로토콜

파일명 컨벤션: {순번}_{산출물}.{확장자}

에러 핸들링

테스트 시나리오

정상 흐름

프롬프트: "이 매출 CSV 파일을 분석해서 매출 하락 원인을 찾아줘" 기대 결과:

• EDA: 변수 프로파일, 결측/이상치 분석, 매출 관련 변수 식별
• 정제: 결측치 처리, 이상치 캡핑, 타입 변환 로그
• 분석: 시계열 분해, 구간별 비교(t-test/ANOVA), 상관분석
• 시각화: 매출 추이 라인차트, 요인별 비교 막대그래프, 상관 히트맵
• 보고서: 하락 원인 Top 3 + 권고 액션 + 경영진 요약

기존 파일 활용 흐름

프롬프트: "이미 정제된 데이터가 있어. 통계 분석이랑 시각화만 해줘" + 정제 데이터 파일 첨부 기대 결과:

• 기존 데이터를 _workspace/data/에 복사
• 분석 모드: explorer와 cleaner는 건너뛰고 analyst + visualizer + reporter 투입
• 정제 이력은 사용자 제공 정보 기반으로 기록

에러 흐름

프롬프트: "이 엑셀 파일 분석해줘" (결측 50% 이상 변수 다수, 이상치 대량) 기대 결과:

• explorer가 데이터 품질 문제를 상세히 보고
• cleaner가 변수별 처리 전략을 근거와 함께 제시, 행 30% 이상 감소 시 경고
• analyst가 데이터 충분성 한계를 명시하고 검정력 분석 수행
• reporter가 한계 섹션에 데이터 품질 이슈를 정직하게 기록

에이전트별 확장 스킬