用途:为 Claude API 调用实现生产级可靠性模式,包括熔断器(防止级联故障)、优雅降级(提供回退响应)、幂等(安全重试)和超时管理。
主要能力:熔断器以 CLOSED/OPEN/HALF_OPEN 三态控制调用,达到失败阈值后拒绝请求,超时后进入半开探测恢复;优雅降级按 Sonnet→Haiku→缓存→静态回退的顺序尝试;幂等通过请求参数生成确定性键并缓存已完成结果,避免重复处理;超时在 SDK 层与单请求层分别配置,并配合 max_retries 自动重试 429/5xx。
使用方式:定义熔断阈值、恢复超时、回退行为与幂等存储后,用 breaker.call 包裹 client.messages.create;降级函数捕获 RateLimitError 与 APIStatusError 后切换模型;幂等类用 sha256 生成键并查缓存;客户端设置 timeout=60.0、max_retries=3,单请求可覆盖 timeout=10.0。
适用场景:生产环境中的 Claude API 集成,需应对限流、服务不可用与重复请求。
限制与要求:需先定义已批准的模型/工作区策略、超时、重试与熔断阈值、回退行为、幂等存储和回滚负责人;在沙箱用合成提示验证后再开放生产流量;遥测仅保留关联 ID、状态类别、模型 ID、token 数、延迟、熔断状态和聚合回退计数,不得存储提示、补全、凭据或敏感工具参数;验证、认证、权限或策略失败不得重试;所有回退失败时应关闭并给出有界提示;缓存过期、范围不匹配或缺少策略版本时丢弃并使用静态回退;幂等键应基于稳定请求标识而非未脱敏提示。输出可靠性回执,包含关联 ID、熔断转换、重试次数与原因、回退路由、幂等结果、超时、token/成本计数、金丝雀结果、回滚引用与清理状态,内容与密钥字段需脱敏。