Skip to main content
此为预览文档,正式版本尚未发布。
Resources → Environments 定义 Managed Agent 在哪里执行文件、Shell 等工具。它与保存定义的 Workspace 分工不同,也不是 Hosted Agent 的 Runtime Host。

界面导览

Local 与 self_hosted Environment 示例

当前控制台截图,使用固定演示数据。

先按执行位置区分环境,再进入对应配置。图中 Local development 用于本机开发,Research worker 是 self_hosted 配置示例;创建环境记录后仍需启动并连接对应 Worker。

选择类型

Docker 下 Local 指 Dataplane 容器内部,并不是宿主机的任意目录。生产环境按工具隔离和网络需求选择后端。

创建与配置

在 Environments 创建名称和类型,随后在详情配置该类型所需的 JSON 连接参数。类型创建后只读。后端所需凭据和能力必须与所选 provider 匹配;不要把 Runtime Host 的 enrollment 凭据用于 Worker。 在 DESIGN → Agents 打开 Managed Agent,在 Runtime → Session defaults → Default environment 选择环境,保存为 defaultEnvironmentId。创建页也可以通过 Advanced settings 选择环境。Session API 的 environmentId 可以为该会话指定环境。 保存后建立新 Chat,用只读文件操作验证连接、工作目录和权限,再验证写入或执行命令的工具。该绑定选择工具执行位置;即使使用 self_hosted,Managed 的模型推理仍在 Dataplane 中运行。

Self-hosted 接入

Self-hosted Worker 使用 Environment 的 API key 建立连接。创建 key 时安全保存,按照所用 Worker 的连接配置提供;重连后检查在线状态和一次实际工具调用。Runtime Host 运行 Coding Agent,而 Worker 承载 Managed Agent 的工具执行,两者不是可互换的进程。

无法执行时

依次检查环境是否存在且可用、网络和认证、目标目录挂载、工具二进制及权限。模型可以回复不代表文件工具也已配置完成。更新配置后用新任务验证,轮换 key 后更新所有使用者。 下一步:Managed Agent · 配置参考。

E2B sandbox 配置示例

管理员先在部署配置中提供 BUILDER_E2B_API_KEY。创建 sandbox 环境后,Config 可使用:
需要额外程序时选择包含这些依赖的自定义 E2B template。workspaceRoot 设置沙箱工作路径;persistenceMode 可选择 TAR 或 NATIVE_SNAPSHOT,按模板与后端能力验证保存和恢复。remote 类型只有文件系统能力,不能作为远程 Shell Worker 使用。

Sandbox 参数

下列字段填写在 Environment 的 Config 中;未填写的 E2B 连接项沿用管理员的部署配置。 Config 中填写 packages、Docker 镜像或网络参数不会自动安装依赖或落实网络限制。所需程序应准备在 E2B template 中,网络策略由实际后端配置。这些 sandbox 参数不用于配置 local 或 self_hosted 的容器。

从发布镜像运行 self-hosted Worker

创建 self_hosted Environment 并保存 API key。设置下列变量:SCHEDULER_IMAGE 为发布清单中的 scheduler 镜像全名,BASE_URL 为 Worker 可访问的 Gateway URL,ENVIRONMENT_ID 和 ENVIRONMENT_KEY 为刚创建环境的值。
该进程只向 Gateway 发起出站请求,不需要暴露 Worker 端口。将 Managed Agent 绑定到此 Environment,发起一个读取并写回小文件的任务,观察工具挂起后由 Worker 回传结果并继续。Worker 工作目录位于命名卷中;任务需要的系统程序应预装到你的 Worker 镜像。 正式运行由你的进程或容器管理器负责重启,多个 Worker 使用不同 worker ID。停止前检查已领取的工作,避免将停止进程误认为已取消业务任务。