Mistral Managed Agents 公开预览：运行方式与任务恢复边界

公开预览改变了什么？先选运行位置

当前 Mistral 发布说明把 Managed Agents 标为 2026 年 11 月 5 日的公开预览，链接的 Agents 概览也独立确认 Managed Agents 与 Agents SDK 均处于公开预览。API、行为与限制仍可能调整，升级可能要求修改代码；这不是正式稳定版或所有账号均已获准的承诺。

代理会根据模型回答决定下一步并调用工具；运行循环的程序称为 harness。进程内模式把循环、工具和会话放在你的程序中，适合开发、测试和短脚本。会话默认随进程结束，不能因为用了同一 SDK 就认定它会转到云端继续。

工具必须靠近内部系统时，选择 agents serve，在自己的机器或集群运行 worker。希望由 Mistral 运行 worker 时，选择 agents deploy。两种部署模式均由 Mistral 的控制平面保存会话；自托管不表示模型和会话记录都留在本机。

部署前，权限与代码版本怎样对齐？

官方入门要求准备项目的 GitHub 仓库，并在 Mistral Studio 连接 GitHub。所用 API 密钥的用户还须拥有带 Workflows 访问权的工作区角色，例如 Developer 或 Workspace Contributor，由工作区管理员分配。公开预览标签不能替代角色权限。

先审查并提交项目，再推送实际目标分支。agents deploy 构建的是已经推送的提交，不是电脑里的未提交文件；未推送提交或没有 upstream 的分支会被拒绝。按 CLI 显示的仓库、revision 与 Dockerfile 核对构建目标，不把本地改完当成已部署。

代理名称在工作区内唯一，后来以同名部署会替换原代理。先确认名称和当前任务，再更新；不要直接照抄示例覆盖正在承担工作的代理。部署完成后，用 agents list 检查运行状态，并另外检查一次会话的实际输出。本文未安装 SDK 或执行部署。

进程崩溃后，为什么仍要防止重复操作？

部署模式会记录已完成的模型调用与工具调用。worker 中断后，任务通常可在 worker 恢复时从最后完成的步骤继续，但也可能失败，或保持 Running 直到时限；持久化不是必定恢复的保证。

正在执行而尚未保存结果的工作属于结果未知。官方说明，模型调用会再次执行；中断中的工具调用不会由恢复过程直接重跑，约一分钟后模型会收到错误，并可能再次调用同一个工具。因此发邮件、退款或创建订单等外部动作仍可能重复。

让这类工具使用由原请求身份生成的幂等键：重复请求返回原结果，不再执行第二次。服务不支持幂等键时，需要由工具自身的持久化状态与并发控制落实防重；仅先查一次“是否做过”不足以防止两个并发调用。先核对原操作结果，再继续原会话，不能用不断新建任务代替恢复。

24 小时、4 小时与审批等待分别限制什么？

已部署会话默认在总时长 24 小时或空闲 4 小时到达时结束，以先到者为准。总时长从会话首次运行开始计算；没有工作中的 turn，或 turn 只等待用户、应用或审批答复时，属于空闲。子代理仍在工作时不算空闲。

可配置上限也随运行方式不同：Mistral 托管的 agents deploy 最多空闲 24 小时、累计一周；自托管 agents serve 的空闲与累计时长最多可配置到一年。这些是配置上限，不是成功运行时长的承诺。

等待人工输入另有默认一小时限制，不能假设第二天再批仍可继续。execution timeout 必须比累计时限多出五分钟以上，已运行会话保留启动时的 execution timeout。MistralSandbox 自身默认寿命为 24 小时，较长会话还需核对它的 ttl_seconds；调高一个时限不会自动调高其他时限。

达到会话限制后，运行中的 turn 会返回 Interrupted，子代理也停止。文档给出 lifetime_limit 或 idle_limit 作为终止原因；被时限结束的会话不能恢复，必须在确认原外部操作状态后再开始新会话。不要把所有 Interrupted 都理解为服务事故。

怎样找回任务，或真正停止它？

应用要退出而任务继续时，按官方后台运行方式保存 session 和 turn 的 ID，回来后读取对应结果。已部署代理可用 Agent.load_from 按名称取得，再用 agent.session(stored_id) 绑定原会话。创建这个 handle 本身不发请求；ID 不存在，要在首次请求时才会报错。

停止当前 turn、同时保留会话，使用 turn.interrupt()。结束整个会话及其子代理，使用 session.cancel()；部署模式下返回表示代理接受取消，不应只凭这一返回就宣称所有外部操作已经撤回。结束后核对会话状态、终止原因与工具结果。

释放 handle、关闭调用端，或从发起调用的方法返回，都不会自动结束已部署会话。会话与 sandbox 可继续保持打开，直到取消或达到限制。把“读到结果”与“不再需要会话”分别处理，避免遗留资源。

第一次接入还应确认哪些条件？

本次已核的概览、运行方式、部署与会话文档，没有明确给出该 Managed Agents 预览的统一套餐资格、托管费率或完整区域清单。上线前向自己的工作区与官方账单、合同核实；不能把公开预览理解为免费，也不能沿用其他产品的额度。

部署模式默认在 Studio 记录 trace，包含提示与回答内容；提交内部资料前先核对记录范围、保留安排及工具授权。只把需要的工具、连接器和环境提供给代理，检查工具实际运行的网络是否能访问获授权的服务。

这类检查针对产品权限、进程位置、数据边界和任务状态。只有出现 DNS、TLS 或超时等连接证据时再做网络排查；更换代理出口不能增加工作区资格、托管额度，或绕过服务的地区与访问规则。