1. 开源项目地址

git clone https://github.com/liu463805737-collab/Phoenix-Agent-Java.git
或
git clone https://gitee.com/lwj/phoenix-agent-java.git

环境要求

• JDK 21+
• PostgreSQL 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 生态工具。

✨ 核心特性

🏗️ 模块架构

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

phoenix-data: NL2SQL 工作流

Phoenix 的核心是 StateGraph 驱动的 NL2SQL 工作流，包含以下节点：

IntentRecognition → EvidenceRecall → QueryEnhance → SchemaRecall → TableRelation → FeasibilityAssessment → Planner → PlanExecutor → [SqlGenerate→SemanticConsistency→SqlExecute | PythonGenerate→PythonExecute→PythonAnalyze | ReportGenerator | HumanFeedback]

phoenix-agent: 自定义智能体开发

Phoenix 提供完整的智能体开发框架，支持两种范式：

智能体核心能力：

• 会话管理：完整的多轮对话 Session 管理，自动保存对话历史
• 长期记忆：支持用户画像（Profile）、事实记忆（Fact）、向量语义检索
• 短期记忆：基于 RedisSaver 的状态检查点
• 工具系统：基于 @Tool 注解的工具注册，支持 SQL 查询、知识检索、外部 API
• MCP 集成：可对外暴露 MCP 工具，接入 Claude Desktop 等 MCP 客户端
• Human-in-the-Loop：支持工具调用的人工审核与干预
• 用量追踪：按用户按智能体的调用次数统计与限流

系统演示

📄 许可证

本项目采用 Apache License 2.0 许可证。