用途：把 Cohere API v1 或更早的 SDK 用法迁移到 v2，在移除回滚路径前证明新旧行为语义一致。
主要能力：清点旧版行为（SDK 版本、端点、参数、模型、流事件、连接器、微调、响应解析），对照官方迁移与弃用页面将依赖分类为在用、旧版、已弃用或已下线；为现有用户可见行为与失败路径添加金标契约测试；引入 v2 客户端与提供方适配层，同时保留带特性开关的回滚路径；迁移请求与响应结构，必要时重建嵌入索引；对代表性流量做金丝雀发布，比较质量与运行指标。
关键契约变化：v2 使用 messages，取代独立的 message、preamble 与托管会话历史字段；v2 要求显式指定 models，Embed 还需指定 embedding types；v2 工具使用 JSON Schema，并以 tool-call ID 关联结果。旧版 Generate、Summarize、Classify、托管连接器、部分模型与微调路径已列入 Cohere 弃用日程。
使用方式：用 Read、Glob、Grep 检查代码与配置，WebFetch 仅用于获取 Cohere 官方文档；仅在用户明确要求实现且目标文件已知时使用 Write 或 Edit，禁止写入凭据或客户内容。认证使用来自已批准密钥管理器的环境专用密钥，不得打印、持久化、提交或把 CO_API_KEY 写入示例。流程为：清点→查阅迁移与弃用文档→添加契约测试→引入 v2 客户端与适配层并保留回滚→迁移数据结构→按需重建嵌入→金丝雀验证后移除 v1。示例交接形态：from=Client-v1; to=ClientV2; endpoints=chat,embed; canary=10%，期望 contracts=pass; deprecated-calls=0; quality=within-threshold; rollback=ready。
限制：缺少 v2 特性时使用应用自有工具或保留有时限的 v1 路径；嵌入漂移需建并行索引并原子切换；流解析失败需从旧文本事件改为 v2 类型化事件；质量回退则停止金丝雀并保留旧模型路径。未获责任人批准，不得暴露或轮换密钥、变更 Cohere 团队角色、接受商业条款、启用敏感生产数据、增加支出或容量、切换生产模型。诊断保持只读，输出需脱敏密钥、提示、检索文档、嵌入与客户标识。具体收费、价格与平台支持情况暂未提供。