Monkeys 架构
当前 Monkeys 生态的逻辑架构
架构概览
Monkeys 现在是多仓库生态。monkeys 仓库是文档和基础设施入口,产品运行时代码位于各自负责的服务仓库。
核心产品
核心产品是 Monkeys 平台最小可用的一组服务。
| 模块 | 仓库 | 职责 |
|---|---|---|
| Studio 前端 | monkeys-studio | 面向用户的主工作区,包含工作流、Agent、工具、资产、设计、数据、评测和设置。 |
| Kernel 前端 | monkeys-kernel | 平台和 kernel 管理前端。 |
| Compute 前端 | monkeys-compute | 算力控制面前端。 |
| 主后端 | monkeys-server | 核心 API、工作流入口、认证、marketplace、资产、工具、模型配置和服务总线。 |
能力服务
能力服务只在对应功能区域需要时部署。
| 能力 | 仓库 | 关系 |
|---|---|---|
| Agent 运行时 | monkeys-agent-server、monkeys-mcp-server、monkey-tools-agentkits | Agent 线程、消息、模型提供商、工具调用、人工审批、MCP 访问和可复用 Agent 工具。 |
| 计费和用量 | monkeys-billing-server | 工具定价、团队余额、用量流水和支付集成。 |
| 数据工作流 | monkeys-data-server、monkeys-conductor-worker | 数据资源 API、标签/视图搜索、索引和工作流任务执行。 |
| Webhook | monkeys-webhook-server | 告警、恢复、日报、周报洞察和通知渠道投递。 |
| 第三方工具 | monkey-tools-third-party-api、monkey-tools-third-party-api-python、monkey-tools-sandbox、monkey-tools-agentkits | 外部 API 适配器、Python 工具、代码执行和 Agent 工具包。 |
| 图片与 ComfyUI 流程 | monkeys-comfyui-worker | ComfyUI 队列和图像生成执行。 |
| 训练流程 | monkeys-training-worker | 模型训练和模型测试后台任务。 |
基础设施
monkeys 本地基础设施栈包含:
| 基础设施 | 本地端点 | 使用方 |
|---|---|---|
| PostgreSQL | localhost:5432 | 主后端、agent、billing、data、webhook、Conductor、workers。 |
| Redis | localhost:6379 | 缓存、队列、后台分发、workers。 |
| Elasticsearch | http://localhost:9200 | Conductor 索引和数据检索加速。 |
| Conductor API | http://localhost:8080/api | 工作流编排和任务分发。 |
| Conductor UI | http://localhost:5008 | 本地工作流调试。 |
| MinIO | http://localhost:9000 | 本地文件和资产对象存储。 |
| Prometheus | http://localhost:9090 | 指标采集。 |
| Grafana | http://localhost:3003 | 仪表盘。 |
部署形态
本地 services compose 默认启动核心产品:
monkeys-servermonkeys-studiomonkeys-kernelmonkeys-compute
可选 profiles 会添加功能区域:agent、billing、data、webhook、mcp、worker、training、comfyui、tools 和 sandbox。
职责规则
monkeys负责生态文档、本地基础设施 compose、services compose 和 Agent 启动说明。- 每个应用或服务仓库负责自己的源码、Dockerfile、配置示例、测试和构建命令。
config.yaml等运行时配置应保留在本地,不进入版本控制。- 功能开发应在所属仓库完成测试后再发布。