用途:在确立 Mistral 集成架构时使用,构建区分身份、策略、传输、状态与副作用的负载感知架构,把每类作业路由到最简单且稳定的接口,并隔离预览版和有状态 API。
前提条件:需要聊天、嵌入、分类器、文件/OCR、音频、批处理、FIM 与编排的工作负载清单;身份、租户、数据、留存、支出、SLO 与事件要求;当前端点/模型证据及有状态存储的负责人。
契约说明:Mistral 提供相互独立的无状态与有状态接口,包括 chat、embeddings、classifiers、files、OCR、audio、batch、Workflows 以及 Public Preview 的 Agents/Conversations,其契约不可互换。
认证:应用身份与授权在策略网关终结,仅在受信任适配器中注入供应商密钥;支持时使用已批准的服务身份模式。
步骤:把每个工作负载映射到数据类别、延迟、状态、副作用、端点与稳定性;把认证、租户、审核、预算与边界放在网关;用类型化适配器隔离供应商调用,用版本化边界隔离预览 API;异步工作使用队列/幂等,并对账 Files、Batch、Workflows 与应用状态;存储获批数据时附带租户密钥、来源、留存、删除与审计;定义可观测性、失败模式、发布、回滚、供应商退出与测试归属。
工具纪律:用 Read、Glob、Grep 检查代码、锁文件、配置、测试与证据;Write 与 Edit 仅用于获批的仓库变更。仅调用不授权网络请求、付费使用、上传、有状态资源、管理变更、部署或删除。
审批边界:预览版选择、上传、持久化存储、工具、基础设施与实时流量均需审批;架构评审本身不供给或变更任何组件。
错误处理:单一的通用补全封装无法保留文件、批处理、事件与会话契约;供应商认证不强制应用租户;未跟踪的上传会产生无人管理的数据。
输出:返回组件与信任边界、工作负载映射、存储、审批、失败路径、负责人、测试以及迁移与回滚计划,并显式标注每个预览版依赖。示例:交互式聊天直接路由,获批批量工作走幂等批处理;测试版会话状态置于可替换适配器之后。
验证:对每个工作负载走通正常、超时、重复、跨租户、中断、密钥轮换、删除与回滚路径,确认每个有状态资源都有对账归属。资源方面,需重新核对有时效性的来源,并将实况账户观察记为环境特定证据,而非 Mistral 的普遍保证。