FDE Times 数据在招 FDE 职位 924▲33 近 7 天在招职位数的变化(同口径比较):不计入本周新开始追踪的公司的职位近 7 天新增 80在招公司 196支持远程 25%美国薪资中位数 $200k招聘最多 Databricks 107
ENVI

前线部署工程师(FDE)的专业媒体

技能指南 · 指南

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

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

审批闸门必须在 3 秒内响应点击,却可以为一个决定等上几个月。
图片:Ajay Suresh from New York, NY, USA / CC BY 2.0
分享微博

要点速览

  • 只对有实际后果的操作要求审批:付款、邮件和数据修改。
  • 审批闸门必须持久化:保存待审批状态,设置超时,记录每一次决定。
  • 接入 Slack 时,3 秒内确认按钮点击,重活放到之后再做。
审批闸门流程图:Agent 通过 waitForApproval() 暂停,可以无限期等待;Slack 显示 Approve/Reject 两个按钮;处理函数(橙色高亮)在 3 秒内返回 200;后台 worker 执行退款并写入审计日志;随后 Agent 从原来停下的地方继续。
审批闸门有两个节奏:处理函数必须在 3 秒内响应点击,而 Agent 可以无限期等待决定且不丢状态。资料来源:Slack 和 Cloudflare 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 参数,把每个工具映射到它允许的决定类型。先把策略写成数据:

# 示意:审批策略表
# 这里的决定类型名称仅作示例;
# 确切列表请以 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,这样连接断开也不会丢失。

// 基于 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,很容易超时。

// 交互处理函数示意
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() 在合理时间后升级或自动拒绝。

// 示意: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 记录每一次审批决定,以满足合规要求。

// 审计表示意
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 并非从不出错,而是知道在哪里停下,并且每次停下都留有记录。

这篇文章对你有帮助吗?

4 个信源
路线图上的下一篇 · 阶段 5: 部署上线Agent 为何能在一个工单上空转一整夜却不报错四层限制加上预先设计好的人工交接点,才能防止 Agent 循环无休止空转、烧掉客户的钱。