用途:在升级 Mistral SDK 或迁移已废弃 API 接口时,以证据驱动方式完成迁移,而非全库搜索替换;把 Public Preview 迁移与依赖维护分开处理。
主要能力:盘点导入、类型、端点、模型、选项、解析、重试与状态 ID;在改依赖前锁定特征化测试;比对版本发布、schema、预览标签与不支持特性;按工作负载选择目标(稳定 chat、Workflows,或明确接受的 beta Agents/Conversations);逐条迁移适配路径,避免目标 SDK 对象外泄;先离线回归,再经批准的 canary,回滚窗口到期后才移除兼容层。
使用方式:前置条件为干净分支、固定的源/目标版本、适配器清单、覆盖请求/流/错误/用量/状态的特征化测试,以及 canary、兼容窗口与回滚负责人。尽量离线特征化;实时比对使用服务端密钥、合成内容与固定预算,仅留无内容证据。工具层面用 Read、Glob、Grep 检查代码、锁文件、配置、测试与证据,仅对已批准变更使用 Write 与 Edit;调用本身不授权网络请求、付费使用、上传、有状态资源、管理变更、部署或删除。依赖变更、预览采用、端点更改、实时比对、状态迁移与移除兼容层均需审批。
适用场景:如在不改动应用适配层的前提下升级 TypeScript 客户端,或在保留稳定 chat 的同时单独评估 Workflows。
限制与风险:编译通过仍可能隐藏流、错误、用量或分页变化;从废弃 Agents 迁至 beta 可能需重新设计状态生命周期;自动模型替换会使质量、价格与安全基线失效。输出应含源/目标固定版本、契约差异、各工作流目标、已改调用点、测试/canary、预览风险、回滚与移除日期;需重新核对时效性来源,实时观测仅作为环境特定证据。具体版本、模型、限额、价格与保留策略暂未提供。