# agent-studio

**Repository Path**: LambdaH/agent-studio

## Basic Information

- **Project Name**: agent-studio
- **Description**: 互联网软件团队作业，已完成最终云部署和核心功能测试
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-25
- **Last Updated**: 2025-12-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Agent Studio Lite

一个轻量级的Agent工作流管理系统，支持任务配置、执行和监控。

## 项目简介

Agent Studio Lite 是一个基于工作流的智能体开发平台，提供可视化工作流设计、状态机引擎驱动、多节点类型支持等功能。系统采用前后端分离架构，支持容器化部署，集成了大模型服务和向量数据库，为智能体开发提供完整的解决方案。

## 快速开始

### 前置条件

- **操作系统**：Linux Ubuntu 22.04 或 Windows 10/11
- **Docker环境**：Docker 20.10+ 和 Docker Compose 2.0+
- **硬盘空间**：至少10GB可用磁盘空间（首次启动需要下载大模型环境配置）
- **网络要求**：镜像下载需要访问私有镜像仓库 `docker.xuanyuan.run`（如果没有账号，需要修改镜像源）
- **API密钥**：需要替换项目中的所有密钥为私人、可用密钥

### 一键部署

1. **克隆项目**
   ```bash
   git clone <repository-url>
   cd agent-studio
   ```

2. **启动服务**
   ```bash
   # Windows环境（推荐）
   docker compose -f docker-compose.windows-all.yml up -d
   
   # 生产环境（需要配置.env.prod文件）
   cp .notenv.prod .env.prod
   docker compose -f docker-compose.prod.yml up -d
   ```

3. **等待服务启动**
   - 首次启动需要下载镜像、初始化数据库、大模型和大量环境配置，约需20分钟
   - 可通过 `docker logs <container-name>` 查看启动状态

### 服务访问

**访问地址**：
- 前端界面：http://云主机IP
- 后端API：http://云主机IP/api (通过Nginx代理)
- 其他服务仅内部访问，不对外暴露端口

## 核心特性

- **可视化工作流设计器**：基于SVG画布的拖拽式工作流编辑器
- **状态机工作流引擎**：突破传统DAG限制，支持循环逻辑和复杂分支
- **多节点类型支持**：基础节点、分支节点、并行节点、大模型节点等
- **异步执行机制**：基于线程池的工作流异步执行和状态管理
- **智能体集成**：支持大模型服务和知识库检索
- **容器化部署**：Docker Compose一键部署，支持生产环境配置

## 技术栈

- **后端**：Spring Boot 3.2.5 + MyBatis 3.0.3 + Java 17
- **前端**：Vue 3.4.21 + Element Plus 2.6.0 + Vite 5.2.0
- **数据库**：MySQL 8.0（业务数据） + PostgreSQL + pgvector（向量数据库）
- **缓存**：Redis 7-alpine
- **容器化**：Docker + Docker Compose + Nginx反向代理
- **AI服务**：BGE-small-zh-v1.5文本向量化模型 + 大模型集成
- **安全认证**：Spring Security + JWT令牌认证

## 项目结构

```
agent-studio/
├── Back-end/                 # 后端服务（Spring Boot）
│   ├── src/main/java/       # Java源代码
│   ├── Dockerfile           # 后端容器配置
│   └── pom.xml             # Maven依赖配置
├── Front-end/               # 前端应用（Vue3）
│   ├── src/                 # Vue源代码
│   ├── Dockerfile           # 前端容器配置
│   └── package.json         # Node.js依赖配置
├── Database/                # 数据库初始化脚本
│   ├── init/               # MySQL初始化
│   └── pgvector-init/      # 向量数据库初始化
├── Embedding-service/       # 文本向量化服务
│   ├── app.py              # FastAPI应用
│   ├── model/              # BGE模型文件
│   └── requirements.txt     # Python依赖
├── nginx-proxy/            # Nginx反向代理配置
├── docker-compose.yml              # 基础Docker配置（已弃用）
├── docker-compose.windows.yml      # 数据库docker化，前后端本地部署测试
├── docker-compose.windows-all.yml  # 完整配置
├── docker-compose.prod.yml         # 生产环境完整配置
└── README.md               # 项目说明文档
```

### 健康检查

所有服务都配置了健康检查，可通过以下命令验证服务状态：

```bash
# 查看所有服务状态
docker compose -f docker-compose.windows-all.yml ps

# 查看特定服务日志
docker logs agent-studio-backend-test
```

## 功能模块

### 工作流管理
- 可视化工作流设计器
- 节点拖拽和连接
- 工作流版本控制
- 执行历史记录

### 智能体管理
- 智能体配置和训练
- 知识库管理
- 模型集成配置

### 系统管理
- 用户权限管理
- 系统监控
- 日志审计

## 开发指南

### 后端开发
```bash
cd Back-end
# 安装依赖
mvn clean install
# 启动开发服务器
mvn spring-boot:run
```

### 前端开发
```bash
cd Front-end
# 安装依赖
npm install
# 启动开发服务器
npm run dev
```


## 部署说明

### 环境变量配置
生产环境部署前，请创建 `.env.prod` 文件并配置环境变量。


### 镜像源说明
由于网络访问限制，本项目使用了私有镜像仓库 `docker.xuanyuan.run`。如遇镜像拉取问题，请：
1. 检查网络连接
2. 或修改docker-compose文件中的镜像源为公开镜像
3. 或配置Docker镜像加速器

### 生产环境优化
- 使用 `docker-compose.prod.yml` 配置文件
- 启用Nginx反向代理和负载均衡
- 配置SSL证书启用HTTPS
- 设置资源限制和健康检查

## 故障排除

### 常见问题

1. **端口冲突**：检查80、3306、6379等端口是否被占用
2. **镜像拉取失败**：确认网络可访问 `docker.xuanyuan.run`，或修改镜像源
3. **服务启动失败**：查看容器日志定位具体错误
4. **硬盘空间不足**：确保至少有10GB可用空间用于模型文件

### 日志查看
```bash
# 查看所有服务日志
docker compose logs

# 查看特定服务日志
docker logs <container-name>
```

## 贡献指南

欢迎提交Issue和Pull Request来改进项目。

## 许可证

本项目采用MIT许可证，详见LICENSE文件。