1. 开源项目地址git clone https://github.com/liu463805737-collab/Phoenix-Agent-Java.git或git clone https://gitee.com/lwj/phoenix-agent-java.git环境要求JDK 21PostgreSQL 14含 pgvector 插件Redis 7可选Docker — Python 深度分析 项目简介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 → LangfuseLLM 调用全过程可观测。️ 模块架构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-restphoenix-data: NL2SQL 工作流Phoenix 的核心是 StateGraph 驱动的 NL2SQL 工作流包含以下节点IntentRecognition→EvidenceRecall→QueryEnhance→SchemaRecall→TableRelation→FeasibilityAssessment→Planner→PlanExecutor→ [SqlGenerate→SemanticConsistency→SqlExecute|PythonGenerate→PythonExecute→PythonAnalyze|ReportGenerator|HumanFeedback]phoenix-agent: 自定义智能体开发Phoenix 提供完整的智能体开发框架支持两种范式范式说明适用场景React AgentLLM 驱动的 ReAct 模式推理-行动-观察循环自动选择工具流程分析、知识问答、文档检索等工具型智能体Workflow Graph预定义的 StateGraph 工作流节点间显式编排有固定业务步骤的复杂任务如审批、多步分析智能体核心能力会话管理完整的多轮对话 Session 管理自动保存对话历史长期记忆支持用户画像Profile、事实记忆Fact、向量语义检索短期记忆基于 RedisSaver 的状态检查点工具系统基于Tool注解的工具注册支持 SQL 查询、知识检索、外部 APIMCP 集成可对外暴露 MCP 工具接入 Claude Desktop 等 MCP 客户端Human-in-the-Loop支持工具调用的人工审核与干预用量追踪按用户按智能体的调用次数统计与限流系统演示 许可证本项目采用 Apache License 2.0 许可证。