Skip to main content
默认情况下,Sandbox 的 timeout 最长生效 1 小时——传入更大的值会被截断到该上限。长时间运行(long-running)模式可以解除这一上限:启用后,创建 Sandbox 时传入的 timeout 可以超过 1 小时。这适用于需要远超常规会话时长保持存活的工作负载,例如常驻服务、长时间运行的 agent 任务或后台作业。 长时间运行模式通过创建 Sandbox 时的 metadata 字段进行配置。键为 long_running,值为字符串形式的 "true"
long_runningtimeout 配合使用:请把 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:
最后修改于 2026年9月1日