AI Agent 管理和调度系统

一个企业级平台，用于统一管理和调度多种 AI Agent（包括 OpenClaw、Claude Code、OpenCode 等），提供 Agent 生命周期管理、智能调度编排、监控观测、安全治理等核心能力。

功能特性

• Agent 生命周期管理: 注册、发现、部署、配置、升级、回滚
• 智能调度: 基于优先级的任务队列、负载均衡、多种调度策略
• 多 Agent 编排: Supervisor、Swarm、Pipeline、Parallel 多种模式
• 监控与可观测性: 实时监控、日志管理、性能分析
• 安全与治理: RBAC、数据加密、审计日志、Agent 护栏

技术栈

后端

• Node.js + TypeScript
• Express.js
• Prisma ORM
• PostgreSQL
• Redis
• WebSocket

前端

• React + TypeScript
• Tailwind CSS
• shadcn/ui
• Zustand

快速开始

使用 Docker Compose 部署

# 克隆项目
git clone <repository-url>
cd agent-platform

# 启动服务
docker-compose up -d

# 查看日志
docker-compose logs -f

# 停止服务
docker-compose down

服务启动后：

• 前端界面: http://localhost
• 后端 API: http://localhost:3000
• API 文档: http://localhost:3000/api/v1/health

本地开发

后端开发

cd backend

# 安装依赖
npm install

# 配置环境变量
cp .env.example .env
# 编辑 .env 文件配置数据库和 Redis

# 运行数据库迁移
npx prisma migrate dev

# 启动开发服务器
npm run dev

前端开发

cd frontend

# 安装依赖
npm install

# 配置环境变量
echo "VITE_API_URL=http://localhost:3000/api/v1" > .env.local

# 启动开发服务器
npm run dev

API 文档

Agent API

方法	路径	描述
POST	/api/v1/agents	创建 Agent
GET	/api/v1/agents	获取 Agent 列表
GET	/api/v1/agents/:id	获取单个 Agent
PATCH	/api/v1/agents/:id	更新 Agent
DELETE	/api/v1/agents/:id	删除 Agent
POST	/api/v1/agents/:id/heartbeat	Agent 心跳

Task API

方法	路径	描述
POST	/api/v1/tasks	创建任务
GET	/api/v1/tasks	获取任务列表
GET	/api/v1/tasks/:id	获取单个任务
POST	/api/v1/tasks/:id/schedule	调度任务
POST	/api/v1/tasks/:id/cancel	取消任务
DELETE	/api/v1/tasks/:id	删除任务

Workflow API

方法	路径	描述
POST	/api/v1/workflows	创建工作流
GET	/api/v1/workflows	获取工作流列表
GET	/api/v1/workflows/:id	获取单个工作流
PATCH	/api/v1/workflows/:id	更新工作流
DELETE	/api/v1/workflows/:id	删除工作流
POST	/api/v1/workflows/:id/execute	执行工作流

System API

方法	路径	描述
GET	/api/v1/system/status	获取系统状态
POST	/api/v1/system/scheduler/start	启动调度器
POST	/api/v1/system/scheduler/stop	停止调度器
GET	/api/v1/system/metrics	获取系统指标

项目结构

agent-platform/
├── backend/              # 后端服务
│   ├── src/
│   │   ├── controllers/  # 控制器
│   │   ├── services/     # 服务层
│   │   ├── routes/       # 路由
│   │   ├── models/       # 数据模型
│   │   ├── middleware/   # 中间件
│   │   ├── utils/        # 工具函数
│   │   └── types/        # 类型定义
│   ├── prisma/           # Prisma 配置
│   └── Dockerfile
├── frontend/             # 前端应用
│   ├── src/
│   │   ├── components/   # 组件
│   │   ├── pages/        # 页面
│   │   ├── stores/       # 状态管理
│   │   ├── hooks/        # 自定义 Hooks
│   │   └── types/        # 类型定义
│   └── Dockerfile
├── shared/               # 共享类型
├── tests/                # 测试
├── docker-compose.yml    # Docker Compose 配置
└── README.md

配置说明

环境变量

后端

变量名	描述	默认值
DATABASE_URL	PostgreSQL 连接字符串	-
REDIS_HOST	Redis 主机	localhost
REDIS_PORT	Redis 端口	6379
PORT	服务端口	3000
JWT_SECRET	JWT 密钥	-
SCHEDULER_POLL_INTERVAL	调度器轮询间隔	1000
SCHEDULER_MAX_CONCURRENT_TASKS	最大并发任务数	10

前端

变量名	描述	默认值
VITE_API_URL	API 基础 URL	http://localhost:3000/api/v1

测试

# 运行单元测试
npm test

# 运行集成测试
npm run test:integration

部署

生产环境部署

1. 配置环境变量
2. 构建 Docker 镜像
3. 使用 Docker Compose 启动服务

# 构建并启动
docker-compose -f docker-compose.yml up -d --build

Kubernetes 部署

# 应用配置
kubectl apply -f k8s/

贡献指南

1. Fork 项目
2. 创建特性分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m 'Add amazing feature')
4. 推送分支 (git push origin feature/amazing-feature)
5. 创建 Pull Request

许可证

MIT License