Administrator
发布于 2026-08-14 / 22 阅读
0
0

DataAgent - Spring AI Alibaba DataAgent

DataAgent链接: https://github.com/spring-ai-alibaba/DataAgent

技术栈:

  • Spring AI

  • PostgreSQL

  • VUE3

  • TypeScript

  • A2A + SSE

DataAgent 是 Spring AI Alibaba 生态下的一个企业级智能数据分析 Agent 项目。它基于 Spring AI Alibaba Graph 构建,定位上超越了传统的 Text-to-SQL 工具,进化成一个能执行 Python 深度分析、生成多维度图表报告的 AI 智能数据分析师。

项目全面兼容 OpenAI 接口规范的对话模型与 Embedding 模型,支持灵活挂载任意向量数据库,可接入 Qwen、Deepseek 等主流大模型服务,也支持私有化部署。同时原生支持 MCP (Model Context Protocol),可作为 MCP 服务器集成到 Claude Desktop 等生态工具中。


核心特性

特性

说明

智能数据分析

基于 StateGraph 的 Text-to-SQL 转换,支持复杂多表查询和多轮对话意图理解

Python 深度分析

基于 Spring AI Alibaba Sandbox 在任务级容器中执行代码,支持 PEP 723 动态依赖、资源限制、失败重试与自动清理

智能报告生成

分析结果自动汇总为包含 ECharts 图表的 HTML/Markdown 报告

人工反馈机制

独创的 Human-in-the-loop 机制,支持用户在计划生成阶段进行干预和调整

RAG 检索增强

集成向量数据库,支持对业务元数据、术语库的语义检索,提升 SQL 生成准确率

多模型调度

内置模型注册表,支持运行时动态切换不同的 LLM 和 Embedding 模型

MCP 服务器

遵循 MCP 协议,支持作为 Tool Server 对外提供 NL2SQL 和智能体管理能力

API Key 管理

完善的 API Key 生命周期管理,支持细粒度的权限控制


技术架构

DataAgent 采用分层架构设计,主要包含以下层次:

  • 客户端层:包含 Nuxt 前端 UI、管理控制台和 MCP 客户端

  • 接入层:提供 REST API 和 SSE 流式接口

  • 核心服务层 (Spring Boot):包含 Graph 工作流引擎、多轮对话上下文管理、模型注册表、向量检索服务、Python 代码执行服务、MCP 服务器等

  • 数据存储层:业务数据库、管理数据库、向量数据库、知识文件

  • LLM 提供层:对话模型和 Embedding 模型

  • Python 沙盒运行时:基于 Docker 的任务级容器执行环境

工作流核心节点包括:意图识别 → 证据召回 → 计划生成 → SQL 生成 / Python 代码生成 → Python 执行 → 结果分析 → 报告生成。


评论