默认情况下,Sandbox 的 timeout 最长生效 1 小时——传入更大的值会被截断到该上限。长时间运行(long-running)模式可以解除这一上限:启用后,创建 Sandbox 时传入的 timeout 可以超过 1 小时。这适用于需要远超常规会话时长保持存活的工作负载,例如常驻服务、长时间运行的 agent 任务或后台作业。
长时间运行模式通过创建 Sandbox 时的 metadata 字段进行配置。键为 long_running,值为字符串形式的 "true"。
long_running 与 timeout 配合使用:请把 timeout 设置为你实际需要的时长——启用 long_running 后,它可以超过默认的 1 小时上限。未启用 long_running 时,timeout 最长生效 1 小时。如果未设置 timeout,默认值为 5 分钟。
长时间运行模式不会禁用空闲超时:如果你设置了空闲超时,它仍然生效,不活跃的 Sandbox 会据此被暂停或终止。
基本用法
创建 Sandbox 时,在 metadata 对象中传入 long_running 键。
工作原理
- 在
create(以及 resume)时,如果设置了 long_running,传入的 timeout 可以超过默认 1 小时的最长运行时间。
作用范围与继承
- 只有
create 接受 long_running 参数。
resume(包括自动恢复):使用 long_running 创建的 Sandbox 从快照恢复后仍保持该行为。
clone 会继承该参数;经过 reset 后继续运行的 Sandbox 也会保留该行为。
创建一个最长可存活 7 天的长时间运行 Sandbox: