ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

WorkBuddy智能体实战:三步搭建自动周报汇总流程

WorkBuddy智能体实战:三步搭建自动周报汇总流程 1. 从一张“周报汇总表”说起我为什么开始认真用 WorkBuddy事情得从去年年底说起。我们部门有五个小组每周五下午都要提交一份周报。名义上叫周报实际上就是大家在聊天群里各发一段文字或者往共享表格里填几行数据再由我这种“运营支持岗”的人去把它们捞出来、去重、归类最后整理成一份能拿得上台面的汇报材料。这份工作听起来简单干起来非常磨人。每周五下午到下班前我的时间基本都耗在“复制粘贴—调整格式—追着人补齐信息—再粘贴再调格式”这种循环里。后来我开始尝试用脚本写爬取逻辑但群里消息的格式千奇百怪共享表格的字段也经常变脚本维护成本比手工还高。那段时间我甚至试过把内容丢给在线对话工具让它“帮忙总结”但每次都要手动复制文本、再手动回填来回切换窗口同样累。后来团队里有人推荐了 WorkBuddy说这是腾讯出的效率智能体不是单纯聊天机器人而是能把“输入—处理—输出”串成自动任务的工具。我当时的第一反应是又一个 AI 玩具。真正让我决定试一试的是它能把定时触发、连接器、自定义指令这些环节拼在一起这意味着我可以把“收集周报—清洗—归类—汇总—推送”这条链路整体交给它跑而不是让它帮我“写一段总结”就完事。如果你也面临类似场景每天要在几个系统之间搬数据、要做信息汇集、要定期整理聊天记录或表格内容那么这篇实战记录应该能给你一些参考。我会把我从安装配置到跑通第一个完整任务的整个过程都写出来包括中间踩过的坑。希望能帮你少走几趟弯路。2. 项目整体思路拆解WorkBuddy 到底能解决什么问题2.1 先理清 WorkBuddy 和 CodeBuddy 的区别我在搜索资料时发现不少人和我一样一开始分不清 WorkBuddy 和 CodeBuddy 是什么关系。简单说CodeBuddy 更偏“开发场景”面向程序员写代码、修 Bug、做代码审查它的强项是理解工程代码库和生成可运行的代码。WorkBuddy 更偏“办公与业务场景”它面向的是日常工作任务尤其是那些跨应用、跨系统的“脏活累活”比如汇总信息、定时发送、同步表格、整理聊天记录。打个不太严谨的比方CodeBuddy 像是你的编程搭档负责在代码层面帮你干活WorkBuddy 更像是你的“数字事务助理”负责在你日常工作的信息流里来回穿梭。两者的底层能力有重叠但面向的对象和场景完全不同。理解这个区别很重要。因为你面对的如果是“让 AI 帮我写一段 Python 脚本”那 CodeBuddy 可能更顺手但如果任务是“每天把销售群里报上来的数据整理进多维表格并在每天早上十点推一份摘要到群里”那 WorkBuddy 这种具备连接器、定时任务能力的工具才是真正能落地的方案。2.2 我把周报任务拆成了四个环节在做任何自动化之前我都习惯先把手头的工作拆开看。只有把流程拆到足够清晰才能知道哪些环节值得自动化、哪些环节需要人工兜底。我当时的周报任务大概是这样的收集各小组在微信群、企业微信聊天记录中发布周报文本或者是在钉钉多维表里填写结构化字段。清洗去掉聊天里的表情、无关回复、临时讨论内容保留真正的工作事项。归类将内容按“项目进度”“风险问题”“下周计划”三个维度归位。汇总与推送把整理好的内容拼接成一份固定格式的周报在周五晚 7 点前发给负责人。过去我手动处理平均每周要花差不多三个小时。用 WorkBuddy 来跑我给自己定的目标是从“人工搬运”变成“人工只负责审核”。也就是让 WorkBuddy 自动完成收集、清洗、归类和初稿汇总我来做最后的检查和微调。基于这个目标我确定了 WorkBuddy 需要承担的核心功能读取多维表格、解析聊天记录、调用模型生成结构化周报、再通过定时消息推送到群或指定人。这四件事正好对应 WorkBuddy 的 Skill、连接器、指令和定时触发四个能力。2.3 为什么选 WorkBuddy 而不是自己写脚本有人可能问这些活写 Python 脚本不也能干吗为什么非要选 WorkBuddy我也写过脚本但维护成本太高。多维表格的字段一变代码就要跟着改聊天记录里出现新的表达方式正则规则就要重新写再加上接口鉴权、定时任务的部署一个人维护起来非常痛苦。WorkBuddy 的价值在于它把“读取数据源—理解语义—生成内容—调用外部服务”这个过程做成了可配置的流水线。我不需要关心底层接口怎么调、鉴权怎么做只需要把“这个技能要做什么”“数据从哪来”“结果往哪去”说清楚它就能替我把流程串起来。当然它也有局限。如果业务逻辑极其复杂、需要大量条件分支和精确计算那它目前还不能完全替代定制开发。但如果是“信息搬运 文本整理 定时发送”这一类占工作量大头的事务型任务WorkBuddy 确实能省下大量时间。3. 部署与基础配置从安装到跑通前的准备工作3.1 下载安装Windows、Linux、麒麟版都有对应版本WorkBuddy 的安装整体不复杂。我用的环境是 Windows 11官网下载安装包后一路下一步即可。安装完成后首次启动会要求登录可以使用企业账号或手机号注册。如果你所在团队的服务器或办公电脑是 Linux 环境WorkBuddy 也提供了对应的 Linux 版本。另外我注意到一个细节有同事提到“麒麟版”——也就是面向麒麟操作系统的适配版本。如果你所在单位用的是信创环境需要提前确认版本兼容性不要贸然拿通用 Linux 包往麒麟系统上装最好向官方渠道确认专门版本的获取方式。安装目录方面WorkBuddy 默认会把配置和数据放在用户目录下具体路径在不同版本上可能不太一样。这个后面会在“常见问题”一节专门说明因为它牵扯到一个很隐蔽的坑。3.2 登录与权限准备连接器配置前要做的检查WorkBuddy 安装完只是第一步真正要干活还需要把你日常使用的数据源和应用与它连接起来。这里有一个容易忽略的点WorkBuddy 的权限体系和你的企业应用权限是分开的不能想当然地认为只要登录了 WorkBuddy它就能自动读取你钉钉里的多维表格或企业微信的聊天记录。在开始配置之前我建议你先确认三件事WorkBuddy 当前账号是否有调用对应连接器的权限。一般需要在 WorkBuddy 的“连接器管理”页面里完成一次 OAuth 授权。数据源的访问范围。比如要读多维表格就得保证 WorkBuddy 关联的账号对这张表有读取权限。定时消息发送的目标对象是否允许机器人推送。有些群或联系人默认屏蔽了应用消息这个需要提前开启。我当时就是因为没检查第 2 点导致“连接器配置成功但拉不到数据”后来才发现是授权时选错了协作空间。3.3 插件与外部工具的联动我接上了 OBSIDIAN 和浏览器WorkBuddy 的一大优势是它不封闭。除了自带的连接器它还支持通过插件或扩展槽位与常用效率工具联动。我平时用 OBSIDIAN 做知识管理每天的工作记录、重要决定、会议速记都写在里面。WorkBuddy 有支持 OBSIDIAN 的插件方式启用之后可以让 Skill 直接读取指定目录下的笔记内容。这个功能对我特别有用——因为周报里“下周计划”这一栏我不用再从聊天记录里去猜WorkBuddy 可以结合我 OBSIDIAN 里的个人计划笔记来生成准确率高很多。除此以外WorkBuddy 还能作为浏览器插件嵌入到网页端使用。我试过在浏览器的企业微信工作台页面唤起 WorkBuddy 来抓取当前页面内容整个过程确实顺畅不少。如果你重度依赖浏览器处理后台系统这个插件值得研究一下。4. 实操过程用 WorkBuddy 跑通一个完整的“周报自动汇总”任务4.1 第一步先在 WorkBuddy 里建一个自定义 SkillWorkBuddy 里最核心的抽象是 Skill。你可以把它理解成“一个描述任务的模板”里面定义了任务的目标、输入参数、输出格式以及要用到的模型指令。我建 Skill 的入口在“Skill 管理—新建”。表单里要求填名称、描述、输入参数、输出结构和 Prompt 模板。给大家看一下我当时填的关键内容name: weekly_report_aggregator description: 聚合各小组周报文本并生成结构化周报 input: raw_text: string # 原始消息或表格内容 week_end_date: string # 周报周期结束日期例如 2025-06-06 source_type: [wechat, dingtalk_table, obsidian] # 数据来源类型 output: template: | # 本周工作汇总 ## 项目进度 ... ## 风险问题 ... ## 下周计划 ... prompt_template: | 你是一个周报汇总是助手。请根据以下原始内容按三个维度整理信息 1. 项目进度列出本周完成的事项、进展、里程碑。 2. 风险问题列出需要关注的风险、阻塞项或待协调问题。 3. 下周计划提取明确的计划性内容。 要求原文有冲突时保留具体描述不要自行推断。这里有一个我自己摸索出来的技巧输出结构一定要提前定义好尤其是你后续还要把内容推给其他人或者其他系统的时候。如果让模型自由发挥它可能每次生成的标题都不一致后续做自动排版会很痛苦。4.2 第二步用连接器把数据源接进来Skill 定义好后下一步就是让它能拿到数据。我在 WorkBuddy 的连接器中心里选择了“钉钉多维表”连接器并完成了授权。授权完成后连接器会列出你有权限访问的所有多维表格选中对应的表再选择要读取的字段。这一步本质上是在生成一个结构化的数据映射WorkBuddy 会知道“哪一列是小组名称”“哪一列是周报正文”。配置时需要注意字段类型。比如“日期”字段有的表存的是字符串有的是时间戳。如果 WorkBuddy 读取到的字段类型和 Skill 里定义的输入不匹配处理时会出现解析错误。我当时就把“提交时间”字段忽略掉了因为我的分类维度只需要小组名和正文文本。对于聊天记录这类非结构化数据源WorkBuddy 的做法略有不同。它需要先通过消息接口把指定时间段内的消息抓取下来再交给模型做清洗。我在配置企业微信消息读取时设定了“只看群里 我 或包含 #周报 标签的消息”这样可以避免把日常闲聊也卷进来。这里的思路其实就是连接器负责“取数”Skill 负责“加工”。先把数据源定位好再考虑加工规则。4.3 第三步写自定义指令把“规则”说清楚Skill 负责定义任务模板自定义指令则负责定义“偏好”。什么意思如果你用 WorkBuddy 做过几件事就会发现同样的模型能力指令写得好不好结果差别非常大。比如同样是生成周报如果只给它一句“帮我写周报”它大概率会输出一篇很泛的模板但如果你把“不要使用感叹号”“项目进度用编号列出”“风险问题如果存在直接写明负责人”这些规则写进去它产出的内容基本可以直接用。我整理的这套周报指令大致长这样# 角色 你是一位严谨的运营助理负责汇总各部门周报。 # 处理规则 1. 从输入文本中识别出 5 个小组的周报内容删除闲聊、表情和无关引用。 2. 按“项目进度 / 风险问题 / 下周计划”三栏归类。 3. 每个小组占一个小节小组名称用加粗。 4. 若某个小组缺少“下周计划”在该小组下标注“未填报”。 5. 全文中不要出现猜测性描述信息缺失时直接说明缺失。 # 输出格式 仅输出 Markdown 格式的周报正文不要输出任何解释性文字。这里有个细节想提醒大家自定义指令并不是越长越好。我自己一开始写了满满一屏模型每次执行的时候反而容易“抓不住重点”。后来我把规则精简成十条以内的核心条款执行效果明显更稳定。WorkBuddy 的指令系统适合“约束边界”不适合“灌输知识”。真正背景信息多的时候应该放到 Skill 的数据上下文里而不是塞进指令。4.4 第四步设定定时触发让任务自动运行任务逻辑跑通之后我在 WorkBuddy 的“自动化—定时任务”里创建了一个每周五下午 5 点 30 分执行的任务。触发条件配置如下触发频率每周执行时间周五 17:30执行动作调用 weekly_report_aggregator Skill输入为本周聊天记录 钉钉多维表内容完成后回调将生成结果发送到“周报审核群”并 我关于定时任务有一个非常重要的经验不要把时间定在下班前最后一分钟。如果你的任务是 17:30 执行但是数据源里的记录有时滞比如某个小组 17:25 才提交那跑出来的结果就会缺内容。我当时把任务定在周五 17:30结果第二周就翻车了——有个小组 17:29 才把周报填进表格里WorkBuddy 读取的时候自然没抓到。后来我把时间改到了 18:00并在指令里加了一句“如果某小组数据为空以 17:45 前入库的记录为准”问题就解决了。这背后其实是一个很朴素的道理自动化的稳定性往往取决于对数据源时滞的容忍度。不要指望所有人和机器都按你的节奏来定时任务要留出缓冲时间。4.5 第五步跑一次完整任务看它到底干了什么第一次运行的时候我没敢直接让它推送到群里而是选择“只生成草稿不发送”。WorkBuddy 支持在任务执行后先落地一个中间结果我检查确认无误后再手动触发发送。这个“先草稿后发送”的习惯建议所有人在早期都用上。第一次跑出来的结果整体让我满意。它确实把五份内容不同风格的周报归纳成了统一结构项目进度、风险问题、下周计划三栏区分得很清晰。但它也出现了一个小问题有个小组在聊天记录里写的是“基本完成”在多维表里写的是“还在测试中”WorkBuddy 选择了“还在测试中”。为什么会这样因为我在指令里写了“原文有冲突时保留具体描述”它在判定时认为表格数据语义更明确。这个取舍逻辑是我预先没考虑到的但结果也能接受。如果更敏感的内容我会在审核阶段发现并修正。这也提醒我AI 的“判断”不一定每次都符合你的预期但只要你给了足够清晰的优先级规则它大概率能把偏差控制在可接受范围内。5. 我把同一个任务复用到其他场景整理聊天记录和定时发送5.1 场景一把群聊记录变成可检索的会议纪要周报任务跑通后我开始尝试迁移这套流程。第一个复用的是“会议纪要整理”。我们每周还有一次项目例会会议通常在一个小时左右微信群里的消息记录特别凌乱有语音转文字、有随手拍照、有别人发的文档链接。过去这些记录最后基本就是沉底了很难追溯。我用 WorkBuddy 搭了一个“会议纪要整理” Skill输入是会议时间段的聊天记录输出是“议题—结论—待办含负责人”的结构化纪要。这个 Skill 的指令里我额外加了一条“如果一条消息是一条待办必须保留发布人的名字并在待办开头标注 给负责人。” 这一步很重要因为例会讨论常常是大家你一句我一句光有结论没有责任人纪要价值会大打折扣。执行效果方面第一版能覆盖七成左右的正确率。剩下三成主要是口语化表达比较重的内容比如“那个东西回头弄一下”“这个要跟一下”模型很难判断到底是谁的待办。后来我在指令里加了“如果待办的主语不明确输出时标记为‘待确认’”这类规则人工复核的时间进一步缩短了。5.2 场景二定时发送微信消息把提醒信息送到人另一个高频需求是“定时提醒”。当时我们负责的项目需要每周一早上向管理层发一条“上一周数据概览”内容是几个核心指标的一句话总结加一屏可视化链接。过去我每周一上班第一件事就是赶这个现在我在 WorkBuddy 里建了另一个 Skill流程是从多维表格读取上一周的核心指标数据通过模型生成一句摘要调用消息连接器把摘要和链接推送到指定微信群。这个流程最关键的地方在于消息连接器的鉴权。第一次配置完成后定时任务触发时提示“发送失败”排查后才发现是消息机器人的 webhook 过期了。WorkBuddy 在连接器管理页有“令牌刷新”入口重新授权后问题就解决了。说实话这个场景的技术难度不大但收益很直接。每周一早上的人肉赶工取消之后我的周一焦虑明显缓解了不少。5.3 一个值得注意的边界WorkBuddy 不是万能的虽然 WorkBuddy 能处理不少事务型任务但我必须诚实地说它有自己的边界。我最开始也尝试过让它承担更多决策类工作比如根据周报内容自动给出项目健康度评分或者判断某个风险是否要升级为“红色预警”。这些任务它也能做但输出的判断标准很难稳定因为影响决策的因素往往不在文本里而在你对团队和历史背景的理解里。所以我的建议是把 WorkBuddy 定位成“信息处理助理”而不是“决策者”。它能帮你把信息整理到“人可以直接判断”的程度但最终的判断最好还是由人来完成。如果你一开始就抱着“让 AI 全自动把关”的心态大概率会失望。6. 常见问题与排查技巧实录6.1 界面里没有看到 claw / 实验功能入口怎么让它显示在社区和搜索热词里有不少人问“WorkBuddy 没有看到 claw 怎么让他显示”。我理解“claw”指的应该是 WorkBuddy 里的一个高级功能模块或实验性能力入口。这个问题大概率不是你没装好而是功能开关被藏起来了。我遇到的情况是WorkBuddy 的主界面默认只展示稳定的核心功能一些实验性或需要更高权限的能力需要手动开启“开发者模式”或“实验性功能”开关。排查步骤可以按这个顺序来进入“设置—通用”看看有没有“开发者模式”或“启用实验功能”的选项打开后重启客户端。确认当前账号的权限等级。部分功能可能仅对管理员或认证用户开放普通账号即使打开了开关也看不到。检查客户端版本。这类功能入口通常会随版本迭代调整建议升级到最新版。我自己的经验是这类功能入口隐藏得非常深而且不同版本的菜单位置还不一样。最直接的方法是搜索官方更新日志或者直接在社区里搜对应版本的界面截图比自己瞎点效率高得多。6.2 配置目录前面有个“点”文件却找不到怎么回事这个问题真的很经典。WorkBuddy 的配置目录有时会以“.”开头比如.workbuddy/或.config/workbuddy/这类形式。在 Windows 的资源管理器里默认情况下是看不到这类隐藏文件夹的在 Linux 或 macOS 下终端里用ls也可能默认不显示。如果你遇到“明明按照文档说的目录去查却找不到文件”大概率不是文件不存在而是你的文件管理器没显示隐藏文件。在 Windows 上在“查看”选项卡里勾选“隐藏的项目”。在 macOS 上在 Finder 里按Command Shift .。在 Linux 上用ls -a查看隐藏目录。此外WorkBuddy 可能还支持通过环境变量来指定或查看配置目录比如WORKBUDDY_HOME。如果找不到配置位置可以在终端里输入echo $WORKBUDDY_HOME看看是否被指定过。这是一个很隐蔽但很实用的排查路径。6.3 把千问 3.8 本地部署到 WorkBuddy效果怎么样这是很多在意数据安全的人都会考虑的问题。我也想尝试把本地模型接入 WorkBuddy这样数据不出内网安全性更有保障。我的实际测试结论是能跑但对复杂任务的执行能力和云端模型有差距。本地部署一个小参数量版本模型做简单的信息提取和文本分类还好但一旦涉及多轮指令理解比如“先分类再汇总同时排除某些关键词并格式化成指定结构”它偶尔会漏掉部分指令输出格式也不够稳定。如果你所在团队对数据出境有严格要求一定要本地部署我的建议是优先选择参数量更大、指令遵循能力更强的本地模型而不是为了省资源选最小号。简化指令复杂度。把一个大任务拆成几个小 Skill 顺序执行比让一个模型一次做完更稳。在关键节点保留人工审核。毕竟输出质量直接决定你的工作成果。6.4 钉钉多维表定时同步失败怎么定位问题我遇到过几次“连接器配置正常但是定时同步时拉不到数据”的情况排查思路大致如下先确认本次定时任务是否真的触发了。在 WorkBuddy 的执行日志里能看到每次任务的运行状态、耗时、成功或失败原因。如果是数据为空基本可以判断是“读取”环节的问题多和数据源权限、字段映射有关。如果报错是“鉴权失败”去连接器管理里刷新授权这类问题往往是你或管理员改了密码、重置了令牌导致的。最后一步才是怀疑模型问题。我见过不少人在模型层面反复调试结果发现是上游数据没读进来白忙了一场。我的习惯是先看日志再查权限最后才碰模型和指令。排查顺序对了问题通常很快就能浮出水面。6.5 一个容易被忽略的坑指令和 Skill 中不要存“个人语气偏好”最后说一个我踩过比较深的坑。一开始我为了让生成的周报读起来更自然在指令里写了一大堆“语气要温和”“结尾要表达感谢”之类的描述。结果周报生成出来之后虽然整体通顺但有一部分内容变得过于客气比如把一条本来很严肃的风险提示写成了“这个风险可能需要大家稍微关注一下”反而弱化了信息。后来我才意识到办公自动化里“语气”是一种高风险设定。它不像是写营销文案需要亲和力办公室场景里信息的准确性和优先级才是最重要的。如果你也要把 WorkBuddy 用在正式的工作输出中建议把“语气”相关的要求收敛为“简洁、客观、不使用夸张表述”而不是鼓励模型自由发挥情绪。7. 写在最后的几点体会WorkBuddy 用到现在我最大的体会是工具本身不神奇神奇的是你对自身工作的拆解能力。你越清楚自己的任务里哪些是重复的、哪些需要判断越能把它用好。如果你之前只是把 WorkBuddy 当聊天机器人用想让它“帮你写一段文字”那你可能只发挥了它百分之二三十的潜力。不妨试着从手头最琐碎的那件事开始拆解比如每周的数据汇总、每天的日报整理、周期性的信息分发。把它做成一个 Skill配上对应的连接器和指令然后让 WorkBuddy 准时帮你跑一次。你可能会发现原来需要三个小时的工作最后真的能被压缩成十分钟的人工复核。最后再分享一个小技巧把你在不同任务里调优过的指令存成“个人指令库”放到一个固定笔记或 WorkBuddy 的公共指令区域里。这样以后换电脑、换工作台、或者同事想复用你的流程都能一键拿到。这批调试好的指令才是你整个方案里最值钱的部分。
RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进