目 录CONTENT

文章目录

推荐一个企业级 AI Agent开源项目

ByteNews
2025-03-12 / 0 评论 / 0 点赞 / 973 阅读 / 0 字

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 生态工具。

✨ 核心特性

特性

说明

自定义智能体

基于 React Agent / Workflow Graph 框架,可快速构建和发布企业级 AI 智能体。

StateGraph 驱动

基于状态图的 NL2SQL 工作流,支持意图识别 → 证据召回 → Schema 召回 → 规划 → 执行的全链路编排。

Python 深度分析

内置 Docker/Local Python 执行器,自动生成并执行 Python 代码进行统计分析、机器学习预测。

智能报告生成

分析结果自动汇总为包含 ECharts 图表的 HTML/Markdown 报告,所见即所得。

人工反馈机制

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

RAG 检索增强

混合检索策略(向量 + 关键词 + 融合排序),支持业务元数据与术语库的语义检索。

多模型调度

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

MCP 服务器

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

多数据源支持

开箱即用支持 MySQL、PostgreSQL、Oracle、SQL Server、H2、Hive、达梦。

智能体记忆

支持短期记忆(Redis 检查点)、长期记忆(用户画像 + 事实记忆 + 向量语义检索)。

多轮对话

可配置的多轮对话上下文管理(支持历史最多 5 轮),保持对话连贯性。

RBAC 权限

完善的用户-角色-部门-公司四级权限体系,细粒度 API Key 管理。

Vben5 管理后台

基于 Vue 3 + Vben 5 的现代化管理界面,统一管理智能体、数据源、模型、用户权限。

多租户与三方集成

支持租户隔离以及钉钉、飞书、企业微信集成。

全链路追踪

集成 OpenTelemetry → Langfuse,LLM 调用全过程可观测。

部署居然这么简单

最怕的就是开源项目部署起来要折腾半天,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

写在最后

仓库地址:https://gitee.com/lwj/phoenix

0
广告 广告

评论区