1. 备课这件事为什么值得用 WorkBuddy 重新做一遍如果你教过课或者做过企业内训你一定经历过这种场景手头有一堆散装资料——几篇论文、几份行业报告、几页教材扫描件、自己以前写的零散笔记、还有从各种渠道收集来的案例素材。这些东西单独看都有价值但要把它们整合成一份结构完整的教案再做成能直接上课用的教学 PPT中间的工作量足以让人崩溃。我自己就经历过这个阶段。上学期接了一门新课手头的资料大概有二十多个文件格式五花八门有 PDF、有 Word、有 Markdown甚至还有几张拍下来的纸质笔记照片。按照以前的习惯我得先通读一遍所有材料在脑子里建立知识框架然后手动写教案大纲再一页一页做 PPT。整个过程保守估计要花两到三天而且中间还容易漏掉重要内容。后来我开始用 WorkBuddy 来做这件事准确地说是用它的多 Agent 协作能力来拆解备课流程。效果怎么样原本两三天的工作量压缩到了半天以内而且产出的教案结构比我手动整理的还要完整。这篇文章就把我整个实操过程拆开来讲从资料整理、Agent 配置、教案生成到 PPT 输出每一步都给出可以直接复现的方案。WorkBuddy 是什么简单说它是一个支持多 Agent 协作的工作台工具你可以把它理解成一个能同时调度多个虚拟助手的平台。每个 Agent 可以负责不同的任务比如一个负责提取资料要点一个负责组织教学逻辑一个负责生成 PPT 大纲。它们之间可以传递信息、协同工作。对于备课这种涉及多个环节、多种输出格式的任务来说这种多 Agent 协作的模式特别合适。这篇文章适合谁看如果你是需要备课的老师、培训师、企业内训负责人或者任何需要把零散信息整合成结构化教学内容的人这套方法都能直接拿去用。即使你之前没用过 WorkBuddy跟着步骤走也能上手。2. 整体设计思路为什么用多 Agent 而不是一个大模型搞定2.1 单模型处理的瓶颈在哪里很多人第一反应是我直接把所有资料丢给一个大模型让它帮我写教案不就行了我试过效果不理想。原因有三个。第一资料太多会超出上下文窗口。我那二十多个文件加起来大概有十几万字一次性塞进去模型要么截断要么开始遗忘前面的内容。第二单一模型处理多任务时容易串味。你让它既提取要点又组织教案还生成 PPT 大纲它往往会把三个任务的风格混在一起教案写得像 PPT 备注PPT 大纲又带着教案的啰嗦。第三缺乏中间校验环节。一次性输出的东西你很难定位到底是哪一步出了问题改起来只能整体重来。2.2 多 Agent 拆解的核心逻辑WorkBuddy 的多 Agent 协作恰好解决了这三个问题。我的设计思路是这样的Agent 1 负责资料预处理把不同格式的文件统一转成纯文本提取核心要点按主题分类。这个 Agent 只做一件事就是读懂材料。Agent 2 负责教学逻辑构建接收 Agent 1 的输出按照教学规律组织内容生成教案框架。它关注的是怎么教而不是有什么。Agent 3 负责 PPT 结构生成接收 Agent 2 的教案把它转化成适合幻灯片呈现的结构控制每页信息量设计视觉节奏。Agent 4 负责质量校验检查教案和 PPT 之间的一致性查漏补缺确保知识点没有遗漏。这种拆解的好处是每个 Agent 的职责边界清晰输出质量可控。而且中间产物可以单独检查和修改不用整体返工。2.3 为什么选择 WorkBuddy 而不是其他方案市面上能做多 Agent 协作的工具不止一个我选 WorkBuddy 主要看中几点。一是它对中文资料的处理比较自然我那堆资料里有很多中文论文和报告用起来没有明显的翻译腔。二是它的 Agent 之间可以传递文件不只是传文本这意味着 Agent 1 处理完的中间文件可以直接被 Agent 2 读取不用手动复制粘贴。三是它支持自定义指令我可以给每个 Agent 设定非常具体的角色和行为规则这一点后面会详细讲。另外WorkBuddy 有网页版和本地部署两种方式。我一开始用的是网页版后来因为资料涉及一些内部材料就换成了本地部署。本地部署的安装过程不算复杂官方文档写得比较清楚基本就是下载安装包、配置环境、启动服务这几步。如果你只是处理公开资料网页版完全够用。3. 核心细节解析资料预处理与 Agent 配置的实操要点3.1 散装资料的第一轮清洗在把资料交给 WorkBuddy 之前我建议先做一轮手动清洗。这一步看起来多余但实际上能省掉后面很多麻烦。具体做什么把重复的文件删掉把明显不相关的资料剔除把文件名改成有意义的名字。我之前的文件名是这样的新建文档1.docx、扫描件_20240315.pdf、笔记.md。这种文件名丢给 Agent它根本不知道哪个是重点。我改成了第一章_课程导论_论文.pdf、行业案例_2024Q1_报告.docx、课堂活动设计_笔记.md。改完之后Agent 提取信息时的准确率明显提升。还有一个细节如果资料里有图片或扫描件最好先用 OCR 工具转成文字。WorkBuddy 本身对图片的处理能力有限你直接把图片丢进去它可能只能提取到很少的信息。我用的是一款免费的 OCR 工具把几张纸质笔记的照片转成了文本效果还不错。3.2 Agent 1 的配置资料提取与分类Agent 1 的任务是把所有资料吃进去然后输出一份结构化的要点清单。我给它的指令是这样的你是一个教学资料整理助手。请阅读我提供的所有文件完成以下任务第一提取每个文件的核心观点和关键信息每条不超过 50 字第二按照主题对提取的信息进行分类主题名称由你根据内容自动归纳第三标注每条信息的来源文件第四如果发现不同文件之间有矛盾或重复的内容单独列出来。这个指令的关键在于每条不超过 50 字和标注来源。限制字数是为了强迫 Agent 做真正的提炼而不是大段摘抄。标注来源是为了后面追溯和核实。我实测下来如果不限制字数Agent 会把原文大段复制过来那就失去了预处理的意义。Agent 1 的输出格式我要求用 Markdown 表格三列主题、要点、来源。这样后面 Agent 2 读取的时候结构清晰不容易出错。3.3 Agent 2 的配置教案框架生成Agent 2 拿到 Agent 1 的要点清单后要把它组织成教案。这里的关键是给 Agent 2 一个明确的教学设计框架。我用的框架是经典的导入-讲解-练习-总结四段式但根据课程类型做了调整。我给 Agent 2 的指令是这样的你是一个教学设计专家。请根据我提供的要点清单生成一份完整的教案。教案需要包含以下部分课程基本信息课程名称、课时、适用对象、教学目标知识目标、能力目标、素养目标、教学重点与难点、教学过程按导入、讲解、练习、总结四个环节展开每个环节标注时间分配、课后作业、参考资料。每个教学环节中请注明对应的知识点来源。这里有个经验一定要让 Agent 2 注明知识点来源。因为 Agent 1 已经标注了来源文件Agent 2 在组织教案时把来源带过来后面你检查的时候就能快速定位到原始资料。如果发现某个知识点讲得不对直接翻原始文件核实就行。另外教学目标的部分我要求分三个维度写。这是教学设计的标准做法但很多 AI 生成的教案会把三个维度混在一起。明确要求分开写输出质量会好很多。3.4 Agent 3 的配置PPT 结构生成Agent 3 的任务是把教案转化成 PPT 结构。这里最容易犯的错误是直接把教案内容复制到每一页幻灯片上。一页 PPT 塞几百字上课的时候学生根本看不清。我给 Agent 3 的指令是这样的你是一个演示文稿设计专家。请根据我提供的教案生成一份教学 PPT 的结构大纲。要求每页幻灯片只包含一个核心观点每页正文不超过 6 行每行不超过 20 字每页标注页面类型封面、目录、内容页、活动页、总结页内容页需要标注配图建议或视觉元素建议在关键页面之间设计过渡页。每页不超过 6 行每行不超过 20 字这个限制非常重要。它强迫 Agent 3 做信息分层把详细内容放到备注里而不是堆在幻灯片上。我实测下来加了这条限制之后生成的 PPT 结构直接可用不需要大改。配图建议这一条也很实用。Agent 3 会根据内容建议用什么样的图示比如用流程图展示三个步骤的关系、用对比表格呈现两种方案的差异。做 PPT 的时候照着建议找素材就行省了很多思考时间。4. 完整实操流程从资料到成品的每一步4.1 环境准备与 WorkBuddy 初始化如果你用的是网页版直接登录 WorkBuddy 的工作台就行。如果要用本地部署需要先确认你的系统环境。我是在 Linux 环境下部署的官方提供了对应的安装包。安装过程大致是下载安装包、解压、运行安装脚本、配置端口和存储路径、启动服务。整个过程大概十分钟。有一个细节值得注意WorkBuddy 的系统缓存目录默认在系统盘。如果你的资料比较多建议把缓存目录改到空间更大的盘。具体方法是在配置文件中修改 cache_dir 参数指向你想要的路径。我改到了 D 盘的一个专门目录后面处理大文件时没有出现过空间不足的问题。初始化完成后你需要创建一个新的工作台Workspace。我建议按课程名称来命名工作台比如课程名称_2024春季。这样后面如果有多个课程不会混淆。4.2 资料上传与 Agent 1 执行在工作台里创建一个新的 Agent命名为资料整理。把清洗好的资料文件上传到这个 Agent 的上下文中。WorkBuddy 支持批量上传我一次性把二十多个文件都传了上去。然后输入前面写好的指令点击执行。Agent 1 的处理时间取决于资料量我那次大概等了三四分钟。输出结果是一份 Markdown 表格列出了所有提取的要点按主题分了六类。这里有个实操心得第一次执行后不要急着进入下一步。先花几分钟检查 Agent 1 的输出。重点看两件事一是分类是否合理有没有把不相关的内容归到一起二是要点提取是否准确有没有遗漏重要信息。如果发现问题调整指令后重新执行。我那次发现 Agent 1 把两个相似但不同的概念混为一谈了在指令里补充了一句注意区分相似概念后重新执行结果就对了。4.3 Agent 2 生成教案与人工校验Agent 1 的输出确认无误后创建 Agent 2命名为教案生成。把 Agent 1 的输出作为输入传给 Agent 2然后输入教案生成指令。Agent 2 的输出是一份完整的教案大概有三千多字。我拿到之后做了一轮人工校验主要检查三个方面教学目标的表述是否准确、教学环节的时间分配是否合理、知识点之间的逻辑衔接是否顺畅。校验的时候我发现一个问题Agent 2 把某个知识点的讲解顺序排错了应该先讲基础概念再讲应用案例它反过来了。我在 Agent 2 的指令里补充了一句请确保知识点按照从基础到应用的顺序排列重新生成后就对了。这个环节我的建议是不要跳过人工校验。Agent 再智能也不如你了解自己的学生和课程要求。花二十分钟检查一遍比后面上课时发现问题的代价小得多。4.4 Agent 3 生成 PPT 结构与最终输出教案确认后创建 Agent 3命名为PPT 结构。把教案传给 Agent 3输入 PPT 结构生成指令。Agent 3 的输出是一份 PPT 大纲包含大概三十页幻灯片的结构。每页有标题、核心观点、配图建议。我检查了一遍调整了几页的顺序然后就可以直接拿去做 PPT 了。做 PPT 的时候我用的是常见的演示文稿软件。按照 Agent 3 给的结构每页填入对应的内容配上建议的图示。因为结构已经很清晰了做 PPT 的过程非常顺畅大概一个多小时就完成了全部三十页。最后我还用 Agent 4 做了一轮一致性检查。Agent 4 的任务是对比教案和 PPT 大纲检查有没有知识点遗漏或表述不一致的地方。这个环节帮我发现了两处问题一处是教案里提到的某个案例在 PPT 里没有体现另一处是 PPT 里有个数据跟教案里的不一致。修正之后整套材料就完整了。5. 常见问题与排查技巧实录5.1 Agent 输出质量不稳定的排查思路用多 Agent 协作最常见的问题就是某个 Agent 的输出质量不稳定。同样的指令有时候输出很好有时候就不行。我总结了几条排查思路。首先检查输入。Agent 的输出质量很大程度上取决于输入质量。如果 Agent 1 的要点提取有遗漏Agent 2 的教案就会缺内容。所以每一步的输出都要检查不要一路跑到黑。其次检查指令的明确程度。模糊的指令导致模糊的输出。比如请生成教案就不如请生成一份包含课程基本信息、教学目标、教学重难点、教学过程、课后作业的完整教案来得明确。指令越具体输出越可控。最后检查上下文长度。如果传给 Agent 的内容太长超出了它的处理能力输出质量会下降。这时候需要把内容拆分成更小的批次分多次处理。5.2 资料格式兼容性问题与解决WorkBuddy 对常见格式的支持比较好PDF、Word、Markdown、纯文本都能处理。但我遇到过两个特殊情况。一个是加密的 PDF 文件Agent 读不了。解决办法是先用工具去掉密码保护再上传。另一个是扫描版的 PDF里面的文字实际上是图片Agent 也读不了。这种情况需要用 OCR 工具先转成文本。还有一个细节如果资料里有大量的表格或公式Agent 提取信息时可能会丢失格式。我的做法是把表格和公式单独截图用 OCR 转成文字后以文本形式补充给 Agent并注明以下内容为表格数据。5.3 教案与 PPT 内容不一致的预防措施教案和 PPT 不一致是备课中的常见问题。用多 Agent 协作时这个问题更容易出现因为教案和 PPT 是不同 Agent 生成的。预防措施有三个。一是在 Agent 3 的指令里明确要求严格基于教案内容生成 PPT 结构不得自行增删知识点。二是设置 Agent 4 做专门的一致性检查。三是在最终输出前自己再对照一遍教案和 PPT 的知识点列表确保一一对应。我整理了一个常见问题速查表放在下面供参考。问题现象可能原因排查方法解决措施Agent 输出内容空洞指令过于宽泛检查指令是否包含具体输出要求补充输出格式、字数限制、内容维度知识点遗漏输入资料不完整或提取有误对照原始资料检查 Agent 1 输出补充资料或调整提取指令教案逻辑混乱知识点排序不合理检查教学环节的先后顺序在指令中明确排序规则PPT 每页信息过多未限制每页内容量检查 Agent 3 指令增加每页行数和字数限制不同 Agent 输出风格不一致未统一角色设定检查各 Agent 的角色描述统一术语和表述风格5.4 实操心得与避坑技巧说几个我踩过的坑。第一个坑是贪多求快一次性把所有资料丢给一个 Agent 处理。结果就是输出质量很差还得返工。后来改成多 Agent 分步处理虽然步骤多了但总时间反而更短。第二个坑是忽视中间产物的检查。有一次 Agent 1 的输出里有个明显的分类错误我没注意直接传给了 Agent 2结果教案里整个一章的内容都放错了位置。从那以后我养成了每步必查的习惯。第三个坑是 Agent 指令写得太客气。比如你能不能帮我生成一份教案这种表述Agent 可能会理解成可选项输出质量不稳定。后来我改成请生成一份教案要求如下这种明确的指令式表述输出就稳定多了。还有一个技巧给 WorkBuddy 设定全局规则。在 WorkBuddy 的设置里可以定义几条对所有 Agent 都生效的规则。我设了三条一是所有输出使用中文二是所有输出使用 Markdown 格式三是涉及数据的内容必须标注来源。这样就不用每个 Agent 都重复交代了。6. 后续扩展这套方法还能怎么用这套多 Agent 协作备课的方法不只适用于做教案和 PPT。我后来把它扩展到了几个新场景。一个是做课程大纲。把教案生成 Agent 的指令改一下让它输出课程整体大纲而不是单次课的教案就能快速生成一学期的课程规划。另一个是做习题集。增加一个 Agent专门根据教案内容生成配套练习题和参考答案。还有一个是做教学反思报告。每次课后把课堂记录和教案一起传给 Agent让它分析教学效果提出改进建议。如果你教的是多门课可以给每门课建一个独立的工作台把该课程的所有资料和 Agent 配置都放在里面。下次再备这门课的时候直接调用之前的配置只需要更新资料就行。我现在的做法是每门课维护一个资料库工作台和一个备课工作台资料库负责积累素材备课负责生成成品两者分开互不干扰。最后分享一个小技巧WorkBuddy 支持跨对话记忆。你可以在一个对话里告诉它记住这个课程的教学风格是偏实践应用的后面在同一个工作台里新建的 Agent 都会继承这个设定。这个功能对于保持多门课之间的风格一致性特别有用。我试过在同一个工作台里连续处理三门课的备课任务风格保持得很统一没有出现串味的情况。