agent-management

Agent Management

一个 AI 智能体管理与可视化编排平台。支持 Skill 文件管理、标签分类、可视化工作流编排和 DAG 调度执行。

技术栈

层级	技术
后端	Java 17 + Spring Boot 3.3 + Spring AI 1.0 + JPA
前端	Vue 3 + Vue Flow + Naive UI + Pinia
数据库	H2（嵌入式文件模式）
AI	智谱 AI (GLM) — 翻译 + 条件分支判断
构建	Maven + Vite，前后端合并打包为单一 JAR

功能特性

• 智能体管理 — 上传、编辑、删除 Skill（基于文件系统中的 SKILL.md）
• 自动翻译 — Skill 描述的英文→中文翻译，SSE 实时推送翻译进度
• 标签管理 — 树形标签分类，支持创建标签组、子标签、标签移动和删除
• 可视化工作流编排 — 拖拽式画布编辑器，支持 5 种节点类型（用户输入、LLM、智能体、条件分支、输出）
• DAG 调度引擎 — 拓扑排序执行、循环依赖检测、模板变量渲染、SSE 实时状态推送
• 统一部署 — 前端构建产物直接嵌入 Spring Boot，单一 JAR 同端口部署

快速开始

环境要求

• Java 17+
• Maven 3.6+
• Node.js 18+（仅构建前端时需要）

配置

复制示例配置文件并填入真实值：

cp backend/src/main/resources/application.yml.example backend/src/main/resources/application.yml

编辑 application.yml，填入你的 AI 服务 API Key（参见文件中注释）。

构建 & 运行

Windows：

run.bat

Linux / macOS：

chmod +x run.sh
./run.sh

仅构建（不启动）：

run.bat build    # Windows
./run.sh build   # Linux/macOS

单独运行

java -jar backend/target/agent-management-1.0.0.jar

启动后访问 http://localhost:2438。

项目结构

├── backend/                          # Spring Boot 后端
│   ├── src/main/java/com/agent/management/
│   │   ├── controller/               # REST API 控制器
│   │   ├── service/                  # 业务逻辑层
│   │   ├── engine/                   # 工作流 DAG 调度引擎
│   │   │   └── executor/             # 节点执行器（LLM、Agent、Condition 等）
│   │   ├── model/                    # 实体、DTO、VO
│   │   ├── repository/               # JPA 数据访问层
│   │   ├── parser/                   # SKILL.md 解析器
│   │   ├── config/                   # 配置类（CORS、SPA Fallback）
│   │   └── common/                   # 通用工具（统一响应、异常处理）
│   └── src/main/resources/
│       ├── application.yml           # 后端配置（需从 .example 复制）
│       └── static/                   # 前端构建产物（Vite 直出）
├── frontend/                         # Vue 3 前端
│   ├── src/
│   │   ├── views/                    # 页面组件
│   │   │   ├── SkillManagement.vue   # 智能体管理页
│   │   │   ├── TagManagement.vue     # 标签管理页
│   │   │   └── workflow/             # 工作流页面
│   │   │       ├── WorkflowList.vue  # 工作流列表
│   │   │       └── WorkflowEditor.vue # 工作流画布编辑器
│   │   ├── components/               # 组件
│   │   │   ├── layout/               # 布局组件
│   │   │   ├── skill/                # 智能体组件
│   │   │   ├── tag/                  # 标签组件
│   │   │   └── workflow/nodes/       # 工作流节点组件（6 种）
│   │   ├── api/                      # API 请求封装
│   │   ├── stores/                   # Pinia 状态管理
│   │   ├── router/                   # 路由配置
│   │   └── utils/                    # 工具函数（request、SSE）
│   └── vite.config.js
├── docs/                             # 项目文档
├── run.bat                           # Windows 构建运行脚本
└── run.sh                            # Linux/macOS 构建运行脚本

API 接口

智能体管理

方法	路径	说明
GET	/api/skills	获取所有 Skill 列表
POST	/api/skills/upload	上传 Skill 压缩包
POST	/api/skills/{folderName}/edit	编辑 Skill 名称和描述
POST	/api/skills/{folderName}/delete	删除 Skill

标签管理

方法	路径	说明
GET	/api/tags/groups	获取所有标签组
POST	/api/tags/groups	创建标签组
POST	/api/tags/groups/{id}/edit	编辑标签组
POST	/api/tags/groups/{id}/delete	删除标签组
GET	/api/tags/groups/{groupId}/tags	获取标签组的全部标签
POST	/api/tags/groups/{groupId}/tags	创建子标签
POST	/api/tags/{id}/edit	修改标签名称
POST	/api/tags/{id}/delete	删除标签（递归）
POST	/api/tags/{id}/move	移动标签到新父节点

翻译服务

方法	路径	说明
GET	/api/translations/stream	SSE 翻译推送流
POST	/api/translations/translate	同步翻译（编辑时使用）

工作流

方法	路径	说明
GET	/api/workflows	获取所有工作流
GET	/api/workflows/{id}	获取工作流详情
POST	/api/workflows	创建工作流
POST	/api/workflows/{id}/save	保存工作流（含画布数据）
POST	/api/workflows/{id}/delete	删除工作流
POST	/api/workflows/{id}/run	运行工作流（SSE 实时推送）

配置说明

配置项	文件	说明
server.port	application.yml	后端服务端口，默认 2438
skill.base-path	application.yml	Skill 文件存放目录
spring.ai.openai.base-url	application.yml	AI 服务接口地址
spring.ai.openai.api-key	application.yml	AI 服务 API Key（⚠️ 需配置）

License

请查看 LICENSE 文件。