🤖 AI 엑셀 분석 및 인사이트 도출 시스템

마케팅 팀원을 위해 엑셀 데이터를 자동으로 분석하고, 숨겨진 인사이트를 발견해주는 AI 시스템입니다.

📋 프로젝트 개요

이 시스템은 LangChain과 LangGraph를 활용한 멀티 에이전트 구조로, 복잡한 데이터 분석 작업을 두 단계로 나누어 처리합니다:

1. 데이터 분석 에이전트: Pandas DataFrame을 활용하여 사용자의 질문에 대한 데이터 분석 수행
2. 인사이트 요약 에이전트: 분석 결과를 비전문가도 이해하기 쉬운 비즈니스 보고서로 변환

✨ 주요 기능

• 📊 엑셀 파일 업로드 및 자동 분석: .xlsx 파일을 업로드하여 즉시 분석 시작
• 🤖 AI 기반 질문 응답: 자연어로 질문하면 데이터에서 답을 찾아 제공
• 📈 시각화 지원: 필요시 matplotlib/seaborn을 활용한 그래프 자동 생성
• 💼 비즈니스 인사이트 보고서: 마케팅 팀원을 위한 전문적인 분석 보고서 생성
• 💬 실시간 채팅: 분석 결과에 대한 추가 질문 및 대화 가능

🛠️ 기술 스택

• Frontend: Streamlit
• AI/ML: LangChain, LangGraph, OpenAI GPT-4-turbo
• 데이터 처리: Pandas
• 시각화: Matplotlib, Seaborn

🚀 설치 및 실행

1. uv 설치 (아직 설치하지 않은 경우)

# Windows (PowerShell)
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

2. 환경 변수 설정

프로젝트 루트 디렉토리에 .env 파일을 생성하고 OpenAI API 키를 설정하세요:

# .env.example 파일을 복사하여 .env 파일 생성
cp .env.example .env

.env 파일을 열어서 실제 API 키로 수정하세요:

OPENAI_API_KEY=your_actual_openai_api_key_here
OPENAI_MODEL=gpt-4-turbo

3. 프로젝트 의존성 설치

uv sync

4. 애플리케이션 실행

uv run streamlit run main.py

5. 사용

1. 브라우저에서 애플리케이션이 열리면 사이드바에서 API 키 설정 상태를 확인하세요
2. 분석할 엑셀 파일(.xlsx)을 업로드하세요
3. 데이터에 대한 질문을 입력하고 "분석 시작" 버튼을 클릭하세요

📖 사용 방법

기본 분석 과정

1. 파일 업로드: 분석하고 싶은 엑셀 파일을 업로드
2. 질문 입력: 예시) "캠페인 별 광고 수익률(ROAS)을 계산하고 가장 높은 캠페인을 알려줘"
3. 분석 실행: "분석 시작" 버튼 클릭
4. 결과 확인: AI가 생성한 분석 보고서 확인

보고서 구성

생성되는 보고서는 다음 두 섹션으로 구성됩니다:

• 📊 분석 과정: 데이터 분석가가 수행한 단계별 분석 과정
• 💡 핵심 결과 및 인사이트: 비즈니스적 관점에서의 결과 해석 및 액션 아이템 제안

추가 질문

분석 보고서 생성 후, 채팅창을 통해 추가적인 질문을 할 수 있습니다. AI는 이전 분석 결과를 기억하며 연속적인 대화를 지원합니다.

🏗️ 시스템 아키텍처

LangGraph 워크플로우

사용자 질문 → 데이터 분석 에이전트 → 인사이트 요약 에이전트 → 최종 보고서

상태 관리

• dataframe: 업로드된 pandas DataFrame
• question: 사용자의 원본 질문
• analysis_result: 데이터 분석 에이전트의 실행 결과
• summary: 최종 인사이트 보고서
• chat_history: 사용자와 AI 간의 대화 기록

💻 개발자 정보

이 프로젝트는 마케팅 데이터 분석 업무를 효율화하기 위해 개발된 AI 기반 분석 도구입니다. 복잡한 데이터 분석 과정을 자동화하여 비전문가도 쉽게 데이터 기반 인사이트를 얻을 수 있도록 설계되었습니다.

📄 라이센스

이 프로젝트는 오픈소스 프로젝트입니다.

⚠️ 주의사항

• API 키 보안: .env 파일은 절대 Git에 커밋하지 마세요. 이미 .gitignore에 포함되어 있습니다.
• API 키 필수: 이 시스템을 사용하려면 유효한 OpenAI API 키가 필요합니다.
• 폴백 기능: .env 파일에 API 키가 없는 경우, 애플리케이션에서 임시로 키를 입력할 수 있습니다.