<div align="center">

PaiAgent

企业级 AI 工作流可视化编排平台

通过拖拽式界面快速构建、编排和执行 AI 工作流，让 AI 能力组合更简单

快速开始 • 功能特性 • 技术架构 • 使用文档 • 开发进度

</div>

---

📖 项目简介

PaiAgent 是一个企业级的 AI 工作流可视化编排平台，让 AI 能力的组合和调度变得简单高效。通过直观的拖拽式界面，开发者和业务人员都能快速构建复杂的 AI 处理流程，无需编写代码即可实现多种大模型的协同工作。

💡 为什么选择 PaiAgent？

• 🎯 零代码编排：可视化拖拽界面，无需编程即可构建复杂 AI 工作流
• 🚀 双引擎驱动：自研 DAG 引擎 + LangGraph4j 状态图引擎，按需切换，兼顾简洁与复杂场景
• 🔌 多模型统一：基于 Spring AI 框架，统一接入 OpenAI、DeepSeek、通义千问等主流大模型
• 🧠 Skills 技能系统：内置提示词工程技能框架，支持 YAML 前缀声明式技能定义，三级渐进式加载
• 🛠️ 灵活扩展：基于插件化设计，轻松开发自定义节点满足个性化需求
• 🐛 实时调试：内置调试面板，支持 SSE 流式输出，可视化执行过程
• 📦 开箱即用：完整的前后端解决方案，快速部署到生产环境

项目教程

我已经放到技术派上了，点击这里查看详细教程（限时免费）。

第一期我更新了五篇教程，春节期间打算再更新五篇，假期有想学习的同学可以跟着这个项目冲。

• 搭建PaiAgent脚手架
• 节点配置
• LLM节点开发
• 超拟人音频节点
• 工作流实时推送

✨ 核心特性

可视化流程编辑器

基于 ReactFlow 构建的专业流程图编辑器，支持节点拖拽、连线配置、参数编辑等完整功能。

多大模型节点支持

基于 Spring AI + Spring AI Alibaba 框架统一接入：

• OpenAI 节点：GPT-5 等模型（Spring AI OpenAI 接口）
• DeepSeek 节点：国产大模型（OpenAI 兼容接口）
• 通义千问节点：阿里云千问系列（Spring AI Alibaba DashScope 原生支持）
• 智谱 AI 节点：GLM 系列模型（OpenAI 兼容接口）
• AIPing 节点：第三方模型代理（OpenAI 兼容接口）

工具节点生态

• TTS 音频合成：超拟人语音生成
• 输入/输出节点：灵活的数据输入输出
• 自定义扩展：基于统一接口开发专属节点

DAG 工作流引擎

• 拓扑排序：基于 Kahn 算法的节点调度
• 循环检测：DFS 深度优先搜索防止死循环
• 数据流转：节点间智能数据传递机制
• 执行监控：完整的执行日志和结果记录

LangGraph4j 状态图引擎（新增）

• 状态图编排：基于 LangGraph4j 的 StateGraph 构建复杂工作流，支持条件分支与动态路由
• 双引擎切换：通过 EngineSelector 按 engineType 字段自动路由到 DAG 或 LangGraph 引擎，向后兼容
• 异步节点执行：NodeAdapter 将现有 NodeExecutor 适配为 AsyncNodeAction，无需重写业务逻辑
• 状态管理：StateManager 统一管理工作流上下文，支持 inputData、nodeOutputs、globalContext
• 事件回调：执行过程中触发 ExecutionEvent，实时反馈每个节点的启动、成功和异常

Skills 技能系统（新增）

• 声明式技能定义：通过 SKILL.md + YAML Frontmatter 定义技能名称、描述和执行规则
• 三级渐进式加载：摘要（名称+描述）→ 详情（完整 SKILL.md）→ 引用文档（reference 子目录），按需加载节省 Token
• 技能注册中心：SkillRegistry 应用启动时自动扫描 classpath 和文件系统，缓存到 ConcurrentHashMap
• LLM Function 集成：通过 LoadSkillDetailFunction / LoadSkillReferenceFunction 暴露为 Spring AI FunctionCallback，让大模型自主调用技能
• REST API 支持：提供技能列表查询、详情获取、引用文档加载等接口
• 前端技能选择器：SkillSelector 组件支持在工作流中选择和应用技能

🎯 应用场景

| 场景类别 | 具体应用 | 适用对象 | |---------|---------|----------| | 📝 内容生成 | 批量文章生成、多语言翻译、内容改写润色 | 内容创作者、营销团队 | | 💬 智能客服 | 多轮对话流程、意图识别与智能响应 | 客服团队、产品经理 | | 📊 数据处理 | 文本分析、信息抽取、数据清洗转换 | 数据分析师、研发团队 | | 🎵 音视频处理 | 语音合成、字幕生成、音频转写 | 内容团队、教育行业 | | ⚙️ 流程自动化 | 报告生成、邮件自动回复、定时任务 | 运营团队、企业用户 |

🏗️ 技术架构

系统架构

┌─────────────────────────────────────────────────────────┐
│                      前端层 (Frontend)                    │
│  React 18 + TypeScript + ReactFlow + Ant Design         │
│  • 可视化编辑器  • 节点面板  • 调试工具                    │
└────────────────────┬────────────────────────────────────┘
                     │ REST API / SSE
┌────────────────────┴────────────────────────────────────┐
│                    应用层 (Backend)                       │
│              Spring Boot 3.4.1 + Java 21                │
│  • Controller  • Service  • Interceptor                 │
└────────────────────┬────────────────────────────────────┘
                     │
┌────────────────────┴────────────────────────────────────┐
│                  核心引擎层 (Engine)                      │
│  • EngineSelector: 引擎路由（DAG / LangGraph）            │
│  • DAGParser: 拓扑排序 + 循环检测                         │
│  • LangGraph4j: 状态图编排 + 条件路由                     │
│  • SkillRegistry: 技能注册中心 + 渐进式加载               │
│  • NodeExecutor: 节点执行器工厂                           │
└────────────────────┬────────────────────────────────────┘
                     │
┌────────────────────┴────────────────────────────────────┐
│                  AI 模型层 (Spring AI)                    │
│  • Spring AI: OpenAI/DeepSeek/智谱 等兼容接口             │
│  • Spring AI Alibaba: 通义千问 DashScope 原生支持         │
│  • ChatClientFactory: 统一的 ChatClient 动态工厂          │
└────────────────────┬────────────────────────────────────┘
                     │
┌────────────────────┴────────────────────────────────────┐
│              数据层 (Data & Storage)                     │
│  • MySQL: 工作流配置、执行记录                             │
│  • MinIO: 文件存储 (可选)                                 │
└─────────────────────────────────────────────────────────┘

技术栈详情

<table> <tr> <td><b>层级</b></td> <td><b>技术选型</b></td> <td><b>版本要求</b></td> <td><b>说明</b></td> </tr> <tr> <td rowspan="6"><b>前端</b></td> <td>React</td> <td>18.x</td> <td>现代化 UI 框架</td> </tr> <tr> <td>TypeScript</td> <td>5.x</td> <td>类型安全保障</td> </tr> <tr> <td>Vite</td> <td>5.x</td> <td>高性能构建工具</td> </tr> <tr> <td>ReactFlow</td> <td>最新版</td> <td>专业流程图库</td> </tr> <tr> <td>Ant Design + Tailwind CSS</td> <td>-</td> <td>企业级 UI 组件</td> </tr> <tr> <td>Zustand</td> <td>最新版</td> <td>轻量级状态管理</td> </tr> <tr> <td rowspan="6"><b>后端</b></td> <td>Spring Boot</td> <td>3.4.1</td> <td>企业级 Java 框架</td> </tr> <tr> <td>Java</td> <td>21+</td> <td>LTS 长期支持版本</td> </tr> <tr> <td>MyBatis-Plus</td> <td>3.5.5</td> <td>增强版 ORM 框架</td> </tr> <tr> <td>Spring AI</td> <td>1.0.0-M5</td> <td>AI 模型统一调用框架</td> </tr> <tr> <td>Spring AI Alibaba</td> <td>1.0.0-M6.1</td> <td>通义千问 DashScope 原生支持</td> </tr> <tr> <td>MySQL</td> <td>8.0+</td> <td>关系型数据库</td> </tr> <tr> <td>FastJSON2</td> <td>最新版</td> <td>高性能 JSON 库</td> </tr> <tr> <td>MinIO</td> <td>可选</td> <td>对象存储服务</td> </tr> <tr> <td rowspan="7"><b>核心引擎</b></td> <td>自研 DAG 引擎</td> <td>-</td> <td>工作流编排核心（拓扑排序 + 循环检测）</td> </tr> <tr> <td>LangGraph4j Core</td> <td>1.1.5</td> <td>状态图工作流引擎</td> </tr> <tr> <td>LangGraph4j Spring AI</td> <td>1.8.0-beta3</td> <td>LangGraph4j 与 Spring AI 集成桥接</td> </tr> <tr> <td>Skills 技能系统</td> <td>-</td> <td>声明式提示词工程框架</td> </tr> <tr> <td>EngineSelector</td> <td>-</td> <td>双引擎动态路由选择</td> </tr> <tr> <td>Spring AI ChatClient</td> <td>-</td> <td>统一 AI 模型调用接口</td> </tr> <tr> <td>ChatClientFactory</td> <td>-</td> <td>动态创建不同模型客户端</td> </tr> </table>

📁 项目结构

PaiAgent-one/
├── backend/                      # Spring Boot 后端服务
│   ├── src/main/
│   │   ├── java/com/paiagent/
│   │   │   ├── engine/          # 🎯 工作流引擎（核心）
│   │   │   │   ├── WorkflowEngine.java       # 工作流编排引擎
│   │   │   │   ├── EngineSelector.java       # 双引擎路由选择器
│   │   │   │   ├── dag/DAGParser.java        # 拓扑排序+循环检测
│   │   │   │   ├── langgraph/               # 🆕 LangGraph4j 引擎
│   │   │   │   │   ├── LangGraphWorkflowEngine.java  # LangGraph 执行引擎
│   │   │   │   │   ├── WorkflowState.java             # 状态模型
│   │   │   │   │   ├── builder/GraphBuilder.java      # StateGraph 构建器
│   │   │   │   │   ├── adapter/NodeAdapter.java       # AsyncNodeAction 适配器
│   │   │   │   │   └── state/StateManager.java        # 状态管理器
│   │   │   │   ├── skill/                   # 🆕 Skills 技能系统
│   │   │   │   │   ├── Skill.java                     # 技能数据模型
│   │   │   │   │   ├── SkillRegistry.java             # 技能注册中心
│   │   │   │   │   ├── SkillLoader.java               # SKILL.md 解析器
│   │   │   │   │   ├── LoadSkillDetailFunction.java   # FunctionCallback: 加载详情
│   │   │   │   │   └── LoadSkillReferenceFunction.java # FunctionCallback: 加载引用
│   │   │   │   ├── llm/                     # LLM 调用层（Spring AI）
│   │   │   │   │   ├── ChatClientFactory.java     # ChatClient 动态工厂
│   │   │   │   │   ├── PromptTemplateService.java # 提示词模板处理
│   │   │   │   │   └── LLMNodeConfig.java         # LLM 节点配置
│   │   │   │   ├── executor/                # 节点执行器
│   │   │   │   │   ├── NodeExecutor.java    # 执行器接口
│   │   │   │   │   ├── NodeExecutorFactory.java  # 工厂模式
│   │   │   │   │   └── impl/               # 具体实现
│   │   │   │   │       ├── AbstractLLMNodeExecutor.java  # LLM 抽象基类
│   │   │   │   │       ├── InputNodeExecutor.java
│   │   │   │   │       ├── OutputNodeExecutor.java
│   │   │   │   │       ├── OpenAINodeExecutor.java
│   │   │   │   │       ├── DeepSeekNodeExecutor.java
│   │   │   │   │       ├── QwenNodeExecutor.java
│   │   │   │   │       ├── ZhiPuNodeExecutor.java
│   │   │   │   │       ├── AIPingNodeExecutor.java
│   │   │   │   │       └── TTSNodeExecutor.java
│   │   │   │   └── model/                   # 数据模型
│   │   │   ├── controller/      # REST API 接口层
│   │   │   ├── service/         # 业务逻辑层
│   │   │   ├── mapper/          # MyBatis-Plus 数据访问层
│   │   │   ├── entity/          # 数据库实体
│   │   │   ├── dto/             # 数据传输对象
│   │   │   ├── config/          # 配置类
│   │   │   ├── interceptor/     # 拦截器（认证）
│   │   │   └── common/          # 通用工具
│   │   └── resources/
│   │       ├── application.yml  # 应用配置
│   │       ├── schema.sql       # 数据库初始化脚