★ FEATURED ARTICLE 不写一行代码用 OpenMAIC 把一页 PPT 变成会互动的 AI 课堂10 分钟上手【免费下载链接】OpenMAICOpen Multi-Agent Interactive Classroom — Get an immersive, multi-agent learning experience in just one click项目地址: https://gitcode.com/GitHub_Trending/op/OpenMAIC在线课程的体验长期停留在一个根本性局限上视频在播放你可以暂停、倍速但课程本身是固定的。没有谁能回答你随时冒出的问题更不会有人针对你的理解水平调整讲解节奏。OpenMAICOpen Multi-Agent Interactive Classroom正是冲着这个痛点来的——这个由清华大学团队开源、采用 MIT 协议的 TypeScript 项目把课程生产与课堂运行合二为一你给它一个主题或一份材料它在几分钟内生成由 AI 老师与 AI 同学共同出演的沉浸式互动课堂全程不需要编写任何代码。本文不重复社区里流传的架构介绍而是沿着一条真实可走的路径从网页版输入主题开始跟踪每一次请求在仓库源码中的落点最后给你一份十分钟内可执行的验收清单。所有结论均来自当前仓库的实际代码你可以随时对照验证。网页版快速体验从输入主题到生成课堂的完整路径体验 OpenMAIC 最直接的方式是打开官方在线体验站点open.maic.chat按提示配置至少一个 LLM 提供方OpenAI、Anthropic、DeepSeek、Qwen、GLM、Ollama 等任一即可后进入首页。首页的核心是一个自由文本需求框所有关于主题、时长、风格的意图都写在这一段话里正如 UserRequirements 中requirement字段的注释所写——Single free-form text for all user input。提交后页面跳转到 app/generation-preview/page.tsx这里承载了从一句话到一间课堂的完整状态机。其核心方法startGeneration按序执行六个阶段每一阶段都会更新进度指示器素材解析若上传了文档先调用/api/extract-document抽取文本与图片联网检索可选若勾选了联网调用/api/web-search把检索结果压缩为researchContext作为后续生成的上下文补充大纲流式生成请求/api/generate/scene-outlines-stream通过 SSE 逐条推送大纲卡片同时推断课程语言与课程标题大纲审核大纲生成完毕后进入可编辑审核界面默认 2.5 秒无操作自动继续见OUTLINE_REVIEW_AUTO_CONTINUE_MS也可以中途点击流式卡片提前展开编辑器进行修改智能体生成在自动模式下调用/api/generate/agent-profiles由 LLM 依据大纲、可用头像列表与可用音色列表生成教师、同学等角色并以角色卡翻转的交互呈现确认后写入 stage场景生成与语音合成逐场景调用fetchSceneContent、fetchSceneActions生成内容与课堂动作随后为第一个场景生成 TTS 语音最后写入存储并跳转/classroom/[id]。这个流程中值得注意的设计是中途可介入。大纲以流式卡片呈现时用户点击卡片即可提前进入编辑态handleExpandStreamingOutlineSSE 仍在后台继续推送刷新页面后会话从sessionStorage恢复并能依据保存的previewPhase判断用户曾提前打开过编辑器这一意图避免在刷新后误触发自动继续。也就是说生成不是一次不可控的黑盒提交而是每一页结构都可以被确认或修改后才进入内容生成。把 PPT/文档丢进去两阶段内容管道如何处理素材OpenMAIC 对从文档出发的支持不是简单地把文件塞进提示词而是经过一条明确分层的两阶段管道。在 lib/types/generation.ts 的文件头注释中这条管道被定义得清清楚楚Stage 1用户需求 文档 → 逐页场景大纲Scene OutlinesStage 2场景大纲 → 完整场景slide / quiz / interactive / pbl含课堂动作。先看素材进入系统的方式。上传的文档在 app/api/extract-document/route.ts 统一处理支持 multipart 上传与服务端资产引用两种形式抽取器的选择则由 lib/document/extractors/registry.ts 按 MIME 类型完成系统内置了文本类txt/md 等与 PDF 类等多套 provider可在设置中指定首选解析服务。解析结果会经历三层约束见 lib/constants/generation.ts单文件大小上限 50MBMAX_EXTRACT_DOCUMENT_FILE_SIZE_BYTES正文进入模型前截断为 50,000 字符MAX_PDF_CONTENT_CHARS从文档中抽取的图片最多以 20 张进入视觉输入预算MAX_VISION_IMAGES每张图片带有visionPriority字段超出预算时按优先级取舍。随后所有解析结果通过buildDocumentBundle汇总为统一的 bundle——正文、图片及其来源文档归属信息一并写入会话图片存入 IndexedDB 或服务端资产池以imageMapping的形式供大纲与场景两个阶段按 id 引用。进入 Stage 1 后文档正文与图片、联网检索上下文、用户需求被一同送入大纲生成接口。SceneOutline结构lib/types/generation.ts为每个场景预留了类型slide/quiz/interactive/pbl、标题、目的描述、3-5 个要点、教学目的、预估时长以及针对不同场景的专属配置测验的题量与难度、交互组件的 widget 类型与关键变量、PBL 的项目主题与目标技能。文档中提取的图片还会以suggestedImageIds的形式被直接建议给对应的场景页。Stage 2 则把已确认的大纲逐个物化为完整场景先由内容接口生成幻灯片元素、测验题目或 PBL 项目载荷再由动作接口生成该场景下智能体要执行的教学动作序列。生成完成后课堂内的对话并非简单的你问我答而是由 lib/orchestration/director-graph.ts 中的 LangGraph StateGraph 驱动director节点决定下一位发言的智能体单智能体场景走纯代码逻辑零 LLM 调用多智能体场景则由 LLM 决策发言顺序并通过共享记忆与白板动作账本维持课堂连贯性。这段流水线最终产出的不只是一页静态 PPT 的替代品而是会说话、会提问、会画图、会模拟的互动课堂。十分钟验收清单课堂结构、互动点与角色配置生成完成后课堂跳转至/classroom/[id]。在正式使用前建议按下面这份清单在十分钟内完成验收它同时对应了仓库中每一层能力的真实实现。课堂结构是否完整。打开侧边栏或大纲视图核对每个场景的类型与顺序是否符合预期。一页 PPT 变成课堂后通常不应全是幻灯片应有穿插其间的测验quiz支持单选/多选/简答与难度配置、交互组件interactive或 PBL 环节。若你在需求中开启了交互模式课堂将以交互优先的方式生成这是 app/page.tsx 中interactiveMode开关的职责。互动点是否真的能动。交互场景对应一组 widget 类型——模拟、思维导图、3D 可视化、游戏与在线编程等其配置结构见 SceneOutline 的widgetType与widgetOutline字段。验收时建议实际操作一个模拟或 3D 场景确认参数可调、状态可观察。角色配置是否符合预期。在自动模式下角色由 LLM 依据大纲生成头像从仓库内置的 12 个角色形象中选取见 app/generation-preview/page.tsx 中的allAvatars列表并绑定你在全局设置的旁白音色若对自动生成不满意可在设置中切换到预置角色模式agentMode preset固定使用你选择的智能体组合。此外课堂内的 AI 同学会基于你填写的昵称与背景userNickname/userBio进行个性化提问这一点可以在首页需求表单中一并验证。听与说是否通畅。打开 TTS 开关后教师角色的讲解应有语音输出白板应能承载智能体的绘制动作。课堂聊天已支持引用幻灯片元素、交互组件或白板笔迹进行追问v1.1.0 起由 agent loop 驱动可以尝试在播放栏中点选一个元素提问验证老师读课件—查实验状态—联网检索的完整应答链路。收尾与沉淀是否可用。课程结束后应出现完成页测验状态可持久保存v0.2.1 起如需复用可从课堂导出可编辑的.pptx或可离线运行的.htmllib/export 目录下实现了完整的导出管线。这一步是把生成的课堂变成自己的教学资产的关键闭环。完成这五项检查你的第一堂课就通过了验收。从输入主题、确认大纲、翻转角色卡到课堂开讲整个过程没有任何一行代码——OpenMAIC 把多智能体编排、内容生成与课堂运行都收敛到了产品层而你只需要理解一条路径需求与素材进入两阶段管道产出结构化大纲大纲逐页物化为场景场景由智能体驱动运行。这也是它能够在教育场景里被快速落地的根本原因复杂度被封装进了管道而主动权留在了用户手里。【免费下载链接】OpenMAICOpen Multi-Agent Interactive Classroom — Get an immersive, multi-agent learning experience in just one click项目地址: https://gitcode.com/GitHub_Trending/op/OpenMAIC创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
