项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
技术标签
使用教程
—
环境要求
- JDK 环境(项目提供 ./mvnw Maven Wrapper,可直接运行后端)
- Node.js 与 pnpm(用于启动 data-agent-frontend-nuxt 前端)
- 可用的大模型服务:兼容 OpenAI 接口规范的对话模型与 Embedding 模型(如 Qwen、Deepseek)
- Spring AI Alibaba 1.1.2.2 生态依赖(由 Maven 自动拉取)
安装与启动步骤
-
1克隆项目代码
把 DataAgent 仓库拉到本地,README 未给出克隆命令,此处使用 GitHub 地址的标准写法。
git clone https://github.com/spring-ai-alibaba/DataAgent.git cd DataAgent -
2阅读快速开始文档
README 明确要求详细的安装和配置指南参考 docs/QUICK_START.md,先按该文档完成模型与数据源配置。
-
3启动后端服务
在项目根目录用 Maven Wrapper 启动 data-agent-management 模块,需保持该终端不关闭。
./mvnw -pl data-agent-management spring-boot:run -
4安装前端依赖
另开一个终端进入前端目录,使用 pnpm 安装 Nuxt 前端依赖。
cd data-agent-frontend-nuxt pnpm install -
5启动前端服务
依赖安装完成后启动前端开发服务器,浏览器按输出地址访问即可对话取数。
pnpm dev
如何确认成功
后端终端出现 Spring Boot 启动完成日志,前端 pnpm dev 输出本地访问地址,浏览器打开该地址能进入 DataAgent 界面。
常见问题
Q:为什么没有第 1 步的安装命令?
A:README 的快速开始只节选了启动服务部分,并指明完整安装配置见 docs/QUICK_START.md,请以该文档为准补齐模型与数据源配置。
Q:前端用什么包管理器?
A:README 明确使用 pnpm,需先进入 data-agent-frontend-nuxt 目录,执行 pnpm install 后再 pnpm dev。
Q:可以接哪些大模型?
A:项目全面兼容 OpenAI 接口规范的对话与 Embedding 模型,支持私有化部署或接入 Qwen、Deepseek 等主流大模型服务。
Q:支持 MCP 吗?
A:支持。项目原生支持 MCP(Model Context Protocol),可作为 MCP 服务器无缝集成到 Claude Desktop 等生态工具中。
Q:有 Docker 部署方式吗?
A:README 节选中未提供 Docker 相关命令,不要自行假设镜像名与端口,请查阅 docs/QUICK_START.md 确认。
注意事项
- 后端与前端必须在两个独立终端分别启动,后端进程需保持运行。
- 完整安装与配置以 docs/QUICK_START.md 为准,本教程仅覆盖 README 中出现的启动命令。
- README 未给出默认端口、配置项名称与 API Key 写法,请勿凭猜测填写。
- Python 深度分析依赖 Spring AI Alibaba Sandbox 的任务级容器执行环境。
核心亮点
- 基于 Spring AI Alibaba,Java 团队可沿用现有 Spring Boot 工程和依赖注入体系,集成成本低
- 提供智能体工具调用与数据访问的封装,能较快搭出自然语言取数、分析问答的原型
- 背靠 Spring AI Alibaba 生态,模型接入、函数注册等环节有统一抽象,便于替换模型或扩展数据源
不足之处
- 项目仍处成长阶段,API 和模块结构可能随版本调整,生产使用需关注兼容性
- 文档与示例以中文社区为主,英文资料和第三方教程相对有限
适用场景
- 企业内部数据平台增加对话式取数入口,业务人员用自然语言查指标
- Java 微服务中嵌入智能体,自动调用数据库工具生成分析结论
- 教学或原型验证场景,快速演示 Spring AI 工具调用与 Agent 编排
替代项目
LangChain4j、Spring AI
上一篇:AgentTeams
下一篇:agent
同类项目推荐
xinchao-dynamic-mind
开源
给 AI 装上疲惫和欲望,让交互更真实
独立、可自托管的 AI 动态心智状态引擎:驱动力、念头池、疲惫、睡眠与意图。
goutoujunshi
开源
先哄情绪再出招,恋爱难题给可执行方案
一个先接住情绪、再分析关系并给出可执行策略的 Codex 恋爱军师,内置心理、法律、社会、人···
geo-sleuth
开源
给 AI 装上地理侦探技能,一张照片顺藤摸瓜找到拍摄地
An agent skill that finds where a photo was taken — OpenStreetMap geometry, elevati···
deepseek-harness
开源
把 AI 能力拆成乐高积木,拼出你的专属智能体。
DeepSeek Harness: Everything is a Plugin.
