用途:在 OpenAI API 请求已发出后出现运行时失败时,判断错误类别并给出下一步处理方向。密钥创建与配置不属于本技能,应交给 openai-platform-api-key;涉及最新指引、链接、限额行为等易变内容时使用 openai-docs。
主要能力(按错误路由):
- 沙箱或网络受限:DNS 错误、连接超时、连接重置、尚未收到任何 API 响应前无法访问 api.openai.com,一律先按传输问题处理。若失败来自沙箱或受限运行,应明确建议开启网络访问或在限制之外重试实际请求;只有在拿到 OpenAI 具体响应后,才归因为鉴权、配额、限流或模型访问问题。
- 鉴权或缺少密钥:401、invalid_api_key、缺少 OPENAI_API_KEY、密钥格式错误等归入鉴权。需要创建或配置密钥时,明确移交 openai-platform-api-key,不要停留在泛泛的“重新创建密钥”建议。
- 配额或额度耗尽:insufficient_quota、current quota、billing quota、run out of credits、no balance left 视为账单/配额耗尽,而非普通限流。额度耗尽时提示用户添加额度并给出“Add API credits”,不代替用户购买额度或修改账单设置。用量上限参考 https://platform.openai.com/settings/organization/limits。含义不明时说明可能是额度或支出上限,并查阅 openai-docs;必要时提示 ChatGPT 订阅与 API 账单相互独立。
- 速率限制:rate_limit_exceeded、每分钟请求数、每分钟 token 数、retry-after,且不含配额措辞,归入限流。建议控制节奏、批处理、指数退避或降低并发;除非错误同时表明配额耗尽,否则不建议购买额度。
- 模型、项目或组织访问:403、model_not_found、组织/项目不匹配、权限失败,属于已到达 OpenAI 但未获授权。先检查模型、项目、组织与密钥范围,再做猜测。
限制与规则:即使同为 429,也要区分 insufficient_quota 与普通限流;区分传输失败与 API 响应,请求未到达 OpenAI 前先修复网络路径;优先依据具体错误码与错误信息而非泛化启发式判断;面向用户的回答保持简短:可能类别、原因、下一步操作;本技能不创建或轮换密钥;修复依赖最新指引、链接或限额行为时改用 openai-docs。具体收费、价格与平台支持范围资料暂未提供。