首页 > AI教程 >WorkBuddy 双Agent实战：大吉+Hermes搭建无人工厂，附IMA知识库接入踩坑

WorkBuddy 双Agent实战：大吉+Hermes搭建无人工厂，附IMA知识库接入踩坑

来源：互联网 2026-07-11 06:31:12

通过WorkBuddy部署双AI助手（大吉、Hermes）协作，以IMA知识库为共享信箱实现解耦，Windows端负责本地任务，Ubuntu端处理长任务。OpenAPI接入需注意自定义请求头与/wiki/v1/路径。人工中转仍是必要环节，强调token纪律与信源分级。

这篇文章大约2000字，包含可直接复制使用的命令、架构图以及真实踩坑记录。如果你正打算用WorkBuddy实现多Agent协作，或想搭建知识库自动化系统，按照本文思路即可复现。

一、为何要将一个Agent拆分为两个？

使用WorkBuddy一段时间后，会发现明显瓶颈：将所有任务堆给一个对话窗口，上下文很快被历史记录撑爆。长任务执行中途，容易遗忘最初目标。更麻烦的是，手头同时有Windows主力机和一台Ubuntu机器，两边的记忆无法同步。

长期稳定更新的攒劲资源： >>>点此立即查看<<<

解决方案并不复杂——让两个Agent分工协作：

大吉：运行在Windows的WorkBuddy上，主要负责写代码、整理文件、对接本地任务，并输出交接文件。

Hermes：运行在Ubuntu上，负责耗时长的任务、汇总报告，充当“群代表”对外输出结果。

关键在于，两个Agent之间不依赖实时通信，不建消息队列，也不需要调度器。它们唯一依赖的是共享知识库，相当于一个公共信箱，天然实现解耦。

WorkBuddy 双Agent实战：大吉+Hermes搭建无人工厂，附IMA知识库接入踩坑图1：WorkBuddy双窗口 / 两台机器并排工作图

二、架构：以IMA知识库为单一事实源

本设计最关键的一点：只用一个共享文件夹当信箱。这里使用IMA知识库（腾讯AI知识库），它开放了OpenAPI，允许Agent直接读写。

文件夹结构采用“三权分立”思路：

共享/：存放交接文件、汇总报告、任务元数据——两个Agent都能查看。

大吉私域/：大吉的草稿、中间产物、记忆——仅大吉可访问。

Hermes私域/：Hermes的中间产物——仅Hermes可访问。

共享/目录下再细分子目录：tasks/（任务清单）、handoffs/（交接文件）、reports/（汇总报告）、archive/（归档）、templates/（模板）。

交接文件命名规则：{任务ID}-{轮次}-{发送方}-{状态}.md。例如20260630-A3-01-daji-pending.md。每个文件小于2KB，强制在文件头部使用YAML格式标注任务ID、轮次、状态和创建时间。

WorkBuddy 双Agent实战：大吉+Hermes搭建无人工厂，附IMA知识库接入踩坑图2：IMA知识库文件夹树

这套规范最核心的好处：任何一方宕机，另一方都能从文件夹中恢复上下文，任务不会丢失。

三、IMA OpenAPI接入：401鉴权踩坑（重点）

第一次让Hermes调用IMA的OpenAPI时，直接返回401错误。排查发现根本原因不是token错误，而是传输方式不对。以下是正确做法，共三层：

① 凭据值

在IMA开放平台获取两个值：client_id 和 api_key（在知识库设置→OpenAPI中生成）。

② 如何传递（头名和位置）

不使用标准的Authorization头，而是两个自定义HTTP头：

ima-openapi-clientid: 
ima-openapi-apikey:

再加上标准头Content-Type: application/json。

③ 完整示例请求

curl -X POST 'https://ima.tencent.com/wiki/v1/knowledge/search' \
-H 'ima-openapi-clientid: YOUR_CLIENT_ID' \
-H 'ima-openapi-apikey: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"knowledge_id":"YOUR_KB_ID","query":"双Agent协作协议","top_k":5}'

路径前缀是/wiki/v1/，早期写成/api/v1/一直返回401；Content-Type必须显式指定application/json，缺失也会被拒绝。这两点是最容易踩坑的地方。

第二个坑：Hermes能用search搜索到文件，但get_media_info只返回签名URL，还需再fetch一次才能读取正文内容——不要以为search返回结果就包含完整内容。

四、协作流程如何运行（端到端6步）

1. 在大吉窗口下发命令（包含任务ID、目标和约束条件）。

2. 大吉将交接文件写入共享/handoffs/目录，并提示“去复制”。

3. 手动复制正文，然后转发给Hermes（此处涉及人工中转，原因见下一节）。

4. Hermes读取交接文件→开始执行→将汇总结果写入共享/reports/。

5. 手动复制汇总结果，粘贴回大吉的窗口。

6. 大吉将文件归档到共享/archive/，并撰写工作日志。

token铁律：不寒暄、不复述、不解释常识；引用而非转述（附上链接加一句说明即可）；单次完整任务预算控制在3000 token以内。这套纪律让两个Agent的上下文保持精简，长任务不易偏离。

五、踩过的坑 & 关键教训

最痛的坑：零手动传输无法实现。 理想情况是Agent之间自动流转，但受限于平台限制和缺乏跨机器实时通道，目前仍需人工在IMA中“复制粘贴”进行中转。因此，当前策略更倾向于“大吉单干”模式——能由一个Agent闭环完成的任务，绝不拆分；只有那些确实很长的任务，才交给Hermes处理。务实比追求架构更重要。

信源真实性执念：任何写入报告的数据，必须按照“官方 > 行业 > 集体 > 个人”的优先级分级，并附上可验证链接，否则宁可空缺。这条规则已经多次避免假消息污染知识库，从而影响两个Agent。