# AgentPlatform

**Repository Path**: cky-my/agent-platform

## Basic Information

- **Project Name**: AgentPlatform
- **Description**: agent综合管理平台
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-18
- **Last Updated**: 2025-10-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI Agent Platform

一个专注于AI Agent MCP（模型上下文协议）平台学习和开发的综合平台，包含企业级架构设计和完整的前后端实现。

## 🚀 快速开始

### 环境要求

- **.NET 9.0 SDK** - [下载](https://dotnet.microsoft.com/download/dotnet)
- **Node.js 20.11+** - [下载](https://nodejs.org/en)
- **Docker Desktop** - [下载](https://www.docker.com/products/docker-desktop)
- **SQLite3** - 开发数据库（自动配置）

### 快速启动（推荐）

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

2. **初始化数据库**
   ```bash
   cd src/mvp/backend/aspnet-core
   # Windows
   scripts\init-sqlite.bat
   # Linux/Mac
   bash scripts/init-sqlite.sh
   ```

3. **启动Redis服务**
   ```bash
   docker-compose up -d redis
   ```

4. **启动后端应用**
   ```bash
   dotnet run --project src/CKY.AgentPlatform.HttpApi.Host
   ```

5. **访问应用**
   - 前端地址: http://localhost:3001
   - API地址: https://localhost:44300
   - Swagger文档: https://localhost:44300/swagger

### 完整开发环境

1. **启动所有中间件**
   ```bash
   cd src/mvp/backend/aspnet-core
   docker-compose up -d
   ```

2. **前端开发**
   ```bash
   cd src/mvp/frontend
   npm install
   npm start
   ```

## 📁 项目结构

```
agent-platform/
├── README.md                      # 项目说明
├── CLAUDE.md                      # 开发指南
├── doc/                          # 文档目录
│   ├── 01-项目概述/             # 项目总结和报告
│   ├── 02-需求分析/             # 需求文档和规划
│   ├── 03-架构设计/             # 技术架构和设计
│   ├── 04-开发资源/             # 开发指南和资源
│   └── archive/                 # 历史文档存档
└── src/                          # 源代码
    └── mvp/                      # MVP实现
        ├── backend/aspnet-core/   # ABP后端项目
        │   ├── src/              # 源代码
        │   │   ├── CKY.AgentPlatform.HttpApi.Host/        # Web应用主机
        │   │   ├── CKY.AgentPlatform.DbMigrator/           # 数据库迁移工具
        │   │   ├── CKY.AgentPlatform.Application/         # 应用层
        │   │   ├── CKY.AgentPlatform.Domain/              # 领域层
        │   │   ├── CKY.AgentPlatform.EntityFrameworkCore/  # 数据访问层
        │   │   └── ...                                     # 其他模块
        │   └── test/             # 测试项目
        └── frontend/            # React前端项目
            ├── src/              # 源代码
            ├── public/           # 静态资源
            └── package.json      # 前端配置
```

## 🛠️ 技术栈

### 后端技术栈
- **.NET 9.0** - 主框架
- **ABP vNext 9.0.0** - 企业级应用框架
- **Entity Framework Core** - ORM框架
- **多数据库支持** - SQLite/MySQL/PostgreSQL/SQL Server
- **Redis** - 缓存和会话存储
- **Swagger/OpenAPI** - API文档
- **IdentityServer** - 认证授权
- **Serilog** - 结构化日志记录
- **Docker** - 容器化部署

### 前端技术栈
- **React 18.2.0** - UI框架
- **TypeScript 4.9.0** - 类型安全
- **Ant Design 5.0.0** - UI组件库
- **Recharts** - 数据可视化
- **UmiJS** - 企业级前端应用框架
- **Jest** - 单元测试
- **Cypress** - E2E测试

### AI集成
- **OpenAI API** - GPT模型支持
- **智谱AI** - GLM模型支持
- **HTTP API** - 通用大模型接口
- **MCP协议** - Model Context Protocol支持

## ✨ 核心功能

### 智能体管理
- 创建、编辑、删除AI智能体
- 智能体状态监控和管理
- 智能体性能分析和优化

### 模型配置
- 多种AI模型配置管理
- 模型参数调优和测试
- 模型性能监控和对比

### 对话系统
- 实时对话记录和管理
- 对话内容分析和统计
- 多轮对话支持

### MCP工具集成
- Model Context Protocol工具集成
- 动态工具发现和注册
- 工具调用监控和分析

### 监控仪表板
- 实时系统性能监控
- 资源使用情况统计
- 错误日志和告警管理

### 用户管理
- 完整的用户认证和授权
- 角色权限管理
- 用户行为审计

## 📚 开发文档

详细的开发文档请参考 `doc/` 目录和 `src/mvp/backend/aspnet-core/docs/` 目录：

### 核心文档
- **[项目概述](doc/01-项目概述/)** - 项目背景和进展
- **[需求分析](doc/02-需求分析/)** - 详细需求说明
- **[架构设计](doc/03-架构设计/)** - 技术架构和设计
- **[开发资源](doc/04-开发资源/)** - 开发规范和指南

### 技术文档
- **[数据库管理指南](src/mvp/backend/aspnet-core/docs/数据库管理指南.md)** - 数据库配置和维护
- **[数据库配置指南](src/mvp/backend/aspnet-core/docs/数据库配置指南.md)** - 多数据库配置说明
- **[开发调试指南](src/mvp/backend/aspnet-core/docs/开发调试指南.md)** - 开发环境配置和调试

## 🤝 贡献指南

欢迎贡献代码和建议！请参考以下指南：

1. 遵循 `doc/04-开发资源/CLAUDE.md` 中的开发规范
2. 提交前确保代码通过所有测试
3. 及时更新相关文档
4. 遵循项目的代码风格和最佳实践

## 📋 项目状态

### 已完成功能 ✅
- ✅ 企业级ABP框架架构
- ✅ 多数据库支持（SQLite/MySQL/PostgreSQL/SQL Server）
- ✅ AI模型集成（OpenAI、Anthropic、Azure、Google、智谱AI）
- ✅ Agent执行引擎和多轮对话
- ✅ MCP工具执行系统
- ✅ 大模型调用服务
- ✅ Prompt模板服务
- ✅ 会话管理系统
- ✅ 增强错误处理和监控
- ✅ 断路器保护机制
- ✅ 性能指标收集
- ✅ Docker容器化部署
- ✅ Redis缓存系统
- ✅ 用户认证和授权
- ✅ API限流和安全中间件
- ✅ 模块化架构设计

### 开发中功能 🚧
- 🚧 前端React界面完善
- 🚧 高级分析功能
- 🚧 性能优化
- 🚧 多租户支持

### 计划中功能 📋
- 📋 知识库集成
- 📋 多智能体协作
- 📋 第三方服务集成
- 📋 微信机器人集成
- 📋 企业微信集成

## 🔧 配置说明

### 数据库配置
支持多种数据库，默认使用SQLite：

```json
{
  "ConnectionStrings": {
    "Default": "Data Source=AgentPlatform.db"
  }
}
```

### AI模型配置
支持多种AI模型提供商：

```json
{
  "AI": {
    "ModelProviders": {
      "OpenAI": {
        "ApiKey": "your-openai-api-key",
        "BaseUrl": "https://api.openai.com/v1/"
      },
      "ZhipuAI": {
        "ApiKey": "your-zhipuai-api-key",
        "BaseUrl": "https://open.bigmodel.cn/api/paas/v4/"
      }
    }
  }
}
```

### 监控配置
内置监控和日志记录：

```json
{
  "EnhancedModelService": {
    "MonitoringConfig": {
      "Enabled": true,
      "DataRetentionHours": 168,
      "EnableRealTimeMetrics": true
    }
  }
}
```

### Docker环境配置
完整的环境配置请参考 `src/mvp/backend/aspnet-core/appsettings.Docker.json`

## 🐛 问题反馈

如果您发现任何问题或有改进建议，请：

1. 查看现有文档是否已有解决方案
2. 检查是否是已知问题
3. 提供详细的问题描述和复现步骤
4. 附上相关的日志和错误信息

## 📄 许可证

本项目采用 MIT 许可证。详情请参阅 [LICENSE](LICENSE) 文件。

## 🙏 致谢

感谢所有为这个项目做出贡献的开发者和社区成员！

---

**最后更新**: 2025年9月26日
**最新版本**: v2.0.0 - 企业级AI Agent平台