SuperAPI AI 工具集

error-patterns

测试与质量

查看项目

更新于 10-15 17:20

技能介绍

用途:为插件提供统一、生产级的错误处理模式,覆盖错误分类、恢复策略与调试工作流,适合构建有韧性的集成、需要统一错误处理、优雅降级或排查生产问题的场景;若项目未使用 leyline 基础设施模式,或只是无需服务架构的简单脚本,则不建议使用。

主要能力:按严重度分类(Critical 需停止并告警,如认证失败、服务宕机;Error 需重试或备用策略,如限流、超时;Warning 仅记录并继续;Info 仅记录)。按可恢复性分类:TRANSIENT(重试可能成功)、PERMANENT(重试无用)、CONFIGURATION(需用户操作)、RESOURCE(配额/限额问题)。

常见模式:认证错误(401/403)应核验凭据、检查令牌过期与权限范围,并建议重新认证;限流(429)应提取 retry-after、记录配额、实现退避并考虑备用服务;超时则增大重试超时、拆分请求、使用异步或换模型;上下文过大(400)应预估 token、拆分请求、精简输入或换更大上下文模型。

使用方式:通过 from leyline.error_patterns import handle_error, ErrorCategory 调用标准错误处理器,返回包含 category、message、recoverable、suggested_action、metadata 的 ErrorResult;在技能 frontmatter 中声明依赖 dependencies: [leyline:error-patterns]。分类、恢复与多智能体损害的详细说明见 modules 下对应文档。

限制:资料未提供具体安装命令、版本要求、价格与支持平台等信息,暂未提供。