用途:把生成的 Cohere SDK 客户端封装在小型应用契约之后,使模型变更、提供方错误和迁移影响局部化,适合标准化生产环境的 SDK 使用。
主要能力:每个运行时进程实例化一个已配置的 v2 客户端(除非租户需要独立凭据边界);要求调用方提供操作目的、有界超时和已解析的模型 ID;仅对瞬时传输错误、429 和符合条件的 5xx 失败进行带抖动和总尝试上限的重试;在边界处规范化 Chat 内容、引用、工具调用、Embed 向量、Rerank 分数、用量和提供方请求元数据;流式实现为带取消和终止事件校验的异步迭代器。
使用方式:先用 Read、Glob、Grep 检查代码与配置,WebFetch 仅用于 Cohere 官方文档;盘点现有直接 SDK 调用并按 Chat、Embed、Rerank、模型发现分组;定义只暴露应用所需字段的类型化请求与结果契约;集中超时、脱敏、重试资格和模型解析;为成功、部分流、超时、限流和模式漂移添加契约夹具;逐处迁移调用点,对等测试通过后再删除直接 SDK 访问。认证使用从批准的密钥管理器注入的环境专用密钥,切勿打印、持久化、提交或把 CO_API_KEY 放入示例。
限制与边界:不得在未获负责人批准时暴露或轮换密钥、更改 Cohere 团队角色、接受商业条款、启用敏感生产数据、增加支出或容量、切换生产模型、发送支持包或执行模型提议的副作用;未要求实现时保持只读诊断。输出需返回解析后的 API 与模型契约、检查的文件或设置、证据、验证结果、剩余风险、负责人及回滚或下一步,并脱敏密钥、授权头、提示、检索文档、嵌入、客户标识符和不受限的环境输出。错误处理:未知事件保留在诊断中并安全终止受影响流;重试风暴需强制抖动、尝试上限和共享并发预算;类型漂移需针对固定 SDK 更新适配器并添加夹具;空内容视为无效结果,除非操作预期工具调用。官方 TypeScript SDK 与 Python SDK 文档为技能专用资源。