TL;DR

DataAgent는 Spring AI Alibaba Graph와 Spring Boot를 기반으로 Text-to-SQL, Python 후처리, 보고서 생성을 하나의 데이터 분석 흐름으로 묶은 기업용 Agent입니다. REST API와 SSE Stream, MCP Server를 통해 웹 UI와 외부 MCP 클라이언트를 연결하고 StateGraph가 SQL 생성부터 실행 계획 조정까지 관리합니다. Python 코드는 작업별 컨테이너에서 자원 제한과 재시도, 정리를 거치며 결과는 ECharts가 포함된 HTML 또는 Markdown 보고서로 변환됩니다. Java와 Spring 생태계에서 사내 데이터 분석 서비스를 구축하면서 OpenAI 호환 모델, Vector Store, MCP 연동이 필요한 경우 검토할 만하지만 MySQL, Node.js, pnpm, Docker를 함께 운영해야 합니다.

핵심 포인트

• Spring AI Alibaba Graph의 StateGraph가 자연어 요청을 Text-to-SQL 작업으로 전환하고 복잡한 다중 테이블 질의와 다중 턴 의도를 처리합니다. 계획 생성 단계에는 Human-in-the-loop를 넣어 사용자가 실행 전 흐름을 조정할 수 있습니다. Java와 Spring Boot 기반의 기업용 데이터 분석 백엔드를 구축하려는 팀에 맞는 구조입니다.
• 생성된 Python 코드는 작업별 컨테이너에서 실행되며 PEP 723 동적 의존성, 자원 제한, 실패 재시도, 자동 정리를 적용합니다. SQL 결과를 Python 후속 처리로 넘겨 ECharts 기반 HTML 또는 Markdown 보고서로 이어집니다. Docker가 필요한 실행 구조이므로 Python 단계를 사용하려면 컨테이너 운영 환경을 함께 준비해야 합니다.
• OpenAI 인터페이스 규격의 Chat Model과 Embedding Model을 연결하고 런타임 모델 등록표로 모델을 전환할 수 있습니다. 업무 메타데이터와 용어집은 Vector Store에서 검색해 SQL 생성에 보강 정보로 주입합니다. MCP Server로 동작해 Claude Desktop 같은 MCP 생태계에 NL2SQL과 Agent 관리 기능을 연결할 수 있습니다.

이미지 분석