Agno v3.1.4 发布：沙箱化代理、Docker 与 AgentCore 沙箱提供方及会话级队列

主要变化

根据该版本说明，此次更新围绕沙箱化外部代理（harness agents）展开：

• 沙箱化 Harness Agents：ClaudeAgent 与 CodexAgent 接受 sandbox= 参数，把整个 harness 进程放在隔离的按会话计算机中运行；会话状态可跨容器、主机或副本丢失后恢复。每次回合通过代理 Postgres 中的租约行占用会话，从上次提交的检查点恢复运行，完成后捕获并校验新检查点。若恢复时丢失原生会话 id，会在调用模型前以 native_state_missing 失败。新增 require_native_resume、strict_persistence 选项，以及 agno[claude] / agno[codex] 安装附加项。
• 沙箱提供方：DockerSandbox 以 UID 1000、只读镜像文件系统、能力裁剪、CPU/内存/进程限制运行，默认无网络，提供 pause/resume 与检查点传输；AgentCoreSandbox 在 AgentCore Runtime 上实现同一契约，每个沙箱代次对应一个 Firecracker microVM 会话，不支持 pause。提供方包移动到 agno.sandbox.docker 与 agno.sandbox.agentcore。
• 温沙箱回合：协调器在回合后默认保留计算机 300 秒，窗口内下一回合直接恢复，否则走冷路径并从检查点恢复；metadata.sandbox.resumed 标明路径。来源给出 Docker 温启动 4.6 秒对冷启动 8.2 秒、AgentCore 3.3 秒对 8.2 秒的数据。
• 经由 AgentOS 的沙箱：复用既有 run 端点提交前台、流式与后台请求，支持 Idempotency-Key 重试、按 run 恢复与取消；沙箱化代理缺少 Postgres 协调时启动失败。
• 沙箱代理附件：run/arun 接受 images=、files=，仅字节进入沙箱；每请求最多 16 个附件、合计 512 KiB，拒绝 URL、媒体引用、服务器路径及音视频。
• Claude Code 内联图片与 PDF：ClaudeAgent 将图片与不超过 4 MiB 的 PDF 作为内容块直接发送，避免读回 base64 时溢出 SDK 消息缓冲与沙箱事件帧。
• 会话级队列：同一会话的后台运行按提交顺序一次执行一个，不同会话在 max_concurrency 内并发；QueueConfig.queue_per_session 默认开启，外部代理始终串行。
• 即时持久化提交：接受提交的副本在工单提交后唤醒自身队列 worker，缩短启动等待，持久化语义不变。
• ChartTools：新增单一 create_chart 工具，校验图表载荷并返回供 Agno OS 渲染的图表块。

改进与修复

数据库支撑组件与工厂组件改走持久队列；CodexAgent(sandbox="read-only") 更名为 sandbox_mode，旧字符串形式保留但带弃用警告；沙箱 cookbook 拆分为 docker 与 agentcore 目录；Gemini cookbook 更新。修复包括检查点恢复时用户解析失败、取消与认领的锁顺序死锁、同步调用泄漏 HTTP 客户端、提交用户不匹配返回 404、WebSocket 多运行尾流中断等。

限制与待核实

以上均为该版本发布说明中的描述，未在本地环境验证；性能数字与默认值以来源为准，实际行为需自行确认。发布时间为来源标注日期，不代表当前时间。