FixSystem Agent — 校园智能报修系统多 Agent 协同平台

基于 WorkSwarm 多智能体框架构建，6 个专业 Agent 协同完成校园报修全流程：意图识别 → 任务分解 → 专业 Agent 执行 → 结果汇总。学生用自然语言报修、管理员对话式派单、工人获取维修知识辅助。

---

✨ 项目亮点

• ✅ 内置华为云 AI 开发者空间 便捷启动入口
• ✅ 6 个专业 Agent 协同，覆盖报修全流程（报修→派单→维修→评价→预警）
• ✅ 内置 Python Mock 后端（SQLite），无需 Java / MySQL / Redis，开箱即用
• ✅ 对话式 Web 界面，自然语言交互，三种角色一键切换
• ✅ 云上一键部署，零成本体验

---

🚀 快速部署【一键部署｜推荐】

在 华为云 AI 开发者空间 中执行以下步骤，拉起 WorkSwarm：

1. 进入 华为云 AI 开发者空间
2. 左侧点击 WorkSwarm 进入

💡 悄悄告诉你福利入口：云上一键安装运行 WorkSwarm，可白嫖 Token，零成本体验整套多智能体案例！

自动部署指令（WorkSwarm 性能模式对话框输入）：

任务：读取 https://gitcode.com/agent-best-practices/fix-system-agent.git 代码仓内容，参考「FixSystem Agent — 快速部署指南」，在当前 WorkSwarm 中配置相同的 FixSystem 智能报修系统。
要求：
1. 将 Skills/ 目录下的 6 个 Skill 复制到全局技能目录
2. 将 config_team.yaml 内容合并到 config/config.yaml 的 modes.team 段
3. 启动 mock_backend.py（Mock 后端，port 7758）和 web/server.py（Web 界面，port 8080）
4. 所有 Agent 模型统一使用当前已配置的主模型

---

📢 项目动态预告

后续将会持续迭代更新：

• 新增更多校园场景 Agent（如巡检 Agent、耗材预警 Agent）
• 接入飞书/钉钉渠道，在 IM 中直接对话报修
• 定时巡检：WorkSwarm 定时任务每天自动检查设备健康
• 维修照片识别：接入多模态模型，学生上传照片自动识别故障类型

如果你觉得项目有用，欢迎点击仓库右上角 ⭐ 小星星 Star！ 持续关注仓库动态，新版本、新功能更新不迷路。

---

目录结构

fix-system-agent/
├── README.md                              # 项目说明（本文件）
├── FixSystem Agent — 快速部署指南.md        # 完整部署步骤，支持丢给 WorkSwarm 自动配置
├── FixSystem Agent — 经验分享.md            # 架构设计思路、多 Agent 协同经验
├── config_team.yaml                       # 团队配置片段（合并到 config.yaml）
├── LICENSE                                # Apache-2.0
├── .gitignore
├── Skills/                                # 6 个 Agent 的 Skill 定义
│   ├── repair-orchestrator/               # ① 报修调度总控 (Leader)
│   │   ├── SKILL.md
│   │   └── scripts/
│   │       └── fixsystem_api.py           # 共享 API 客户端（73个端点）
│   ├── repair-intake-agent/               # ② 报修受理员
│   │   └── SKILL.md
│   ├── dispatch-agent/                    # ③ 智能派单员
│   │   └── SKILL.md
│   ├── analytics-agent/                   # ④ 数据分析员
│   │   └── SKILL.md
│   ├── equipment-monitor-agent/           # ⑤ 设备监控员
│   │   └── SKILL.md
│   └── knowledge-agent/                   # ⑥ 维修知识员
│       ├── SKILL.md
│       └── references/
│           └── repair_knowledge.md        # 维修知识库（7类设备）
├── web/                                   # 对话式 Web 界面
│   ├── server.py                          # Python aiohttp 后端（WebSocket 代理）
│   └── static/
│       ├── index.html                     # Vue 3 前端
│       ├── styles.css                     # 样式
│       └── app.js                         # 应用逻辑
├── mock_backend.py                        # Python Mock 后端（SQLite + 内存，替代 Java+MySQL+Redis）
├── install.ps1                            # Skill 安装脚本
└── start.ps1                              # 一键启动脚本

---

多 Agent 架构

                         用户 (自然语言对话)
                              │
                              ▼
                 ┌────────────────────────┐
                 │  repair-orchestrator   │  报修调度总控 (Leader)
                 │  唯一对用户说话的 Agent  │  意图识别 → 任务分解 → 结果汇总
                 └───────────┬────────────┘
                             │ 分派任务（一次只激活一个）
           ┌────────┬────────┼────────┬────────┐
           ▼        ▼        ▼        ▼        ▼
      ┌────────┐┌───────┐┌───────┐┌───────┐┌───────┐
      │报修   ││派单   ││数据   ││设备   ││维修   │
      │受理员 ││员     ││分析员 ││监控员 ││知识员 │
      │       ││       ││       ││       ││       │
      │故障分类││工人推荐││统计查询││健康检查││排查步骤│
      │创建订单││分配执行││趋势分析││预警报告││工具建议│
      └───┬───┘└───┬───┘└───┬───┘└───┬───┘└───┬───┘
           │        │        │        │        │
           └────────┴────────┼────────┴────────┘
                              │ bash 工具调用
                              ▼
                     fixsystem_api.py (73个API端点)
                              │ HTTP
                              ▼
                     Mock 后端 (port 7758)
                     SQLite + 内存

六个 Agent 职责

Agent	成员名	职责	工具权限
报修调度总控 (Leader)	repair-orchestrator	意图识别、任务分解、唯一对用户说话、上下文记忆	bash
报修受理员	repair-intake-agent	解析故障描述、自动分类、创建报修单	bash
智能派单员	dispatch-agent	多因素评分推荐工人、执行分配	bash
数据分析员	analytics-agent	统计查询、趋势分析、异常检测	bash
设备监控员	equipment-monitor-agent	设备健康检查、风险分级、预警报告	bash
维修知识员	knowledge-agent	查询维修知识库、排查步骤、工具建议	bash

所有 Agent 统一使用 bash 工具，通过 fixsystem_api.py 脚本访问后端 73 个 API。维修知识员用 bash cat 命令读取知识库文件。

协作流程

用户: "3栋301空调不制冷了"
  │
  ▼
Leader: [识别为报修意图] → [激活 repair-intake-agent，传入完整上下文]
  │
  ▼
repair-intake-agent: [获取故障类别列表] [匹配"空调"] [提取地址"3栋301"]
  │ 返回: {faultClass:"空调", address:"3栋301", details:"空调不制冷"}
  ▼
Leader: [向用户确认] "确认提交报修单吗？"
  │
  ▼
用户: "确认"
  │
  ▼
Leader: [再次激活 repair-intake-agent 执行创建]
  │
  ▼
repair-intake-agent: [调用 create-order] → 返回: {fixTableId:5}
  │
  ▼
Leader: "报修单已创建！单号: 5"

---

三种角色 × 五大能力

能力	学生	工人	管理员
智能报修	✅ 自然语言下单	—	✅
智能派单	—	—	✅ 推荐+分配
数据查询	✅ 查看自己的订单	✅ 查看任务	✅ 全部统计
设备预警	—	—	✅ 健康检查
维修知识	—	✅ 排查指导	—

测试账号

角色	账号	密码
管理员	A001	123456
学生	20201103123	123456
工人	W001	123456

---

快速开始

1. 克隆本仓库到本地
2. 安装 WorkSwarm，配置模型 API
3. 将 Skills/ 目录下的 6 个 Skill 复制到全局技能目录
4. 将 config_team.yaml 内容合并到 config.yaml
5. 启动 Mock 后端 + Web 界面：.\start.ps1
6. 浏览器打开 http://localhost:8080

详见 FixSystem Agent — 快速部署指南.md

---

文档

文档	说明
快速部署指南	完整部署步骤，支持丢给 WorkSwarm 自动配置
多 Agent 协同经验分享	架构设计思路、单 Agent 到多 Agent 的重构决策、踩坑经验

技术栈

组件	技术
Agent 框架	WorkSwarm（多 Agent 团队协作）
Mock 后端	Python aiohttp + SQLite（替代 Java Spring Boot + MySQL + Redis）
Web 后端	Python aiohttp + websockets（WebSocket 代理到 Agent）
Web 前端	Vue 3 (CDN) + marked.js + highlight.js
通信协议	HTTP REST + WebSocket (E2A)
知识库	Markdown（7类设备维修指南）

🤝 交流共建

欢迎提交 Issue 反馈问题，欢迎 Fork 进行二次拓展，优质创意方案欢迎发起 PR 合并。

---

相关链接

• WorkSwarm 框架：https://gitcode.com/openJiuwen/jiuwenswarm

License

Apache License 2.0

---

FixSystem Agent v1.0 | 2026-08