WorkBuddy自定义专家实操指南：从原理到配置与排错

最近好几个朋友在问我同一个事：WorkBuddy里那个“自己创建专家”到底怎么玩。说实话，这个功能属于典型的“入口好找、玩明白不容易”，很多人打开之后看到一堆配置项就懵了，填了个名字和描述，跑了两轮发现不对劲，然后又放弃。我花了大概两周时间把整套流程跑通，中间踩了不少坑，今天干脆把完整的实操思路、配置细节和排查经验一次性写出来。

先说清楚这个事到底解决什么问题。WorkBuddy本身是一个效率智能体工作台，你可以把它理解成一个空办公位，默认坐着一个啥都能聊两句的通用助手。但通用助手只适合“问问题”，不适合“干活”。你真正想要的，是一个打开就知道先做什么、后做什么、按什么格式输出、遇到边界就停下来问你的“岗位专家”——比如“销售周报整理专家”“客户邮件润色专家”“论文审稿意见回复专家”。这些专家不会凭空出现，需要你自己动手把岗位经验、工作流程、输出规范一点一点喂进去。建好之后，它就变成一个随叫随到的数字员工，帮你把重复劳动接走。

这篇文章适合谁？适合已经在用或打算用WorkBuddy、但卡在“自定义专家”这一步的人。你不需要会写代码，但需要愿意认真想清楚自己要解决什么问题。文章里会给一套可以直接抄的流程，也会把我在文件权限、知识库、定时任务、网络报错这些地方踩过的坑全部交代出来。

1. 认识专家机制：先搞懂你正在创建的是什么

很多教程上来就教你“点哪里、填什么”，结果你跟着点完，做出来的东西跟你脑子想的完全是两回事。问题出在没搞懂“专家”在WorkBuddy里的底层机制。所以我把这一章节放在最前面，花点时间讲清楚原理，后面实操会顺很多。

1.1 专家不是一个聊天机器人，而是一套“人设+流程+工具+知识库”的组合

你可以把WorkBuddy里的专家理解成“给通用大模型套了一层完整的工作制度”。单靠模型本身，它只知道“怎么说话”，不知道“在你的场景里该干什么”。而专家做的事情，就是把这套“该干什么”变成可执行的规则。

拆开看，一个完整的专家至少包含四块内容：

• 角色指令：定义这个专家是什么身份、用什么语气、遵守什么原则。这是整个专家的灵魂，80%的质量问题都出在这一块没写清楚。
• 工作流程：定义它收到任务后先做什么、再做什么，比如“先读取文件→再提炼要点→最后按模板输出”。没有流程，模型就只会自由发挥，每次输出风格都不一样。
• 工具权限：决定它能调用哪些能力，比如联网搜索、读取本地文件、定时触发、发送消息。这是专家“能干活”而不是“只能聊天”的关键。
• 知识库：给它喂入你的业务资料、历史案例、规范文档，让它回答问题时“有据可依”，而不是凭模型自己的通用知识瞎编。

这四块缺一不可。我见过很多人创建专家的时候只填了角色指令，发现效果跟直接用通用对话差不多，就是这个原因——一个人只有“人设”但没有“作业流程”和“工具箱”，他也没法真正干活。

1.2 WorkBuddy和CodeBuddy到底有什么区别

不少人在搜索“自己创建专家”的时候，会连带看到CodeBuddy的词条，然后就开始困惑：这两个是不是同一个东西？我用了一段时间，简单说一下我的理解。

它们俩属于同一套体系下的不同产品方向。CodeBuddy偏垂直开发场景，面向程序员，强调的是代码生成、代码解释、仓库理解这一套能力，我理解它更像一个“代码专家”的集合。WorkBuddy则更像是横向的、面向办公和业务场景的效率工作台，它的定位不是帮人写代码，而是把各种业务动作——查资料、写文档、整理表格、回消息、跑流程——通过“专家”这个载体串起来。

所以如果你是在代码场景里干活，CodeBuddy是顺手的那个；如果你要处理的是日常业务、办公流程、跨工具协同，那WorkBuddy才是主战场。这两个不冲突，甚至可以搭配使用，但从“自己创建专家”这个角度看，WorkBuddy的自定义空间更贴近普通人的日常工作。

1.3 为什么推荐自己创建专家，而不是在市场上现找

WorkBuddy里其实也自带一些专家或技能模板，拿来就能用。那为什么还要自己建？我个人的答案是：现成的专家解决的是“大众问题”，你自己面对的是“具体问题”。

举个例子，市场上有“会议纪要整理专家”，但你所在团队的开会有特殊的格式要求——要在最前面放风险事项、要在结尾附上责任人和DDL、要自动把股东关心的数据单列一页。通用专家不会知道这些，你每次用它都得在对话里反复补充要求，还不如一开始就创建一个“符合你们团队习惯的会议纪要专家”，把规则写死在配置里，后面只需要丢原始材料进去，它自己就知道怎么办。

我给自己建的专家，大部分都是从现有模板改过来的。这样上手快，而且能明确看到“模板的不足”在哪里，改起来有方向。等你建过三四个专家，你就会形成一种感觉：一个专家本质上是“把你的业务判断力以规则的形式外抛给模型”。这件事做熟练之后，工作效率的提升是非常明显的。

2. 创建专家之前的准备工作：用五个问题把需求钉死

我见过太多人一上来就打开创建页面，噼里啪啦写一通，然后发现做出来的东西什么都像、什么都不精。根子在于需求没想清楚。创建专家这件事，最花时间的不是配置，而是“思考你到底要一个什么样的助手”。在动手之前，我会先花半小时回答下面五个问题。

2.1 问题一：这个专家要为谁、解决什么具体任务

“为谁”决定了语气和审查标准，“解决什么任务”决定了专家的边界。比如“论文专家回复”这个场景，面向的是需要处理审稿意见的科研人员。那这个专家的任务就应该是：读懂审稿人的意见、区分“必须修改”和“建议优化”、按学术礼貌的措辞生成回复草稿。如果你不把这个场景界定向这么细，专家就会变成一个“什么都能聊但什么都聊不深”的学术大杂烩。

我的建议是把任务写成一句话，格式是“当用户提供X时，专家应该输出Y”。比如“当用户提供一篇审稿意见原文时，专家应该输出一封结构清晰的回复信草稿，包含对每条意见的逐一回应”。这句话会贯穿你整个配置过程，任何设置如果偏离了这句话，就是要砍掉的内容。

2.2 问题二：输入是什么，输出是什么

这个看似简单的问题，决定了专家工作流怎么设计。我实际建专家的时候，会把“输入”和“输出”各细分出几个形态。

输入方面，要考虑：

• 用户自己粘贴的文字也算一种输入
• 用户上传的文件是Word、PDF、Excel还是录音转写稿
• 是否需要联网去抓取一些实时信息

输出方面，要考虑：

• 是一段对话式的回答，还是一份格式固定的文档
• 是否需要生成表格、标记关键信息
• 是否要求“先给结论、再给理由”的结构顺序

拿我自己做的一个“周报整理专家”举例：输入是团队群里每个人发的零散周报文字，输出是一份按项目分组的周报汇总，并在最后标注出风险项。因为我把输入输出事先想清楚了，后面写指令的时候就知道该让专家“先列举所有条目→按项目归类→再单独提取风险词汇”，整个流程非常清晰。

2.3 问题三：需要给它哪些工具权限

这一步最容易被忽略，也最容易出问题。专家要不要联网？要不要读取指定文件夹？要不要有定时发送消息的权限？这些决定了它的能力边界，也决定了安全边界。

我的原则是最小权限——能不开的权限就不开。原因有两个：

第一，权限开得越多，专家越容易“跑偏”。比如你只是让它整理本地文档，但你给了联网权限，它可能会在你意料之外去网上找一些所谓参考资料，干扰输出。

第二，权限范围越大，信息安全风险越高。如果你的文件访问范围是整个电脑，专家在处理任务时可能扫描到你根本不想让它看的文件。我一般只给它指定的工作目录，一个专家对应一个文件夹，够用就好。

2.4 问题四：什么情况它应该停下来问用户，而不是自作主张

这一点很多人完全没有概念。专家的本质是帮你省时间，但如果它从不确认、只管执行，很容易把一个本来需要人工判断的动作给办砸了。

我在配置里一定会写清楚“自主决策的边界”。比如我的“客户邮件润色专家”，我明确要求它：正常的措辞优化可以直接输出；但如果邮件涉及价格承诺、合同条款变更，必须在回复里高亮提示“涉及商务承诺，请人工确认”，并且不要替用户做出承诺性表述。

这个边界设定，本质上是在做“人机分工”。把模型擅长的事情——语言组织、格式整理、信息归纳——交给专家；把人必须掌握的事情——拍板、背责任、做决策——牢牢留在自己手里。一个专家能不能被长期信任地使用，就看你有没有把这个边界画清楚。

2.5 问题五：拿什么标准来验收这个专家是“合格的”

没有验收标准，你就会陷入无穷无尽的调试里。我的做法是准备一组固定的测试样例，每轮改完配置之后，用同样的输入跑一遍，对比输出质量有没有提升。

比如你的测试样例可以是“一篇两页纸的会议原始速记”，你心里先想好一个理想输出长什么样，然后拿它去测试专家。改动之后如果输出更接近理想版本，说明改对了；如果退步了，就回滚配置。用固定测试集验收，能避免“凭感觉调试”，效率会高很多。

这些准备工作做完之后，你的脑子里其实已经有一份“需求说明书”了。接下来才是打开WorkBuddy，把它翻译成配置。

3. 手把手创建第一个专家：从入口到首轮测试

现在正式进入实操环节。这一章我会按实际的创建顺序，把一个专家的完整搭建过程过一遍。因为WorkBuddy目前还在快速迭代，不同版本的具体按钮位置可能有差异，但核心逻辑是稳定的，你只要按这个思路去找对应入口就不会迷路。

3.1 进入专家创建入口，选对起点模式

安装和登录WorkBuddy这一步比较简单，我不展开了，提一个注意点：如果你在公司内网环境，安装完成后首次联网时可能会遇到连接报错，这个问题我放在后面排查章节专门讲。登录成功之后，工作台界面左侧通常会有专家、技能、插件这一类入口。注意，如果界面语言是英文，对应的词可能是“Skill”“Agent”或“Expert”，不同版本叫法不一样，但指的东西基本是一类。

创建入口点进去之后，一般会看到三种创建模式：

• 从市场/模板库选择：适合刚上手，先复制一个接近需求的专家再改。
• 从空白创建：适合你已经很明确专家要干什么，不想要模板的冗余内容。
• 从已有对话创建：适合你在聊天过程中发现“聊得不错，想把这个思路固定成专家”。这个入口比较隐蔽，但在某些版本里非常好用。

我建议第一次创建的时候先选模板。哪怕你最终想做的专家跟模板差异很大，模板也能给你提供一个基础的指令结构，让你看到“别人的角色设定是怎么写的”，比自己面对空白输入框要友好得多。

3.2 编写“角色与指令”：一份可以直接套用的指令模板

如果说专家是一个人，那角色指令就是它的岗位说明书。这是最核心的一步，我愿意多花篇幅讲细一点。

我总结了四段式结构：身份与目标、工作流程、输入输出规范、边界与铁律。在WorkBuddy的专家配置里，一般有一个“系统提示词”或“指令”输入框，把下面这个结构按你的情况改写填进去就行。

这里给出我曾经用于“会议纪要整理专家”的指令模板，你可以直接参考：

[身份与目标] 你是一位有8年经验的业务会议纪要整理与项目跟进助理。你的目标是把会议原始材料整理成一份结构清晰、可用于后续跟进的任务分派纪要，并准确识别风险与责任人。 [工作流程] 1. 阅读用户提供的会议速记、录音转写稿或要点草稿。 2. 提取本次会议的核心议题，用一句话概括。 3. 按“议题、讨论结论、下一步动作、负责人、截止时间”五列整理任务。 4. 单独列出风险项模块，标注需要领导决策的事项。 5. 最后生成“本次会议需要关注的数据指标”清单，如果原始材料中没有提到指标，则明确说明“原文未提及”。 [输入输出规范] - 输出使用中文，使用Markdown表格呈现任务分派结果。 - 每条下一步动作必须以动词开头，例如“撰写方案”“确认预算”。 - 如果原始材料里没有明确负责人或截止时间，请用“待确认”标注，不要自行编造。 [边界与铁律] - 不得增删会议中未提及的议题。 - 不得对参会人员观点进行倾向性评价或总结。 - 当原始材料信息不完整导致无法完成任务时，列出缺失信息清单并询问用户，不要直接生成一份看似完整但包含虚构内容的纪要。

你可以看到这份指令完全是我在2.1和2.2里思考的结果——先钉死目标，再拆流程，再把输出格式定死，最后设边界。写完角色指令之后，最直接的检验方式是问自己：一个完全不了解你们团队的新人，看到这份指令，能不能按照你的要求把活干出来？如果能，大模型大概率也能。

3.3 设置文件访问范围与工具权限

指令写完之后，下一步是配置工具。这里最重要的一项就是文件访问范围，网上问“workbuddy如何设置访问文件夹范围”的人非常多，我刚开始也没找到，后来才摸清楚逻辑。

在WorkBuddy里，给一个专家配置文件夹访问权限，本质上不是让它“看到整个电脑”，而是要你明确指定“它可以读取哪个目录”。我的习惯是在本地建一个专门的目录，比如D:\WorkBuddyWorkspace\会议纪要专家\，然后把跟这个专家相关的输入文件都丢到这个目录里。配置的时候只勾选这个目录，不给其他任何位置的权限。

这么做的理由是：

• 降低信息泄漏风险：隔离开你的私人文档和业务文档
• 减少干扰：专家检索文件时，不会匹配到无关内容
• 便于排查问题：输出不对的时候，你很清楚它可能读了哪些文件

除了文件访问，还有联网搜索、定时触发、消息发送等工具。第一版专家我建议先关掉联网，只保留文件读取和基础对话能力，把核心流程跑通了再逐步放开。尤其是涉及业务敏感数据的时候，不要轻易让专家把内容发到外部接口去。

3.4 保存、发布与首轮测试

配置完成后，需要给专家设置一个名称、描述和头像，然后选择可见范围。一般会有“仅自己可见”“团队可见”这类选项。第一版我建议先设为仅自己可见，等测试稳定了再发布给团队，避免把半成品暴露给同事。

第一轮测试不要急着拿真实文件试，建议先拿“模拟数据”跑流程。比如测试会议纪要专家，先自己编一段300字的会议速记，故意在里面加入“没有明确负责人”的条目，确定专家会不会按规则标“待确认”。这样做的目的是先验证“流程通不通”，而不是验证“结果精不精”。

如果第一轮输出基本符合预期，再换真实材料测试。如果输出偏离得厉害，回到角色指令里找原因，不用怀疑模型“能力不行”，大多数情况下是指令写得还不够明确。迭代两三轮之后，专家会稳定到一个“能上岗”的状态。

4. 让专家从“能用”变成“好用”：知识库、工作流与记忆迁移

你在第3章建出来的专家，已经能称得上是一个合格的数字员工了。但“能用”和“好用”之间还有一段距离。这一章讲三个进阶方向：给专家配私有知识库、把专家接入定时工作流、以及换设备时历史对话记录和本地记忆怎么迁移。

4.1 给专家配置私有知识库：让它“懂你们家的事”

一个只有指令和工具的专家，相当于一个很聪明但刚入职的新人。它知道怎么做事情，但不知道你们团队的术语、产品线、报价体系、历史决策。知识库就是用来快速补齐这些信息的。

WorkBuddy里上传知识库的方式，一般是在专家配置页面找到“知识库”或“参考资料”入口，支持上传文档。我踩过的坑是：不要把一整本上百页的手册一次性扔进去。模型在回答时是“检索式引用知识库片段”，如果文档太长、结构太乱，检索命中率会变差。

实操建议是：

• 把资料拆成独立小文档，每个文档聚焦一个主题，500到1000字比较合适
• 文件名要起得直白，尽量带关键词，比如“报价政策-2025年版本.md”，方便检索匹配
• 定期更新，过期内容要及时从知识库移除，否则专家会拿旧政策回答新问题

我给自己建“客户回复专家”的时候，知识库里放了三类文档。第一类是产品常见问题FAQ，第二类是客服回复红线要求，第三类是我们过去半年优秀回复案例的脱敏摘录。加上这套东西之后，专家的输出质量提升非常明显，因为它回答问题时不再是凭空发挥，而是有了一批“实际依据”。

4.2 把专家接进定时任务和外部工具：让它主动干活

配置到位之后，专家可以不用等你开口，而是按计划主动干活。WorkBuddy里我理解是一套“工作流”或“自动化”能力，可以把专家作为一个节点接进去。

举几个我实际验证过的场景：

• 定时发送微信消息：我建了一个“每日站会播报专家”，每天早上9点读取团队协作文档里当天新增的任务，生成一段精简播报，通过授权通道发到工作群。关键点是在配置消息发送工具时，要把发送对象、发送频率、内容范围都明确绑定，避免专家乱发消息。
• 钉钉多维表定期同步：我让一个“项目进度同步专家”每隔一段时间读取项目周报，自动更新到多维表的指定字段。这一步需要先检查工具授权是否到位，授权失效是最常见的失败原因。
• 文件自动归档：每周五让“归档专家”把本周会议纪要按项目名称重命名，移动到对应的归档目录，并生成索引清单。

接入定时任务之后，你要特别留意“失败重试”机制。如果定时任务第一次运行失败，是自动重试还是等人工接手？我的建议是：关键任务不要设置自动重试，而是让专家“遇到异常先停下来，输出失败原因”。否则同一个错误它可能被重复执行十几次，反而制造垃圾数据。

4.3 历史对话记录与本地记忆迁移

用WorkBuddy一段时间之后，你和专家之间的历史对话、本地形成的记忆文件会越攒越多。如果你换了新电脑，或者重装了系统，怎么把这些东西搬过去？

我遇到的情况是：专家的角色指令通常存在云端账号体系里，登录同样账号能同步；但本地记忆、历史对话记录、知识库索引这些，需要手动迁移。我的迁移步骤是：

1. 先找到WorkBuddy本地数据目录，一般是在用户目录下的隐藏文件夹里，具体路径可以在设置页面的“存储路径”里看到。
2. 把整个数据目录打包备份，重点包含对话历史、附件缓存以及知识库配置。
3. 新设备上安装好WorkBuddy，登录账号后退出程序，把备份目录覆盖到对应位置，重新启动，确认历史对话是否恢复。
4. 如果只是想迁移某个专家的记忆设置，可以直接在专家配置页面把角色指令和知识库文件导出保存，到新设备再导入，这个方式更轻量。

迁移完成之后，建议跑一次固定测试集，确认专家行为没有被“搬家”影响。另外，本地记忆文件有时候会很大，定期清理历史对话记录也有助于提升启动速度。

5. 高频问题排查实录：网络报错、启动缓慢、输出不稳定

我在使用WorkBuddy的过程中，确实踩了不少坑，有些问题搜遍全网都找不到明确答案，只能自己一点点试出来。这一章把它们集中写成排查手册，希望能让你少走弯路。

5.1 “网络连接失败”或报错3002的排查思路

我第一次启动WorkBuddy就遇到“网络连接失败”的提示，重装了两次也没解决。后来发现核心问题大概率出在网络环境上。

优先检查这几项：

• 公司办公网络：企业网关或防火墙可能拦截了WorkBuddy连接服务端的请求，可以试试切换到手机热点，如果热点下能正常用，问题就在企业网络策略。
• 本地代理工具：如果你电脑上跑过抓包软件或代理类应用，它们可能会干扰WorkBuddy的网络握手，暂时退出这些软件再试。
• 系统时间：听起来离谱，但系统时间偏差超过几分钟，会导致密钥校验失败继而报出网络相关错误，校准时间再启动。

排查的时候记得看日志。WorkBuddy一般在设置里或者日志目录里能看到运行日志，把报错时的时间点和日志内容截下来，发给技术支持或去社区里搜，比光报一个“网络连接失败”有效得多。

5.2 启动非常慢、占用资源高的常见原因

很多人反映WorkBuddy启动慢。我的观察是，第一次安装后冷启动确实会慢一些，因为要做本地环境初始化和模型组件预加载。但如果每次启动都慢得让人想砸电脑，从这几个方向排查：

• 本地数据目录过大：历史对话记录和知识库索引积累久了会拖慢启动扫描，定期清理不需要的历史会话。
• 开机自启的后台服务冲突：某些安全管理软件会扫描WorkBuddy加载的本地文件，导致启动过程被拖慢，把数据目录加入信任区就好。
• 内存占用高：如果你同时开着大型软件和浏览器几十个标签，再启动WorkBuddy会非常吃力。给电脑加内存是最直接的解法，日常使用的话注意在任务管理器里观察一下WorkBuddy的并发子进程数量。

5.3 专家输出质量不稳定的排查顺序

专家用着用着忽然“变笨了”，这是最让人头疼的情况。别急着改指令，按下面的顺序从外到里排查：

1. 先看知识库有没有变化：你是不是最近更新了知识库文档？新文档格式不规范或内容互相矛盾，会直接拉低输出质量。
2. 再看任务上下文是否过长：历史对话积累太多，可能冲淡了核心指令的约束力，开一个新会话再试。
3. 然后用固定测试集验证：同一份测试输入，如果输出和之前明显不同，说明配置或环境变了；如果输出稳定，可能是你对这次输入本身的期望发生了变化。

我自己的经验是：约80%的“变笨”情况来自知识库更新不当或上下文污染，真正需要改指令的情况不到两成。所以别慌着大改配置，先最小化复现问题再说。

5.4 常见问题速查表

为了让你排查时更快定位，我把遇到的高频问题整理成了一张速查表：

这张表我建议你收藏下来，遇到问题先对号入座，很多报错其实不用走“重装大法”。

最后再分享一个我的个人体会：创建专家这件事，最大的门槛不在工具操作，而在你能不能把自己的工作流程想清楚。我第一次建专家的时候，光角色指令就迭代了十几版，最后稳定下来的版本，跟初版几乎像是两个东西。但正是因为这个过程，我才把每天重复的琐碎活真正梳理出了效率。WorkBuddy里那套自定义机制，确实能让“把经验固化下来”这件事变得更轻。如果你第一次建的专家效果不理想，不用气馁，先看看是流程没定清、还是指令写得太泛，按上面的思路一轮轮调，很快就能感受到“自己训练出靠谱搭档”的乐趣。