用途:当 Cohere 请求失败时,先判定失败发生在哪一层,再决定是否改代码,并输出最小复现与最安全的下一步操作。
主要能力:区分常见状态码含义——400/422 通常表示请求契约无效或功能组合不兼容;401 表示密钥缺失、无效、过期或注入到错误运行时;402 表示计费限制;429 表示当前端点或模型限流;符合条件的 5xx 与传输失败可有界重试,确定性的客户端错误不得重试。404 模型错误需解析可访问的在线模型并核对供应商与平台命名。
使用方式:用 Read、Glob、Grep 检查代码、配置与证据;仅在需要当前 Cohere 官方文档时使用 WebFetch;仅在用户要求实现且目标文件明确时使用 Write 或 Edit,且绝不写入凭据或客户内容。采集时间戳、端点、状态、SDK 版本、解析后的模型、脱敏请求形态与供应商请求标识;检查 Cohere 状态判断故障是全局、模型级、环境级还是请求级;对照当前参考核对 v2 必填字段与功能组合;关闭重试运行一次最小非敏感复现;做最小修正并用一次有界探测验证;记录分类、证据、修正与回滚或升级负责人。
限制与边界:密钥须来自经批准的密钥管理器并按环境注入,绝不打印、持久化、提交或把 CO_API_KEY 放入示例。未经负责人批准,不得暴露或轮换密钥、更改团队角色、接受商业条款、启用敏感生产数据、增加支出或容量、切换生产模型、发送支持包或执行模型提议的副作用。诊断默认只读。输出需脱敏密钥、授权头、提示词、检索文档、嵌入、客户标识与不受限的环境输出。
适用场景:Cohere v2 请求报错排查、认证与配额问题定位、模型不可用与传输故障处置。缺失事实:具体官方文档链接、错误参考与状态页地址暂未提供。