Mail

你把任务交给了 AI 智能体，然后离开了座位。几小时后回来，发现它停在了中途——需要某人的审批，但没有人注意到。

Claude Managed Agents Webhook 正是为解决这个问题而生的。智能体会在发生重要状态变化时主动通知你的应用，无需等待。

Anthropic 在 2026 年 5 月的 Managed Agents 更新中，与 Dreaming、Outcomes 和多智能体编排一同发布了这一功能，从根本上改变了在生产环境中运营长时间运行 AI 智能体的方式。

1. Claude Managed Agents Webhook 是什么

Managed Agents 是 Anthropic 直接运营智能体循环和沙箱的 REST API 形式 AI 智能体。与在自己进程中运行智能体循环的 Agent SDK 不同，它在 Anthropic 的基础设施上运行。

Webhook 是这些智能体通过 HTTP 回调向应用通知重要状态变化的机制。

旧的轮询方式：

我的应用："智能体，完成了吗？"→ 等待 5 秒 → 再次确认 → 等待 5 秒 → ...

Webhook 方式：

智能体：（任务完成）→ 立即向应用发送 HTTP 通知 → 应用即时响应

轮询浪费 API 调用并产生延迟。Webhook 在事件发生的瞬间通知。任务运行时间越长，差异越明显。

2. 6 种 Webhook 事件类型

Anthropic 支持的 Webhook 事件：

事件	触发时机
会话开始	智能体会话启动时
智能体等待（Idle）	需要用户/操作员输入而暂停时
Outcome 评估完成	评分模型对结果进行评估后
多智能体线程结束	多智能体任务完成时
Vault 凭证刷新失败	存储凭证的刷新失败时
会话结束	智能体会话终止时

最重要的事件是**"智能体等待（Idle）"**。它在智能体遇到需要人工确认或额外输入的情况时触发。错过这个事件，智能体会无限期挂起。

3. 安全性：HMAC 签名与重放保护

Webhook 是来自外部的 HTTP 请求，安全性至关重要。Anthropic 默认提供多层安全保护。

HMAC 签名：所有 Webhook 载荷都包含 HMAC-SHA256 签名。应用通过验证签名确认请求确实来自 Anthropic。

重放保护：防止已处理的 Webhook 被再次处理。即使因网络错误同一事件发送两次也能安全处理。

至少一次投递：保证每个事件至少投递一次。应用临时下线后恢复时，可以重新接收错过的事件。

7 种语言 SDK 辅助工具：Python、TypeScript、Go、Java、Ruby、Rust、PHP SDK 均内置了 Webhook 验证辅助工具。

from anthropic import Anthropic

client = Anthropic()

def handle_webhook(payload: bytes, signature: str):
    event = client.managed_agents.webhooks.verify(
        payload=payload,
        signature=signature
    )
    if event.type == "agent.idle":
        # 智能体在等待输入 → 发送 Slack 通知
        notify_slack(event.session_id)

4. 三个实际使用场景

场景一：智能体卡住时发送 Slack 提醒

代码审查智能体在分析 PR 时发现了安全敏感的文件变更，需要人工审批并触发 agent.idle 事件。应用收到 Webhook 后向团队 Slack 频道发送通知，负责人迅速响应。

场景二：Outcome 评估失败时自动重试

任务结果未通过 Outcome 评分标准。outcome.evaluated 事件返回 passed: false 时，自动向智能体发送重新处理的指令。

场景三：多智能体流水线自动串联

数据收集智能体 → 分析智能体 → 报告编写智能体依次运行。每个智能体结束时通过 session.ended Webhook 触发下一个智能体。无需人工介入，整个流水线自动运转。

5. 教育科技视角：AI 智能体运营的成熟度

Webhook 是技术性功能，但在我看来，它是 AI 智能体运营"成熟度"的衡量指标。

早期 AI 智能体使用很简单：提问、获得答案。下一步是委托任务给智能体。现在进入了将智能体集成到流程中的阶段。

没有 Webhook，智能体是孤立的工具。有了 Webhook，智能体自然融入现有工作流——Slack 通知、数据库更新、触发下一个流程……这些连接让 AI 智能体成为真正的团队成员。

从教育平台的角度思考：学生作文评估智能体、课程内容自动更新智能体、学习模式分析智能体通过 Webhook 与现有 LMS 连接，AI 就不再是附加功能，而成为系统的核心轴。

使用技巧

最先处理 agent.idle 事件：为智能体卡住的情况设置警报是第一步。绝不能错过需要人工介入的时刻。
必须实现 HMAC 签名验证：Webhook 端点对互联网开放。使用 SDK 辅助工具，不要跳过签名验证。
考虑至少一次投递的特性：同一事件可能发送两次。提前实现幂等处理逻辑。
从小型流水线开始：先构建智能体 A → Webhook → 智能体 B 的两步架构。积累成功经验后再增加复杂度。

总结

Webhook 不是炫酷的功能。但如果你认真考虑在生产环境中运营 AI 智能体，它就是必不可少的基础。

"智能体执行任务" → "智能体集成到现有系统"。这一转变才是让 AI 智能体真正有用的关键差异。

您希望在自己的服务中用 AI 智能体 Webhook 实现哪些场景？欢迎在评论区分享！

参考资料

Anthropic, "New in Claude Managed Agents: dreaming, outcomes, and multiagent orchestration": https://claude.com/blog/new-in-claude-managed-agents
Anthropic, "Claude Managed Agents overview": https://platform.claude.com/docs/en/managed-agents/overview
Hookdeck, "Anthropic shipped webhooks for Claude Managed Agents": https://hookdeck.com/blog/anthropic-managed-agent-webhooks
Hookdeck, "Guide to Claude Webhooks: Features and Best Practices": https://hookdeck.com/webhooks/platforms/guide-to-claude-webhooks-features-and-best-practices
Anthropic Claude Cookbook, "Managed Agents tutorial: production setup": https://platform.claude.com/cookbook/managed-agents-cma-operate-in-production

Claude Managed Agents Webhook 完全指南 — 让长时间运行的 AI 主动唤醒你的应用

目录