# Slack只给审批闸门3秒，人工决定却可等上数月

> 六个步骤，让 Agent 每次退款或发邮件前先经 Slack 人工审批，并配好超时、兜底和审计日志。

原文: https://fdetimes.net/zh/guides/slack-approval-gate-for-ai-agents/

用户点击按钮后，Slack 只给你的应用 3 秒时间响应。而 Cloudflare Agents 文档里描述的审批闸门，可以等上几个月甚至更久，期间无需让 Agent 一直运行。

好的审批闸门必须同时做到这两点：几乎立刻确认点击，同时耐心等待决定，等多久都不丢状态。

设想你的 Agent 刚获得权限，可以退款、给客户发邮件或修改客户关系管理（CRM）记录。客户首先会问：最后那个按钮由谁来按？

本文演示如何给出答案：Agent 在做任何重要操作前先到 Slack 请求审批，并配有超时、兜底路径和日志。

## 要构建什么，需要准备什么

场景如下：客服 Agent 提议为一笔订单退款 200 万越南盾（VND）。调用退款工具前，它先在财务团队的 Slack 频道发一条消息，写明订单号、金额和原因，并附上 Approve 和 Reject 两个按钮。随后 Agent 暂停。有人点击后，它要么继续执行，要么取消。

如果没人点击，请求会再次发送作为提醒，之后自动拒绝。

你需要一个测试用的 Slack 工作区，能在其中创建支持交互功能的应用；还需要一个支持有状态暂停的 Agent 运行时。本文介绍两种选择：Cloudflare Agents（使用 `waitForApproval()`，运行在 Cloudflare Workflows 上）和 LangChain（使用其人在回路中间件）。

下面的代码块都是用来说明流程的**简化示意**，确切的函数签名请查阅框架文档。

## 第 1 步：不是每个工具都需要人工审批

最常见的错误是所有操作都要求审批。设想审批人每天收到 40 条无害查询的审批消息：他们很快就会不看内容直接点 Approve，闸门也就成了走过场。

Cloudflare 的建议很明确：只对后果重大的操作要求确认，例如付款、邮件和数据修改。

LangChain 把这一原则变成了配置。HITL 中间件接受 `interrupt_on` 参数，把每个工具映射到它允许的决定类型。先把策略写成数据：

```python
# 示意：审批策略表
# 这里的决定类型名称仅作示例；
# 确切列表请以 LangChain 的 HITL 文档为准。
interrupt_on = {
    "issue_refund":   {"allowed_decisions": ["approve", "edit", "reject"]},
    "send_email":     {"allowed_decisions": ["approve", "reject"]},
    "update_crm":     {"allowed_decisions": ["approve", "reject"]},
    "search_orders":  False,   # 只读，无需审批
}
```

**检查：**把这张表打印出来，和客户方的流程负责人逐行过一遍。如果对方说不清某个工具为什么需要审批，那它多半不需要。

## 第 2 步：等待闸门必须扛得住连接断开

一个审批请求可能要挂一整晚，甚至一个周末。如果状态只存在内存里，一次重新部署就会全部清空。LangChain 要求配置 checkpointer，在中断期间持久化图状态。Cloudflare 建议把待审批请求存进 Agent 的 state，这样连接断开也不会丢失。

```ts
// 基于 Cloudflare Agents 的示意
const decision = await this.waitForApproval({
  action: "issue_refund",
  args: { orderId: "DH-1042", amount: 2000000, reason: "发错商品" },
});
```

关键在于：根据 Cloudflare 文档，`waitForApproval()` 会创建一个运行在 Workflows 上的持久化闸门，等待期间不会占用正在运行的 Agent。如果使用 LangChain，上生产环境时要选择把状态写入持久化存储的 checkpointer，而不是只存在内存里的那种。

**检查：**发出一个审批请求，重启服务，再点击 Approve。Agent 必须从原来停下的地方继续，参数完全一致。

## 第 3 步：Slack 消息必须准确说明将要发生什么

审批人只能根据看到的信息做决定。Cloudflare 建议准确展示操作将要做什么，并列出全部参数。“Agent 想退款，是否批准？”这样的消息远远不够。要写清楚：“订单 DH-1042 退款 2,000,000 VND，原因：发错商品，退回客户原支付账户”。

邮件同理：审批消息里要放上确切的主题、收件人和正文，而不是摘要。审批人读到的内容，必须与 Agent 将要发出的完全一致。

**要点:** 审批人拦不住自己看不到的东西：工具调用的每个参数都必须出现在审批请求里。

## 第 4 步：3 秒内回复 Slack，重活之后再做

审批人点击按钮后，Slack 会向你的端点发送 payload，并要求在 3 秒内收到响应。如果处理函数在回复前要写数据库、唤醒 Agent、调用退款 API，很容易超时。

```ts
// 交互处理函数示意
async function onSlackAction(payload) {
  enqueue({ approvalId: payload.actionValue, user: payload.user,
            decision: payload.actionId, responseUrl: payload.responseUrl });
  return new Response("", { status: 200 }); // 立即回复
}
```

真正的工作随后在后台 worker 中执行。完成后，通过 `response_url` 更新原消息。Slack 允许在收到 payload 后 30 分钟内向 `response_url` 最多发送 5 次，足够先显示“处理中”，再显示“已退款”。

**检查：**在处理函数开头和结尾记录时间戳。即使是首次运行、一切都还是冷启动，耗时也必须低于 3 秒。

## 第 5 步：没人点击怎么办？

很多演示在这里偷工减料。审批人在休假，Slack 频道被设成免打扰，请求无限期挂着，客户却还在等钱。Cloudflare 建议用 `schedule()` 在合理时间后升级或自动拒绝。

```ts
// 示意：4 小时后提醒，24 小时后自动拒绝
await this.schedule(4 * 3600, "escalateApproval", { approvalId });
await this.schedule(24 * 3600, "autoRejectApproval", { approvalId });
```

4 小时和 24 小时只是示例。真实阈值要和客户商定：小额退款可以等一天，但给 VIP 客户的道歉邮件可能一小时就要升级。做出决定后，记得取消剩余的定时任务，以免把已经批准的请求又自动拒绝了。

## 第 6 步：拒绝要有兜底，每次决定都要记录

在 LangChain 中，`reject` 决定会拒绝这次工具调用，并把反馈发给 Agent，而不是执行它。Agent 收到原因，比如“已给客户补发商品，不退款”，就能重新起草给客户的回复。Cloudflare 也建议始终为操作被拒绝的情况准备兜底方案。

Agent 被拒绝后就没了下文，这是产品缺陷，不是安全特性。

最后是审计日志。Cloudflare 建议用 `this.sql` 记录每一次审批决定，以满足合规要求。

```ts
// 审计表示意
this.sql`INSERT INTO approvals
  (approval_id, action, args_json, decided_by, decision, decided_at)
  VALUES (${id}, ${action}, ${JSON.stringify(args)}, ${user}, ${decision}, ${now})`;
```

**检查：**跑三个场景：批准、拒绝和超时。每个场景都必须在表里留下恰好一行，记录做决定的人（自动拒绝则记为“system”）。

## 常见错误

第一，让 Slack 处理函数同步完成所有工作，很容易突破 Slack 对 payload 响应设定的 3 秒限制。第二，审批消息只做摘要，没有列出参数。第三，把待审批请求放在内存里，第一次部署就全部丢失。

第四个更难发现：没有检查点击的人是否真的有审批权限。接受决定前，要把 payload 中的 `user` 与该工具的审批人名单进行比对。

## 这项技能在客户现场是什么样子

你通常没法自己安装应用。据 Slack 介绍，工作区所有者和管理员控制着哪些 Agent 应用可以添加。所以第一次会议应该同时请来 Slack 管理员和业务流程负责人，第 1 步的策略表就成了双方共同签字确认的文档。

如果你的目标是前线部署工程师（FDE）岗位，就把这件事具体写进简历：“为付款和邮件工具设计了审批闸门，具备超时自动拒绝和审计日志”。在职位描述里，“human-in-the-loop”“approval workflow”或“compliance”这类字眼，说明公司需要的正是这项技能。

值得信赖的 Agent 并非从不出错，而是知道在哪里停下，并且每次停下都留有记录。

**本周动手试试:**

- 列出你正在开发的 Agent 中的所有工具，标出哪些涉及付款、发邮件或写数据，并把结果整理成一张审批策略表。
- 做一个带 Approve/Reject 按钮的小型 Slack 应用，让处理函数立即回复、随后再处理，并测量响应时间，确保低于 3 秒。
- 加一张审计表，记录审批人、时间、参数和决定，然后测试无人点击的场景，看超时后请求是否会被自动拒绝。

## 信源

- [Human in the Loop · Cloudflare Agents](https://developers.cloudflare.com/agents/concepts/human-in-the-loop/)

- [Human-in-the-loop - LangChain docs](https://docs.langchain.com/oss/python/langchain/human-in-the-loop)

- [Handling user interaction - Slack Developer Docs](https://docs.slack.dev/interactivity/handling-user-interaction)

- [Slack AI Agents](https://slack.com/ai-agents)
