SuperAPI AI 工具集

claude-managed-agents-webhooks

智能体与模型

查看项目

更新于 10-16 05:52

技能介绍

该技能面向需要接收 Anthropic Claude Managed Agents(CMA)Webhook 的开发者,用于在自建服务中校验并处理 CMA 推送事件,替代 Sessions API 的长轮询。

用途与能力:遵循 Standard Webhooks 规范,每次投递携带 webhook-id、webhook-timestamp、webhook-signature 三个头部,使用 HMAC-SHA256 对 {webhook-id}.{webhook-timestamp}.{raw-body} 签名,密钥为端点创建时仅显示一次的 whsec_ 前缀值。可处理会话状态事件(如 session.status_idled、session.status_terminated)、多智能体线程事件(session.thread_created、session.thread_idled)以及 vault 与凭据事件(vault.created、vault_credential.refresh_failed)。

用法:资料给出 Express 与 FastAPI 的手动校验实现,并提示端点须使用原始字节(如 express.raw());也可用 Anthropic SDK 的 client.beta.webhooks.unwrap() 完成校验。环境变量为 ANTHROPIC_WEBHOOK_SIGNING_KEY 及可选的 ANTHROPIC_API_KEY。本地调试可用 npx hookdeck-cli listen 3000 claude-managed-agents --path /webhooks/claude-managed-agents。

限制:事件仅含类型与 id,需再调用 API 获取完整对象;事件类型位于 event.data.type,顶层 event.type 恒为 event;时间戳偏差超过 5 分钟应拒绝;webhook-signature 可含多个 v1 签名对。资料未提供收费标准与技术支持的细节。