第 28 次课:把 Hermes Agent 接上国产模型和飞书 ​

一、上节课回顾 ​

上节知识要点:

  • 上节课把 Codex 在国内跑通:离线安装包装上、CCSwitch 接上 DeepSeek、三种模式逐个切过。
  • 跑通三步法:装得上 → 连得上 → 用得动,这节课换到第二个工具继续用。
  • 这节课的主角是 Hermes Agent。它不是装完就能用,要自己配好模型供应商才有反应。

二、本节课任务与安排 ​

本课交付

这节课把第二个 Agent 工具跑通用起来:Hermes Agent 装上、接上国产模型、绑到飞书、跑一个真实小任务验证。

你会得到一个能接收飞书消息的 Hermes Agent,外加一次成功的端到端任务记录。

顺序环节学生产出时间
回顾回顾上节课想起跑通三步法5分钟
交付看跑通后的 Hermes 演示知道本课交三样3分钟
理论理论基础:Hermes Agent 是什么能说出它和 WorkBuddy 的区别10分钟
案例1🔧 案例1:装上 Hermes AgentHermes 启动并能对话12分钟
案例2🔧 案例2:配好 Provider 接上模型国产模型能回复15分钟
案例3🔧 案例3:绑定飞书机器人飞书里能收到 Hermes 回复15分钟
案例4🔧 案例4:跑一个真实小任务一条端到端任务记录12分钟
收尾回扣跑通思路能复述 Hermes 特色3分钟
机动等待与排错补齐必做成果5分钟
扩展扩展任务:把 Hermes 变成你的每日简报助手(选做)简报任务配置10分钟

上课前完成课前准备,按老师发的安装包开始安装。

环境与准备:Windows 10/11;本机课程目录 D:\AIGC\lesson-28;Hermes 安装包与 DeepSeek API Key 由教师统一发放。教师侧准备项见 [课前演练补充]。

三、理论基础:Hermes Agent 是什么 ​

先想 WorkBuddy 的一个限制:窗口一关它就下班了。今天的 Hermes 可以常驻后台、接消息、定时干活——但要先告诉它「去哪找模型」,这一步叫配 Provider,是今天的第一关。

Hermes Agent 是一个能常驻电脑的通用 Agent。 它和 WorkBuddy 的区别:WorkBuddy 打开才能用,Hermes 可以在后台跑任务、接消息、定时干活。它自己不带模型,要你告诉它「去哪里找模型」,这一步叫配置 Provider。

Provider 是模型的供应商入口。 Hermes 支持多家:DeepSeek、Kimi、GLM、MiniMax、OpenRouter 等。你选一家、填上 API Key,Hermes 就能调用这家模型干活。上节课 CCSwitch 里学过的「一键切换」,在这节课同样能配合使用。

网关是 Agent 的对外接口。 Hermes 支持把消息接入 Telegram、Slack、飞书等聊天工具。接上飞书之后,你在飞书里发一句话,Hermes 就能帮你跑任务并回结果,这是它区别于 WorkBuddy 最大的特色。

四、实操环节 ​

案例1:装上 Hermes Agent ​

任务目标:

把 Hermes Agent 装到 Windows 电脑上并启动。这个工具官方推荐从命令行安装,机房网络受限时改用教师提前装好的镜像或离线包。

实操步骤

  1. 找到教师发放的 HermesAgent安装包.exe,一般保存在桌面或下载文件夹。执行后你会看到:文件图标存在,右键「属性」能看到文件大小。

  2. 双击安装包运行,按向导点「下一步」直到「安装」。执行后你会看到:桌面或开始菜单出现 Hermes 图标。

  3. 双击 Hermes 图标启动。首次启动可能加载十几秒。执行后你会看到:Hermes 主界面打开,提示需要配置模型。

  4. 在输入框随便发一句「你好」,顺便核对安装信息:

    text
    你好,请告诉我你目前的版本号和可用工具清单。
    输入素材:
    我刚把 Hermes Agent 装到 Windows 11 电脑上,
    安装包由教师发放,尚未配置任何模型供应商。
    输入素材结束。

    执行后你会看到:回复可能报「模型未配置」之类的错误,这是正常现象,下一案例解决它。

    查什么合格的样子
    装得上桌面或开始菜单出现图标,双击能启动
    开得了对话输入框能输入,发送后有响应(报「模型未配置」也算)

扩展练习(选做)

想弄清楚 Hermes 和 WorkBuddy 差在哪:

  1. 并列打开两个工具,各自新建一条对话,观察启动速度、界面布局和默认能力的差异,写在扩展记录里。
  2. 执行后你会看到:至少列出两条差异。时间不够直接进案例2。

案例2:配好 Provider 接上模型 ​

任务目标:

给 Hermes 配上 DeepSeek 模型,替代默认的空 Provider。这是本课核心步骤,配通了 Hermes 才真正能干活。

实操步骤

  1. 打开 Hermes,进入模型配置页面(一般在设置或首次启动向导里)。执行后你会看到:一个供应商列表,包含 Nous Portal、OpenRouter、DeepSeek、自定义端点等选项。

  2. 选「DeepSeek 官方」,把教师发的 API Key 粘贴进去:

    text
    供应商类型:DeepSeek 官方
    API Key:粘贴你自己的 Key
    默认模型:deepseek-chat
    输入素材:
    Key 已由教师课前发放,以 sk- 开头;
    适用工具为 Hermes Agent,默认模型选 deepseek-chat。
    输入素材结束。

    执行后你会看到:配置保存成功,供应商状态变为可用。

  3. 在对话里发一句测试:

    text
    你好,请用一句话自我介绍。

    执行后你会看到:DeepSeek 模型返回正常回复,不再报「模型未配置」。

  4. 打开 CCSwitch(上节课装的),确认它能识别到 Hermes Agent。执行后你会得到:CCSwitch 的工具列表里能看到 Hermes,下次换供应商可以直接在 CCSwitch 里切。

    查什么合格的样子
    配得上DeepSeek 供应商状态变为可用
    用得动Hermes 对话有正常回复,无「模型未配置」报错
    可切换CCSwitch 里能看到 Hermes,能切换到其他供应商

扩展练习(选做)

想多接一家试试:

  1. 在 Hermes 里再加一个供应商(如 Kimi 或 GLM),填 API Key 保存,切换两次看响应差异。
  2. 执行后你会看到:至少两家供应商都能用,切回去切过来都正常。时间不够直接进案例3。

案例3:绑定飞书机器人 ​

任务目标:

把 Hermes 接入飞书,在飞书里发一句话让 Hermes 回复。这一步是 Hermes 的特色能力,WorkBuddy 没有这个玩法。

飞书接入走「社区通用流程」:飞书开放平台创建自建应用,配事件订阅,Hermes 侧启用飞书网关。不同版本的按钮文字略有差异,教师课前按机房实际版本演练并补充截图说明:[课前演练补充]。

实操步骤

  1. 打开浏览器,登录飞书开放平台,进入「开发者后台」。执行后你会看到:能新建应用的入口页面。

  2. 新建一个企业自建应用,应用名叫「我的 Hermes 助手」。执行后你会看到:应用创建成功,得到一个 App ID 和 App Secret。

  3. 把 App ID 和 App Secret 填到 Hermes 的飞书网关配置里,素材已内嵌:

    text
    网关类型:飞书
    App ID:粘贴你自己的 App ID
    App Secret:粘贴你自己的 App Secret
    输入素材:
    应用名「我的 Hermes 助手」;
    权限开启「接收消息」和「发送消息」两类;
    事件订阅选「接收消息」事件。
    输入素材结束。

    保存后回到飞书应用后台,开通「接收消息」等相关权限。执行后你会看到:Hermes 日志里出现「网关已连接」或飞书侧显示「应用已启用」。

  4. 在飞书聊天框里找到你的应用,发一句:

    text
    你好,请告诉我你能做什么。

    执行后你会看到:飞书里收到 Hermes 的回复消息,说明双向链路已经打通。

    查什么合格的样子
    应用建好飞书后台能看到应用,App ID 和 Secret 已拿到
    网关连上Hermes 侧显示网关已连接或应用已启用
    飞书可收发飞书里发消息,Hermes 能回

扩展练习(选做)

想加一个定时提醒:

  1. 在飞书里发一句:

    text
    每天上午 9 点提醒我喝一杯水。
  2. 执行后你会看到:Hermes 确认定时任务已创建,第二天上午收到飞书提醒。时间不够直接进案例4。

案例4:跑一个真实小任务 ​

任务目标:

用跑通的 Hermes 做一件完整的小事,验证「飞书消息进来 → Hermes 干活 → 飞书回结果」整条链路真的可用。

实操步骤

  1. 在飞书里发一个真实小任务,素材已内嵌:

    text
    请根据下面这段课程信息,帮我整理成一张简洁的课程表,
    用消息发回来。
    输入素材:
    第 27 次课:把 Codex 在国内跑通并用起来,主讲安装与配置。
    第 28 次课:把 Hermes Agent 接上国产模型和飞书,主讲配置与飞书接入。
    第 29 次课:DeepSeek Harness 架构与配置,主讲一切皆插件。
    输入素材结束。

    执行后你会看到:Hermes 回复一张格式清晰的三行课程表。

  2. 换一个任务再跑一次,验证稳定性:

    text
    请把下面这段话总结成一句话发回来。
    输入素材:
    这门课面向零基础学生,从 WorkBuddy 一路学到 Codex、
    Hermes Agent 和 DeepSeek Harness,重点不是做案例,
    而是学会把不同的 AI Agent 工具装上、配置好、用起来,
    能按需挑工具、换模型、接聊天软件。
    输入素材结束。

    执行后你会得到:一条精炼的总结消息,说明 Hermes 不只回固定的模板话,而是真的读懂了内容。

    查什么合格的样子
    任务能跑飞书里收到课程表,格式正确
    结果可复两个不同任务都能正常回结果
    链路完整从发消息到收结果全程没切换应用

扩展练习(选做)

想让 Hermes 干更复杂的活:

  1. 在飞书里发一句:

    text
    请列出我这台电脑 D 盘 lesson-28 文件夹里有哪些文件,
    并告诉我哪个文件最大。
  2. 执行后你会看到:Hermes 调用电脑工具列出文件清单并指出最大文件。时间不够直接进课后巩固。

扩展任务:把 Hermes 变成你的每日简报助手(选做) ​

任务目标:

把今天的跑通成果升级成能每天用的自动化:让 Hermes 每天早上在飞书里推一份简报。

实操步骤

  1. 复制下面的提示词直接发送,素材已内嵌可直接运行:

    text
    请帮我设置一个每日简报任务:
    每天早上 8 点,把今天的日期、一句鼓励话、一条 AI 领域小知识
    组合成简报,通过飞书发给我。
    小知识从下面这份清单里按顺序轮换,不要重复。
    输入素材:
    AI Agent 是能自主决策并调工具的智能体。
    MCP 是模型和外部工具之间的通用接口。
    提示词工程是通过话术引导模型输出的方法。
    RAG 是让模型先查资料再回答的检索增强方案。
    输入素材结束。

    执行后你会看到:Hermes 确认定时任务已创建。

  2. 手动触发一次预览,看简报长什么样:

    text
    请现在先推一份今天的简报预览给我看。

    执行后你会得到:飞书里收到一份预览简报,格式符合模板。

五、总结与巩固 ​

随机请两位同学 1 分钟展示:我的 Hermes 接的哪家模型、飞书里跑的第一个任务是什么、哪里还卡住。

回想本课跑通思路:装上 → 配 Provider → 接飞书 → 跑任务验证。和 Codex 那节课的「装得上 → 连得上 → 用得动」是同一套思路,只是每一步的具体操作换了。

说一说:Hermes 的哪个特色是你觉得 WorkBuddy 短期内做不到的?为什么?

下节课的 DeepSeek Harness 更「极客」,它不给图形界面,所有配置都要自己动手写。今天这套跑通思路,下节课继续用。

六、资料与下载 ​

  • 课前准备:安装包来源、飞书开放平台入口、API Key 领取。
  • 课程资料:本课素材清单与下载位置。

延伸视频

推荐观看:飞书开放平台机器人接入原理。