SuperAPI AI 工具集

anth-webhooks-events

编程与开发

查看项目

更新于 10-15 22:42

技能介绍

用途:该技能面向使用 Claude API 构建事件驱动与异步处理架构的开发者,说明 Claude API 不使用传统 webhook,而是提供两种事件模式:SSE 实时流式与 Message Batches 异步批量处理。

主要能力:SSE 部分演示用 client.messages.stream 逐事件处理 message_start、content_block_start、content_block_delta、content_block_stop、message_delta、message_stop、ping,并区分 text_delta 与 input_json_delta。批处理部分演示 client.messages.batches.create 提交请求(资料称最多 10 万条、便宜 50%),轮询 processing_status 与 request_counts,再用 batches.results 流式读取结果。还给出用 Redis/RQ 队列解耦请求与回调的架构示例。

使用方式:按资料中的 Python 代码调用流式与批处理接口;批处理需轮询至 ended,再按 custom_id 处理结果。错误处理表列出流断开需重连重发(不可续传)、批处理 24 小时未处理需重提、单条 errored 需查看 result.error.message。

适用场景:实时输出、工具调用流、批量文档摘要等异步任务。

限制与安全:需使用获批沙箱、合成文档、有界批量、带持久重试与死信的队列、已认证内部回调;定义事件保留与脱敏策略,不记录提示、补全、文档内容、工具参数、API 密钥或回调密钥;校验模型/来源/目标/大小白名单,保证幂等,限制轮询与重试,错误项隔离审查,先小流量金丝雀再回滚。输出事件处理回执,含关联/批次 ID、事件类型与计数、成功/错误/过期数、重试/死信数、回调认证与幂等结果、side_effects=0、金丝雀状态、回滚引用与清理状态,只含错误类别不含原始载荷。资料未提供具体收费价格与平台细节。