多Agent协作实战:用WorkBuddy把散装资料变成教案与教学PPT 备课这件事最折磨人的从来不是没东西可讲而是东西太多、太散、太乱。我手上就有一门课的完整资料三份不同版本的讲义、两套往届学生的作业反馈、一堆从各处收集的案例截图、还有几段自己录的语音备忘。这些东西单看都有价值但真到要出一份正式教案和一套能直接投屏的教学 PPT 时你会发现它们像一桌没收拾的散装零件——你知道它们能拼成一台机器但每次动手都得从头翻一遍。WorkBuddy 这类多 Agent 协作工具真正吸引我的地方就是它能把整理散装资料这件重复劳动接过去让我把精力留在教学设计和内容取舍上。这篇就聊聊我怎么用 WorkBuddy 把一门课的散装资料一步步变成结构清晰的教案和能直接上课的教学 PPT中间踩过的坑、调过的规则、以及那些文档里不会写的实操细节我都会摊开讲。1. 先搞清楚 WorkBuddy 到底替我干了哪部分活很多人第一次接触 WorkBuddy会下意识把它当成一个更聪明的对话框输入一段话等它吐出一份文档。这个理解会让你用得很憋屈因为它真正的价值不在单次问答而在多 Agent 协作——也就是把一个大任务拆成几个角色让它们各管一段、互相衔接。放到备课这个场景里这个特性刚好对得上。1.1 备课任务的天然可拆解性备课这件事拆开来看其实是几个相对独立的子任务内容提取从散装资料里捞出知识点、结构编排决定先讲什么后讲什么、课时怎么分配、教案撰写教学目标、重难点、教学过程、板书设计、PPT 生成把教案转成视觉化的页面。这四个子任务之间有依赖关系但每个子任务内部的逻辑是自洽的。传统做法是我一个人从头串到尾脑子在提取和编排之间反复横跳效率极低。WorkBuddy 的多 Agent 模式允许我把这几个环节分给不同的 Agent每个 Agent 专注自己那一段我只需要在关键节点做审核和调整。这就像装修房子你不需要一个工人既砌墙又刷漆又装水电分工之后每个环节的质量反而更可控。1.2 三个核心 Agent 的角色划分在实际操作中我习惯把 WorkBuddy 的工作流拆成三个角色这也是多 Agent 协作最常见的配置思路资料整理 Agent负责读取我丢进去的散装资料做去重、归类、知识点提取。它的输出是一份知识点清单而不是成稿。教案生成 Agent拿知识点清单作为输入按照教学逻辑编排成教案结构补全教学目标、重难点分析、教学过程设计。PPT 生成 Agent把教案里的核心内容转成 PPT 大纲再逐页生成标题、要点、备注。这里有个关键点不要让一个 Agent 从头干到尾。我试过让单个 Agent 直接读资料出教案结果它会把资料里的原话大段照搬结构也很平因为它没有先整理再编排的中间步骤。拆成三个角色后每一步的输入都更干净输出质量明显不一样。1.3 为什么不是一个提示词解决所有问题有人会问我写一个超长的提示词把要求全塞进去不也能出结果吗能出但不可控。备课这种任务资料量一大单次提示词根本装不下所有上下文Agent 会开始脑补或者遗漏。而多 Agent 协作的本质是把长上下文压力分散到多个短上下文环节每个环节只处理自己那部分信息准确率自然高。提示如果你刚开始用 WorkBuddy别急着上多 Agent。先用单 Agent 跑一遍完整流程感受一下它在哪一步开始力不从心那个卡点就是你该拆分的地方。2. 散装资料进 WorkBuddy 之前的预处理我踩过的第一个大坑就是直接把一堆格式混乱的文件全丢进去。结果 Agent 花大量精力在读懂文件上真正用于整理知识点的算力被挤占输出质量惨不忍睹。后来我总结出一套预处理流程虽然多花十分钟但后面省下的返工时间是以小时计的。2.1 文件格式的统一与清洗散装资料最大的问题是格式不统一有的是 Word有的是 PDF有的是我随手记的纯文本还有几张截图。WorkBuddy 对纯文本和结构化文档的处理效果最好对图片里的文字识别则依赖 OCR 质量容易出错。我的做法是先把所有资料转成纯文本或 Markdown。Word 和 PDF 直接导出为文本截图里的关键信息我手动敲一遍——别嫌麻烦这几分钟的输入质量直接决定后面 Agent 的理解准确度。转换时注意保留标题层级比如用#、##标记章节这样 Agent 能识别出内容的结构关系。# 第一章 课程导论 ## 1.1 课程定位 本课程面向零基础学员... ## 1.2 学习目标 - 掌握基本概念 - 能独立完成简单实操这种带层级的纯文本比一大坨没有格式的文字Agent 处理起来顺畅得多。2.2 给资料打标签而不是一股脑全塞第二个坑是信息过载。我一开始把所有资料合并成一个大文件丢进去Agent 提取知识点时会把往届作业反馈、我的语音备忘、正式讲义混在一起分不清哪些是要教的内容哪些是教学参考。后来我改成分类投喂把资料分成核心教学内容案例素材教学反馈三类分别打上标签。核心教学内容是必须进教案的案例素材是可选补充教学反馈用来调整重难点。这样 Agent 在提取时就有了优先级判断不会把学生的一句吐槽当成知识点。资料类型处理方式在流程中的作用核心讲义转 Markdown保留层级知识点提取的主要来源案例素材单独成文件标注适用章节教案中的举例补充教学反馈汇总成要点列表辅助判断重难点语音备忘转文字后精简补充个人教学意图2.3 明确告诉 Agent 不要做什么这一步很多人会忽略。我在给资料整理 Agent 的指令里除了说提取知识点还会明确写不要改写原文表述不要添加资料中没有的内容遇到重复内容只保留最完整的一版。这几条约束看起来简单但能极大减少 Agent 的自由发挥。实测下来不加约束时Agent 会自作主张地把知识点润色一遍结果专业术语被改得面目全非。加上保持原表述的约束后提取结果的可信度明显提升。这跟带新人是一个道理你不说清楚边界他就会按自己的理解来。3. 从知识点清单到教案编排逻辑才是灵魂资料整理完得到一份知识点清单接下来就是把它变成教案。这一步是整条链路里最考验教学理解的环节也是 WorkBuddy 最需要我介入调整的地方。Agent 能帮你把内容排好但为什么这样排必须由你把关。3.1 教案生成 Agent 的输入该怎么组织教案生成 Agent 的输入不只是知识点清单还要包含课程的基本约束总课时、每课时时长、学员基础、教学目标。这些信息决定了内容怎么分配。我通常这样组织输入【课程约束】 - 总课时8 课时每课时 45 分钟 - 学员基础零基础无相关经验 - 教学目标能独立完成基础实操理解核心概念 【知识点清单】 此处粘贴整理好的知识点 【编排要求】 - 按概念-原理-实操-练习的顺序组织 - 每课时聚焦 2-3 个核心知识点 - 重难点单独标注把约束和内容分开写Agent 更容易理解哪些是硬性条件哪些是待编排的素材。3.2 教学过程的四段式结构教案的核心是教学过程这一块。我让 Agent 按四段式来组织每一课时导入、讲解、实操、小结。这个结构不是我拍脑袋定的而是教学实践里验证过最稳的节奏。导入用一个问题或案例引出本课主题抓住注意力。Agent 会从案例素材里挑合适的例子。讲解把核心概念和原理讲清楚这是知识传递的主体。实操让学员动手把知识转成技能。这一步要写清楚操作步骤和预期结果。小结回顾本课要点布置练习。我试过让 Agent 自由发挥结构结果它把实操和讲解混在一起学员根本跟不上。固定成四段式后每课时的节奏就清晰了我审阅时也只需要看每个段落是否到位。3.3 重难点标注别让 Agent 替你判断这里有个我踩过的坑一开始我让 Agent 自己判断哪些是重难点结果它把概念定义标成难点把真正需要反复练习的实操步骤标成重点完全反了。原因很简单Agent 没有真实的教学经验它只能根据文本的复杂度来判断而不是根据学员的认知难度。后来我改成自己先标注重难点再让 Agent 围绕重难点组织内容。比如我会在知识点清单里直接写【难点】XX 操作的参数配置容易混淆Agent 就会在教案里给这个点分配更多讲解时间和练习环节。这个顺序不能反教学判断是人的活Agent 只负责执行。注意重难点标注最好用统一的标记符号比如【重点】【难点】Agent 识别起来更准确也方便你后续检索。4. 教案转教学 PPT不是复制粘贴那么简单教案写好了接下来是生成教学 PPT。很多人以为这一步就是把教案内容搬到幻灯片上如果你真这么干出来的 PPT 会密密麻麻全是字投屏后学员根本看不清。教案和 PPT 是两种不同的媒介转换时需要做信息降维。4.1 教案与 PPT 的信息密度差异教案是给老师看的可以写得很细一段教学过程写几百字都正常。PPT 是给学员看的一页幻灯片上的文字最好控制在 50 字以内核心是关键词 视觉辅助。我让 PPT 生成 Agent 处理时会明确要求它做三件事提炼关键词把长句压缩成短语、拆分页面一个知识点一页不堆叠、补充备注把教案里的详细讲解放到 PPT 的备注区供我讲课时参考。这样出来的 PPT页面上干净但备注里有完整讲稿两不耽误。4.2 页面结构的固定套路教学 PPT 的页面结构其实有规律可循。我让 Agent 按几种固定版式来生成封面页课程名、课时标题、讲师信息目录页本课时的几个核心知识点概念页一个概念 一句解释 一个例子步骤页操作步骤用编号列表每步一行对比页用表格对比易混淆的概念小结页本课要点回顾固定版式的好处是Agent 生成时不会跑偏我审阅时也能快速定位问题。实测下来用固定版式生成的 PPT比让 Agent 自由发挥的版本可用率高出很多。4.3 备注区才是 PPT 的灵魂这一点我要重点说。很多人做教学 PPT 只关注页面上显示什么忽略了备注区。但备注区才是老师上课时的提词器。我让 Agent 把教案里讲解和实操部分的详细内容全部写进对应页面的备注区。具体做法是在指令里写清楚每页 PPT 的备注区填入该页对应的教案讲解内容保持完整不要精简。这样我上课时页面投给学员看的是关键词我自己看的是备注里的完整讲稿节奏完全可控。PPT 区域内容面向对象页面主体关键词、图示、步骤学员备注区完整讲解、案例细节讲师标题本页主题双方5. 多 Agent 协作时的衔接与规则设定前面讲了三个 Agent 各自怎么干活但真正决定效率的是它们之间怎么衔接。衔接不好你会在复制粘贴上浪费大量时间多 Agent 反而比单 Agent 更累。5.1 用统一的数据格式串起三个环节我的做法是定义一个中间格式让每个 Agent 的输出都符合这个格式下一个 Agent 直接拿过来就能用。比如资料整理 Agent 输出的知识点清单统一用这样的结构知识点XXX 类型概念 / 原理 / 实操 难度基础 / 进阶 关联案例XXX 备注XXX教案生成 Agent 读这个格式PPT 生成 Agent 也读这个格式。格式统一了环节之间就不需要人工转换直接传递即可。这一步的投入产出比极高值得花时间设计。5.2 给 WorkBuddy 定几条全局规则WorkBuddy 支持设定全局规则让后续所有任务都生效。我给自己配了几条实测很省心术语一致性所有输出中专业术语必须与原始资料保持一致不得自行替换。不编造内容任何 Agent 都不得添加资料中没有的事实性内容需要补充时标注待确认。输出格式所有结构化输出使用 Markdown标题层级不超过三级。语言风格教案和 PPT 使用简洁的书面语不使用口语化表达。这几条规则一设后面每个任务都不用重复交代Agent 会自动遵守。这就像给团队定了工作规范新人来了照着做就行。5.3 人工审核卡点设在哪里多 Agent 协作不等于全自动。我在流程里设了两个强制审核卡点一个是知识点清单出来后我检查有没有遗漏或错误另一个是教案出来后我检查教学逻辑和重难点标注。PPT 生成后我只做快速浏览因为它的内容来源于已审核的教案出错概率低。把审核卡点设在信息转换的环节而不是信息生成的环节效率最高。因为转换环节最容易出错而生成环节只要输入干净输出通常没问题。6. 实测中那些文档不会写的坑讲完了流程最后聊聊实操中真正让我头疼的几个问题。这些坑官方文档不会写只有自己踩过才知道。6.1 长文档处理时的记忆丢失当资料量特别大时Agent 处理到后面会忘记前面的内容导致知识点提取不完整。我的解决办法是分段处理把资料按章节切成几块每块单独提取知识点最后再合并。虽然多几步操作但完整性有保障。另一个技巧是在每段处理时把前面已提取的知识点简要列表附在指令末尾提醒 Agent这些已经提取过了不要重复。这个记忆锚点能有效减少重复和遗漏。6.2 生成内容的过度润色Agent 有个通病喜欢把简单的话说复杂。教案里本来一句点击按钮完成设置就够了它非要写成通过点击相应按钮以完成相关参数的配置操作。这种过度润色在教案里是灾难学员看着累。我的对策是在规则里明确写能用短句就不用长句能用动词就不用名词化表达。另外审阅时专门抓这类注水表述发现就改。改几次之后Agent 的输出风格会逐渐向你的偏好靠拢。6.3 PPT 版式在不同软件里的兼容问题Agent 生成的 PPT 大纲导入到实际软件里时版式可能会乱。我的经验是让 Agent 只生成内容大纲版式在软件里套模板。具体来说Agent 输出每页的标题、要点、备注我用软件自带的模板批量套用这样既保证了内容质量又避免了版式兼容问题。如果你需要特定版式可以在指令里描述清楚比如每页标题居中要点左对齐不超过五行但别指望 Agent 直接生成完美的成品文件把它当成内容生成器而不是排版工具心态会好很多。6.4 关于缓存目录和本地化的一些实操有朋友问过 WorkBuddy 的系统缓存目录能不能改到其他盘这个在设置里是可以调整的把缓存目录指向空间充足的盘符能避免处理大文件时因为系统盘空间不足而中断。另外本地化部署的场景下首次运行需要预留足够的磁盘空间给模型文件这个在安装前最好先确认一下。至于跨对话记忆我的建议是重要规则和常用格式写进全局规则里而不是依赖单次对话的记忆。全局规则是持久的单次对话的记忆是临时的把该固化的东西固化下来才能保证每次输出的稳定性。7. 一套完整流程跑下来是什么体验把上面这些串起来我现在处理一门新课的备课流程大概是这样先把散装资料转成带层级的纯文本分类打标签然后丢给资料整理 Agent拿到知识点清单人工审核一遍接着把清单和课程约束交给教案生成 Agent出来教案后审核教学逻辑最后把教案交给 PPT 生成 Agent拿到页面大纲和备注套模板出成品。整个过程我的角色从从头写到尾的苦力变成了审核和决策的把关人。省下来的时间我可以用来打磨案例、设计互动环节这些才是真正影响教学效果的部分。WorkBuddy 这类工具的价值不是替你思考而是替你处理那些重复的、机械的整理工作让你把脑力用在刀刃上。我个人的体会是多 Agent 协作的磨合期大概在两到三次完整任务之后一旦规则和格式稳定下来后面的效率提升是指数级的。第一次用可能会觉得还不如自己写快但坚持把规则调顺第三门课开始你就会明显感觉到差别。工具是死的怎么用是活的把流程设计好它才真正成为你的备课搭子。