# jcold **Repository Path**: cylc1002/jcold ## Basic Information - **Project Name**: jcold - **Description**: 基于AgentScope的企业级Agent管理平台 基于 AgentScope Java 2.0 的公司级（多部门）Agent 平台完整设计方案 + 可交互界面设计 + 已落地的 MySQL 数据库 技术底座参考官方项目 agentscope-builder（《AgentScope Java 2.0 Builder 实战》），在其基础上补齐企业治理层 - **Primary Language**: Java - **License**: Apache-2.0 - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-09-28 - **Last Updated**: 2026-09-28 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Agent 智能体平台（jcold）· 设计交付包 > 基于 **AgentScope Java 2.0** 的公司级（多部门）Agent 平台完整设计方案 + 可交互界面设计 + 已落地的 MySQL 数据库 > 技术底座参考官方项目 agentscope-builder（《AgentScope Java 2.0 Builder 实战》），在其基础上补齐企业治理层 --- ## 📁 交付物清单 ``` workplace-agentscope/ ├── docs/ # 设计文档（5 份） │ ├── 01-总体设计方案.md # 定位、用户画像、功能地图与清单（含智能编排）、生命周期、非功能需求 │ ├── 02-技术架构方案.md # 技术选型、控制面/执行面分离架构、AgentScope 集成映射、 │ │ # 模型网关、RAG 管道、智能编排引擎、K8s 部署、安全设计 │ ├── 03-权限与组织模型设计.md # RBAC + 数据权限 + 资源可见域三层模型、7 个内置角色、 │ │ # 角色×功能权限矩阵、发布审批流、部门配额、审计留存 │ ├── 04-数据模型设计.md # MySQL 8.0 表结构（jcold 库 32 张表，已建表落地）、 │ │ # 向量存储与混合召回方案、基线数据说明 │ └── 05-API接口设计与实施路线图.md # REST API 全清单（含编排 flows API）、SSE 对话事件协议、 │ │ # 错误码、三期实施路线图（一期 6 周逐周拆解）、风险对策 ├── sql/ # 数据库脚本（已在本机 MySQL 8.0.28 执行） │ ├── V1__init_schema.sql # 建库 jcold + 32 张表（含智能编排 wf_ 域、用量月分区） │ └── V2__baseline_data.sql # 基线数据：组织/角色/权限点/账号/模型/MCP/智能体/编排/配额 └── prototype/ # 界面设计（纯静态，无外部依赖） ├── index.html # 16 个页面 + 6 个弹窗 ├── styles.css # 设计系统（企业蓝主色，可换肤） └── app.js # 导航/Tab/弹窗/工具审批交互脚本 ``` ## 🚀 如何查看界面设计 **直接双击打开 `prototype/index.html`**（Chrome / Edge，建议 1440×900 以上窗口）。 | 页面 | 内容 | |---|---| | 工作台 | 平台公告、快捷入口、待办审批、最近会话 | | Agent 市场 / 我的智能体 | 在售智能体、状态标签（草稿/调试中/待审核/已发布/已下线）、可见域 | | **创建智能体** | 分步向导 + 6 个配置页签（模型/提示词/MCP/Skills/知识库/高级）+ 右侧调试对话（工具审批可点击交互） | | **智能编排** | 图形化画布（节点面板/连线分支/节点属性面板）、编排列表、AI 生成编排与新建编排弹窗 | | MCP 服务管理 | 健康巡检、传输方式、工具危险分级；「注册 MCP 服务」弹窗 | | Skills 管理 | 技能包版本、安全扫描状态、SKILL.md 预览、上架审核要求 | | 知识库 | 文档索引状态、分块参数、检索测试面板（相似度分数） | | 模型管理 | DeepSeek 开放平台 / 智谱AI 开放平台接入卡、模型清单（deepseek-v4-flash 默认对话、glm-5.3-flash、embedding-3 默认向量） | | 用量统计 | 调用趋势、模型占比、部门配额进度、Top5 排行 | | 操作日志 | 操作/工具调用/登录三类审计 | | 用户 / 角色权限 / 部门管理 | RBAC 权限点树、数据权限范围、部门配额表单 | | 文档中心 | 文档树 + 操作手册（含 OpenAPI 调用代码） | | 登录 | SSO 单点登录 + 域账号双入口（侧边栏底部箭头可退出查看） | ## 🗄️ 数据库（已在本机执行） - 连接：`mysql -uai_agent -p -h127.0.0.1`（MySQL 8.0.28） - 已创建数据库 **jcold**（utf8mb4），32 张表，覆盖：组织权限、审计、智能体、智能编排（wf_）、MCP、Skills、知识库、模型、统计 9 个域 - 基线数据含：月夜烛峰（超级管理员）等 7 个账号、7 个内置角色、34 个权限点、 deepseek-v4-flash（默认对话模型）/ glm-5.3-flash / embedding-3（默认向量模型）、 3 个 MCP 服务及工具、6 个已上线智能体（含版本快照）、2 个智能编排（含 DSL 版本）、6 个部门配额 - 重建方式：先执行 `sql/V1__init_schema.sql`，再执行 `sql/V2__baseline_data.sql` ## 🧭 需求对应关系 | 需求 | 承载 | |---|---| | 操作文档说明查看 | 文档中心（手册/指南/OpenAPI 渲染） | | Agent 在线创建 | 智能体中心（向导式创建 + 在线调试 + 发布审批） | | MCP 在线创建 | 资源中心（注册/工具发现/健康巡检/危险分级） | | Skills 在线管理 | 资源中心（上传/扫描/版本/审核/引用统计） | | 知识库在线维护 | 资源中心（上传/解析分块/向量化/检索测试） | | 模型管理 | 资源中心（deepseek-v4-flash / glm-5.3-flash 接入、密钥托管、配额、白名单） | | 用量统计 | 统计运营（大盘/部门维度/成本分摊/导出） | | 操作日志 | 统计运营（配置审计/工具调用审计/登录日志） | | 权限/角色/用户管理 | 系统管理（RBAC + 数据权限 + 部门树 + 配额） | | **Agent 编排** | 智能体中心（图形化画布 + DSL 版本化 + AI 辅助生成 + 调试运行） | ## 🏗️ 技术方案一句话概览 **控制面（管理）与执行面（AgentScope Runtime）分离**：管理配置存 MySQL 并以版本化 JSON 快照固化；执行面按快照动态构建 HarnessAgent（默认对话模型 deepseek-v4-flash，全部调用走统一模型网关 + MCP 工具池 + Skills 沙箱 + MySQL 混合召回知识库 + Redis 会话记忆），智能编排按 DSL 驱动多节点流程，工具调用经平台审批网关拦截，用量事件异步汇聚成部门级报表与配额管控。一期模块化单体（Docker Compose）起步，推广期拆分执行服务上 K8s 水平扩容。 ## 📌 落地建议（Next Steps） 1. 按文档 05 的一期拆解启动：W1 脚手架 + IAM → W3 模型网关 → W4 Agent Runtime（HarnessAgent 动态构建）； 2. 数据库基线已就绪，工程侧直接引入 Flyway 并以 `sql/V1、V2` 作为基线脚本； 3. 选 2~3 个种子部门（IT 客服 / HR 问答 / 报销助手）共建首批场景，以见效带推广； 4. 界面设计可直接交给前端按 Ant Design 5 还原（配色与布局 token 已在 `styles.css` 中定义）。