Phoenix项目基于 Spring AI Alibaba 2.0 打造的企业级 Agent 平台,专注数据智能分析场景。平台内置多 Agent 协作机制,支持自然语言驱动的 NL2SQL 数据查询、多源异构数据汇总及 BI 报表自动生成,实现从数据探索、异常检测到洞察输出的全链路自动化。
Phoenix — 企业级智能体管理平台
这是一个基于 Spring AI Alibaba 2.0.0-M1.1 Graph 的企业级 AI Agent 管理与分析引擎,主要特性包括:
NL2SQL 智能报表:将自然语言转换为可执行的SQL查询,生成智能报表。
Python 深度分析:内置Python执行器,支持统计分析、机器学习预测,并生成ECharts图表报告。
自定义智能体:支持React Agent和Workflow Graph两种开发范式,具备会话管理、长期记忆等能力。
MCP 服务器:支持Model Context Protocol,可接入Claude Desktop等工具。
RAG 增强:集成检索增强生成技术,提升回答准确性和相关性。
Vben5 管理后台:现代化管理界面,用于管理智能体、数据源、模型等。
每一个关键词都精准踩中我的需求。

📖 项目简介
Phoenix 是一个基于 Spring AI Alibaba Graph 打造的企业级智能体(AI Agent)管理与数据分析平台。平台分为两大核心模块:
phoenix-data(智能报表引擎):以 StateGraph 状态机驱动,将自然语言转换为可执行的 SQL 与 Python 分析流程,超越传统 Text-to-SQL 工具,进化为具备多轮对话、意图识别、知识增强、人工反馈的全链路 AI 数据分析师。
phoenix-agent(自定义智能体框架):提供 React Agent、Workflow Graph、会话管理、长期记忆、用户画像、MCP 工具等完整的智能体开发能力,支持快速构建和发布企业级 AI 智能体。
系统采用 Vben 5 现代前端框架,实现前台(数据分析师交互)与后台(智能体管理、数据源配置、用户权限)的统一管理,提供开箱即用的企业级管理界面。
技术上,系统采用高度可扩展的多模块架构设计,全面兼容 OpenAI 接口规范的对话模型与 Embedding 模型,支持灵活挂载多种向量数据库,并提供 MySQL、PostgreSQL、Oracle、SQL Server、H2、Hive、达梦等主流数据库的即开即用支持。同时原生支持 MCP 协议,可无缝集成 Claude Desktop 等 MCP 生态工具。
✨ 核心特性

部署居然这么简单
最怕的就是开源项目部署起来要折腾半天,Phoenix 这方面做得相当到位。
环境只需要 JDK 21+、Maven、PostgreSQL(带 pgvector)、Redis,然后几条命令就搞定:
git clone https://gitee.com/lwj/phoenix.git
cd phoenix
psql -U your\_user -d your\_db \< sql/all\_data.sql
mvn clean install -Dspring-javaformat.skip=true
mvn spring-boot:run -pl phoenix-admin/phoenix-admin-manager
配置也很简洁,几个环境变量就搞定,没有任何花里胡哨的 YAML 文件。对于我这种“能用就行”的人来说,简直不要太友好。
模块架构清晰得感人
Phoenix 的模块划分非常专业:
phoenix/
├── phoenix-parent \# BOM 依赖管理
├── phoenix-data \# 智能报表引擎
├── phoenix-agent \# 自定义智能体框架
├── phoenix-admin \# 统一部署入口(端口 8066)
├── phoenix-privilege \# 权限认证
├── phoenix-platform \# 平台管理(租户、组织)
├── phoenix-common \# 公共模块
├── phoenix-rag \# 检索增强生成
├── phoenix-kg \# 知识图谱
└── phoenix-flink \# Flink 大数据集成复制
每个模块都是标准的 api / core / rest 三层架构,想拆想合都很灵活。如果公司后续要做微服务化,这个架构底子也能直接对接。
phoenix/
├── phoenix-parent # BOM 依赖管理与插件管理
│
├── phoenix-data # 智能报表引擎 — 入口、Graph 工作流、NL2SQL
│ ├── phoenix-data-api
│ ├── phoenix-data-core
│ └── phoenix-data-rest
│
├── phoenix-agent # 自定义智能体框架 — React Agent、会话、记忆、工作流
│ ├── phoenix-agent-api # 接口定义、DTO、配置属性
│ ├── phoenix-agent-core # AgentManager、ReactAgent、Workflow、记忆、工具
│ └── phoenix-agent-rest # REST & SSE 端点
│
├── phoenix-admin # 统一部署入口(端口 8066)
│ ├── phoenix-admin-api
│ ├── phoenix-admin-core
│ ├── phoenix-admin-manager # @SpringBootApplication,打包所有模块
│ └── phoenix-admin-rest
│
├── phoenix-privilege # 权限认证 — RBAC、用户、角色、ACL
│ ├── phoenix-privilege-api
│ ├── phoenix-privilege-core
│ └── phoenix-privilege-rest
│
├── phoenix-platform # 平台管理 — 租户、组织、三方账号
│ ├── phoenix-platform-api
│ ├── phoenix-platform-core
│ └── phoenix-platform-rest
│
├── phoenix-common # 公共模块 — 基础模型、异常、SDK 封装
│ ├── phoenix-common-api
│ ├── phoenix-common-core
│ └── phoenix-common-rest
│
├── phoenix-tool # 工具模块 — 返回值封装、SQL 安全校验
├── phoenix-codegen # MyBatis-Flex 代码生成器
├── phoenix-flink # Apache Flink 大数据集成
│ ├── phoenix-flink-api
│ ├── phoenix-flink-core
│ └── phoenix-flink-server
├── phoenix-rag # 检索增强生成
│ ├── phoenix-rag-api
│ ├── phoenix-rag-core
│ └── phoenix-rag-rest
└── phoenix-kg # 知识图谱
├── phoenix-kg-api
├── phoenix-kg-core
└── phoenix-kg-rest
评论区