用途:该技能用于在应用中建立 Mistral SDK 的边界适配层,避免供应商特有的数据形状和易变的客户端行为扩散到业务代码,集中管理配置并归一化结果与错误。
主要能力:围绕聊天、嵌入以及可选的流式接口定义应用层接口;统一处理请求 ID、用量、结束状态和错误类别等归一化字段;提供带显式主机、超时、User-Agent 和依赖版本锁定的客户端工厂;对错误做分类重试,并遵循截止时间、取消与预算;将流组装和工具调用校验拆分为可单独测试的组件。
必要用法:先锁定官方客户端版本并对照文档,盘点导入、传输覆盖、模型字符串和响应形状;定义归一化类型;创建单一服务端客户端工厂并注入 MISTRAL_API_KEY,适配层不返回密钥或授权元数据;迁移调用点前先添加特征测试。涉及依赖、传输、重试、回退模型或在线特征变更需审批,不要自动执行返回的工具参数。
限制:文档提到官方 Python 与 TypeScript 客户端,但签名可能独立于应用代码变动,REST 端点仍是固定版本客户端的验证边界;重复重试所有异常可能放大成本并掩盖无效请求;导入期构造客户端不利于轮换与测试;返回原始 SDK 对象会使应用耦合到未文档化字段。具体命令、价格、限额等资料暂未提供。