用途:该技能面向 Anthropic Message Batches 的异步批量处理与事件处理模式,用于一次性提交大量提示或文档并异步获取结果。资料指出 Anthropic 没有传统 webhooks,应改用 Message Batches 做异步批量处理。
主要能力:每个批次最多 10,000 个请求,最多 100 个并发批次,处理 SLA 为 24 小时,价格为标准按 token 计价的 50%,结果在创建后 29 天内可获取。可通过轮询跟踪处理状态,并按请求返回成功或错误状态,失败请求可识别后在新批次中重试。
使用方式:先完成 clade-install-auth 前置条件,并准备多个待批量处理的提示或文档。使用 @claude-ai/sdk 创建批次,为每个请求设置 custom_id 与 params(含 model、max_tokens、messages),再轮询 batches.retrieve 直到 processing_status 为 ended,最后用 batches.results 遍历结果,按 result.result.type 处理 succeeded 或错误。资料同时给出 Python 示例,使用 anthropic 客户端创建、轮询和读取结果。
适用场景:适合批量摘要、批量文档处理等可接受异步返回的任务,也可参考 clade-ci-integration 用于 CI 流水线。
限制:需要容忍异步处理,结果最长 24 小时内返回;结果类型包括 succeeded、errored、expired、canceled,其中 errored 需检查 result.error 并在新批次重试,expired 需重新提交。具体安装命令、认证细节及更多平台信息暂未提供。