# agent-platform

**Repository Path**: aiagentdemo/agent-platform

## Basic Information

- **Project Name**: agent-platform
- **Description**: Agent 管理平台，支持对 Agent、应用、模型、技能、MCP 和知识库的统一管理
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 1
- **Created**: 2026-07-15
- **Last Updated**: 2026-09-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Agent 管理平台

一个基于 FastAPI + Vue 3 的 Agent 管理平台，支持对 Agent、应用、模型、技能、MCP 和知识库的统一管理。

## 界面预览

![Agent 管理平台](./screenshort.png)

## 项目结构

```
agent-platform/
├── backend/                    # 后端服务（FastAPI）
│   ├── app/
│   │   ├── main.py             # 应用入口，注册路由和中间件
│   │   ├── api/                # API 路由层
│   │   │   ├── auth.py         # 认证（登录/注册/Token）
│   │   │   ├── agents.py       # Agent 管理
│   │   │   ├── apps.py         # 应用管理
│   │   │   ├── models_api.py   # 模型配置管理
│   │   │   ├── skills.py       # 技能管理
│   │   │   ├── mcps.py         # MCP 管理
│   │   │   └── knowledge.py    # 知识库管理
│   │   ├── core/
│   │   │   ├── config.py       # 全局配置（读取环境变量）
│   │   │   └── security.py     # JWT / 密码加密工具
│   │   ├── models/
│   │   │   └── db.py           # 数据库模型（SQLModel）
│   │   └── schemas/            # Pydantic 请求/响应模型
│   ├── run.py                  # 启动脚本
│   ├── requirements.txt        # Python 依赖
│   ├── .env.example            # 环境变量示例
│   ├── agent_platform.db       # SQLite 数据库文件（运行后自动生成）
│   └── uploads/                # 文件上传目录
│
└── frontend/                   # 前端（Vue 3 + TypeScript）
    ├── src/
    │   ├── main.ts             # 前端入口
    │   ├── App.vue             # 根组件
    │   ├── api/                # 后端接口封装
    │   ├── router/             # Vue Router 路由配置
    │   ├── stores/             # Pinia 状态管理
    │   ├── utils/
    │   │   └── request.ts      # Axios 请求封装
    │   └── views/              # 页面组件
    │       ├── Login.vue
    │       ├── AgentSquare.vue
    │       ├── AgentCreate.vue
    │       ├── AgentDetail.vue
    │       ├── AppManager.vue
    │       ├── ModelSquare.vue
    │       ├── SkillSquare.vue
    │       ├── McpSquare.vue
    │       ├── KnowledgeBase.vue
    │       └── KnowledgeBaseDetail.vue
    ├── package.json
    └── vite.config.ts          # Vite 配置，开发代理指向 :8001
```

## 技术栈

| 端 | 技术 |
|---|---|
| 后端 | Python 3 / FastAPI / SQLModel / SQLite / JWT |
| 前端 | Vue 3 / TypeScript / Vite / Element Plus / Pinia |

## 启动方法

### 后端

```bash
cd backend

# 1. 创建并激活虚拟环境
python3 -m venv venv
source venv/bin/activate        # Windows: venv\Scripts\activate

# 2. 安装依赖
pip install -r requirements.txt

# 3. 配置环境变量
cp .env.example .env
# 按需修改 .env 中的 SECRET_KEY 等配置

# 4. 启动服务（监听 http://localhost:8001）
python run.py
```

> API 文档：启动后访问 [http://localhost:8001/docs](http://localhost:8001/docs)

### 前端

```bash
cd frontend

# 1. 安装依赖
npm install

# 2. 启动开发服务器（监听 http://localhost:5173）
npm run dev
```

> 开发模式下 `/api` 请求会自动代理到后端 `:8001`

### 生产构建

```bash
cd frontend
npm run build   # 产物输出到 frontend/dist/
```