1       概述

1.1       案例介绍

EduSwarm 是一个基于多智能体框架构建的 AI 教师团队协作平台：把备课、上课、作业、批改、学情等教学环节，交给多位专职 AI Agent（课件师、出题官、批改师、学情分析师等）协作完成。教师从「亲力亲为」变成「做决策」，学生只需凭课堂码加入即可实时跟课。与「单 Agent 大而全」的思路不同，EduSwarm 遵循 「先拆角色 → 再定流程 → 最后配信号」 的多智能体设计原则：每个 Agent 只做自己最擅长的一件事，由 LEADER 教研组长统一调度，知识库按 Agent 隔离、互不越界。

1.2       核心价值

·开发侧：基于 jiuwenSwarm 二次开发，针对垂类场景，提供个性化多智能体协同方案。依托华为云 AI 开发者空间提供的工具链，零成本快速云上验证想法和可落地。

·教师侧：通过 EduSwarm 平台操作 Agent 做课团队实现课程、课件设计，老师作为决策角色，工作中心放在课程选题、授课，提高老师教学效率。

·学生侧：提供课堂互动、Agent答疑、课后作业答疑、提交，解决学生课堂知识点疑惑，来不及向老师提问，课后疑惑难找到讲解等问题。

1.1       案例流程

说明： 

1、登录华为云 AI 开发者空间拉起 AI SHELL
2、与 AI SHELL 会话 从GitCode 克隆项目
3、自然语言输入提示词完成 EduSwarm 部署

2 环境准备

2.1       前置条件

1、本案例用AI SHELL通过自然语言方式，在华为云上创建ECS等云资源安装部署EduSwarm 平台，需先注册华为云账号并完成实名认证。由于ECS等云资源按需计费，个人账户金额不能为0，需要在为账户充值1元作为保证金

2、保证金去向：若华为云账户中有云资源代金券可用于云资源消费抵扣，则保证金在释放创建的云资源24小时之内解冻后可提现；若华为云账户中无云资源代金券或代金券不可用于相关云资源的消费抵扣，则实际扣费个人账户资金（1元可能不够）。

备注：

充值中心

代金券查询

2.2     项目地址

AI 办公最佳实践

EduSwarm-AI智慧课堂工作台

2.3      如何免费获得华为云代金券

完成 AI 办公实践中心任务，即可获得积分，积分可在开发者成长中心可兑换代金券。

3       快速部署体验

3.1        快速开始

进入AI办公实践中心，找到「EduSwarm · AI 智慧课堂工作台」实践点击进入后打开 AI SHELL，将下方提示词发给 AI SHELL，自动完成云主机创建 + EduSwarm 容器部署，全程自动执行、无需逐步确认。

部署提示词：

帮我创建 ECS 并部署容器，全程自动执行（plan 通过后直接 apply，无需我确认），最后汇总各阶段耗时。

区域：cn-north-4

可用区：自动选择

计费模式：按需

ECS：s6.large.2（2vCPU/4GB），Ubuntu 22.04 server 64bit，40GB SAS 系统盘，5Mbit/s EIP

新建 VPC（192.168.0.0/16）和子网（192.168.0.0/24）

SSH 用户：root

SSH 密码：纯大小写字母+数字（不要特殊字符，避免 cloud-init 注入失败），至少 16 位

Docker：apt-get install -y docker.io docker-compose（用 Ubuntu 自带源，不要用 Docker 官方源，GPG 密钥在华为云 ECS 内可能无法验证）

镜像：swr.cn-north-4.myhuaweicloud.com/wsm/eduswarm:latest

容器启动：

docker run -d --name eduswarm --restart=always \

  -p 5173:5173 -p 18092:18092 -p 19000:19000 -p 19001:19001 -p 19200:19200 \

  swr.cn-north-4.myhuaweicloud.com/wsm/eduswarm:latest

安全组放行端口（TCP）：

22    SSH

5173  Web 前端（HTTP）

18092 AgentServer（WebSocket）

19000 WebChannel（WebSocket）

19001 Gateway（WebSocket）

19200 edu REST 网关

验证：curl http://<EIP>:5173 返回 HTTP 200

耗时统计：Terraform apply、Docker 安装、镜像拉取、容器启动、总耗时

1、在 AI 办公实践中心，找到实践体验模块并选择 AI 智慧课堂工作台实践案例 > “前往AI DevSpace实践”。

2、进入 AI DevSpace 找到并打开 AI SHELL，将对话框左下方的 mode 修改为 Auto后，在会话框输入前面提供的部署提示词，即可开始 EduSwarm 安装部署。

3、部署完成后，浏览器打开 http://<云主机IP>:5173 进入 EduSwarm 教师端工作台（学生同地址输课堂码加入），体验 AI 课程团队教学制作与授课。

4、进入 EduSwarm 界面并完成模型配置

4  EduSwarm实践体验

4.1        EduSwarm介绍

平台架构：

教学 Agent 团队：全部教学 Agent 自动使用工作台配置的主模型，可在 Agent 配置中心单独覆盖模型/人设/知识库/挂载 Skill。

4.2        EduSwarm使用

1、对话测试

配置好模型后打开一个会话任务，发送“你好”测试平台是否正常。

2、使用教学Agent团队完成《数据结构基础》课程设计。

讲会话模式切换为“集群模式”后输入以下提示词：

请基于仓库https://gitcode.com/agent-best-practices/eduSwarm.git中的《教案_数据结构.md》，帮我做《数据结构基础》单元教学闭环：教案+课件+习题+配套作业。

3、教学Agent团队执行完任务后会输出4个课程设计文件

可继续让AI帮你把输出的课程文件制作为课件

4、创建班级&添加学生

 点击创建的班级，完成学生添加

5、创建课堂

6、开始上课

·进入课堂管理，获得课堂码
·为学生提供课堂链接和课堂码
·学生输入课堂码等信息进入课堂
·老师进入课堂后点击进行上课

进入课堂管理，获得课堂码

学生端使用课堂码、学号、姓名等信息进入课堂

开始上课

课堂辅助答疑

随堂测试

课堂总结

5        释放云资源

案例体验完成后，给 AI SHELL 发送如下提示词释放创建的云资源，避免持续扣费。

提示词：“帮我释放今天创建的所有云资源”

6  问题&建议反馈

1、实操故障或优化建议，可在项目中通过issue提交，我方将及时跟进处理，同时欢迎一起共创此案例。

2、欢迎提供垂类应用场景问题，加入我们一起共创。

3、更多实践请访问AI办公最佳实践仓库 OR AI办公实践中心