📖 项目简介

DataAgent 是一个基于 Spring AI Alibaba Graph 打造的企业级智能数据分析 Agent。它超越了传统的 Text-to-SQL 工具，进化为一个能够执行 Python 深度分析、生成 多维度图表报告 的 AI 智能数据分析师。

系统采用高度可扩展的架构设计，全面兼容 OpenAI 接口规范的对话模型与 Embedding 模型，并支持灵活挂载任意向量数据库。无论是私有化部署还是接入主流大模型服务（如 Qwen, Deepseek），都能轻松适配，为企业提供灵活、可控的数据洞察服务。

同时，本项目原生支持 MCP (Model Context Protocol)，可作为 MCP 服务器无缝集成到 Claude Desktop 等支持 MCP 的生态工具中。

✨ 核心特性

🏗️ 项目结构

🚀 快速开始

详细的安装和配置指南请参考 📑 快速开始文档。

1. 准备环境

• JDK 17+
• MySQL 5.7+
• Node.js 16+

2. 启动服务

# 1. 导入数据库
mysql -u root -p < data-agent-management/src/main/resources/sql/schema.sql

# 2. 启动后端
cd data-agent-management
./mvnw spring-boot:run

# 3. 启动前端
cd data-agent-frontend
npm install && npm run dev

3. 访问系统

打开浏览器访问 http://localhost:3000，开始创建您的第一个数据智能体！

📚 文档导航

🤝 加入社区 & 贡献

• 钉钉交流群: 154405001431 ("DataAgent用户1群") 部分用户可能因为账号安全问题无法加入，条件允许的情况下可换账号申请。
• 贡献指南: 欢迎社区贡献！请查阅 开发者文档 了解如何提交 PR。

📄 许可证

本项目采用 Apache License 2.0 许可证。

Star历史

贡献者名单

DataAgent 快速上手指南

DataAgent 是一个基于 Spring AI Alibaba Graph 打造的企业级智能数据分析 Agent。它不仅能实现 Text-to-SQL，还能执行 Python 深度分析并生成可视化报告。

1. 环境准备

在开始之前，请确保您的开发环境满足以下要求：

• JDK: 17 或更高版本
• 数据库: MySQL 5.7 或更高版本
• 前端运行环境: Node.js 16 或更高版本
• 构建工具: Maven (项目内置了 mvnw，可直接使用)

2. 安装与启动

按照以下步骤快速部署本地开发环境：

第一步：导入数据库架构

将初始化的 SQL 脚本导入到您的 MySQL 数据库中：

mysql -u root -p < data-agent-management/src/main/resources/sql/schema.sql

第二步：启动后端服务

进入后端管理模块目录并启动 Spring Boot 应用：

cd data-agent-management
./mvnw spring-boot:run

第三步：启动前端界面

进入前端模块目录，安装依赖并启动开发服务器：

cd data-agent-frontend
npm install && npm run dev

提示：如果 npm install 速度较慢，可配置国内镜像源加速： npm config set registry https://registry.npmmirror.com

3. 基本使用

服务启动成功后，即可通过浏览器访问系统：

1. 打开浏览器，访问地址：http://localhost:3000
2. 在界面中创建您的第一个数据智能体。
3. 连接数据源后，您可以直接输入自然语言问题（例如：“查询上季度的销售趋势”），系统将自动执行 SQL 查询、进行 Python 数据分析并生成包含 ECharts 图表的智能报告。