Phoenix — 企业级智能体管理平台

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 的核心是 StateGraph 驱动的 NL2SQL 工作流，包含以下节点：

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

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

智能体核心能力：

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

Phoenix 前端基于 Vben 5（Vue 3 + TypeScript + Vite）构建，实现前台分析交互与后台统一管理的现代化 SPA。

前端源码位于独立仓库，与本后端通过 REST + SSE 接口通信。

• JDK 21+
• Maven 3.9+（需在 PATH 中）
• PostgreSQL 14+（含 pgvector 插件）
• Redis 7+
• （可选）Docker — Python 深度分析

# 1. 克隆项目
git clone https://github.com/liu463805737-collab/Phoenix-Agent-Java.git
或
git clone https://gitee.com/lwj/phoenix-agent-java.git
cd phoenix

# 2. 导入数据库（PostgreSQL）
## 注意PostgreSQL需要安装支持向量插件（pgvector）
psql -U your_user -d your_db < sql/all_data.sql

# 3. 构建项目（跳过格式检查）
mvn clean install -Dspring-javaformat.skip=true


# 4. 启动服务

# 启动统一管理平台（端口 8066，推荐）
mvn spring-boot:run -pl phoenix-admin/phoenix-admin-manager

• PostgreSQL — 业务数据存储
• Redis — Graph 状态持久化（RedisSaver）、缓存、分布式锁

Maven settings 文件：/Users/liuwenjun/java/doc/maven-setting/dragon-settings.xml

• 贡献指南：欢迎提交 Issue 和 PR
• 开发规范：代码需通过 spring-javaformat:validate 格式检查

感兴趣的朋友欢迎加微信一起交流探讨～

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