火星老师·赫尔墨斯代理：打造你的DeepSeek飞书机器人

如果你已经在用 DeepSeek 的网页版或 API，却还停留在「打开浏览器、复制粘贴、再复制回来」的阶段，这门课要补的就是中间那段：让模型住进飞书，让同事在群里 @ 一下就能拿到结果。它不教你大模型原理，也不讲飞书全部开放能力，只盯着一件事——把 DeepSeek 接成一个能用的飞书机器人。

先说清楚：这门课填的是哪个坑

常见的卡点有三个，你可以对号入座。

• 会用 DeepSeek，但不知道怎么让别人也用上。自己跑通了，同事还在微信里发截图问你。
• 看过飞书开放平台的文档，事件订阅、回调地址、权限范围、机器人能力这几块来回跳，配到一半不知道哪一步错了。
• 机器人跑起来了，但只会「你问我答」。多轮上下文、群聊里该不该回、超时怎么办、回复太长怎么切分，这些没处理，用两天就没人用了。

课程标题里的「赫尔墨斯代理」是这套方案的骨架：它负责把飞书那边过来的消息接住、整理成模型能吃的格式、再把 DeepSeek 的输出送回飞书。理解这一层转发关系，比记住某个按钮在哪更重要，因为换一个模型、换一个 IM，思路是通的。

跟着做的时候，重点盯这几处

搭建部分会从创建飞书应用、拿凭证、配权限开始。这里建议你别只是照着填，顺手确认三件事：机器人被允许在哪些会话里出现、事件是推给你还是你去拉、回调地址暴露在公网后有没有做校验。这三处出问题，表现都是「发了消息没反应」，但原因完全不同。

接 DeepSeek 的环节，值得留意的是消息怎么组装。飞书推过来的是结构化事件，模型要的是对话消息列表，中间要做一层转换；群聊里还要判断是不是在叫自己、要不要带上被 @ 之前的历史。这一层写得糙，机器人就会答非所问。

再往后是回复侧的处理。DeepSeek 返回慢的时候，飞书那边可能已经超时；回答长的时候，一条消息塞不下。课程里给的处理方式可以直接拿来用，也值得你想一想：如果换成流式输出，这套结构要怎么改。

配套练习建议这样安排

• 先做一个最小闭环：私聊机器人，回一句固定的话。跑通再换模型，别一上来就写业务逻辑。
• 加上多轮对话，然后故意把上下文清掉，观察回答质量的变化，体会上下文到底值多少。
• 拉一个测试群，验证 @ 才回、不 @ 不回，以及多人同时问的时候会不会串。
• 给机器人加一个明确的边界，比如只回答某类问题，其余转人工。这一步最接近真实落地。

看完应该能回答的问题

用这几个问题自查，答不上来就回去翻对应那段：飞书的事件订阅和回调，各自的触发条件是什么？机器人的凭证分别用在哪些请求里，哪个绝对不能写进前端？DeepSeek 的调用失败或超时，用户那边应该看到什么，而不是干等？群聊场景下，怎么判断一条消息该不该由你来接？如果明天要换成另一个模型，代码里哪些地方必须动？

这门课适合手上有一个具体场景的人：团队想在飞书里加个答疑助手，或者你自己想把某个重复的问答流程交出去。纯看不动手，配环境和调试那几段会很难受。建议边看边开着开放平台的后台和日志，报错信息比视频进度条更能教你东西。