选择运行环境
本页帮助你把 Agent 需要的软件放进 Workspace：使用部署方发布的 Template、运行时安装，或者构建新的 Template。
概述
| 方式 | 适用情形 | 停止后保留 | 删除后保留 | 启动开销 |
|---|---|---|---|---|
| 使用已发布的 Template | 里面已经有你需要的软件 | 是 | 下一个 Workspace 同样有 | 无 |
| 运行时安装 | 某次会话额外需要一些软件 | 尽力保留，或放在 Volume 上 | 只有你保留的 Volume 上的内容 | 每次丢失后重装 |
| 构建 Template | 每次会话都需要 | 是 | 下一个 Workspace 同样有 | 构建一次，之后没有 |
已发布的 Template
列出部署提供的 Template，并查看其中一个：
kibo template list
kibo template get kibotos-minimal用 E2B SDK 时，向部署方要名称，再传给 Sandbox.create。
Kibotos 维护一些 Template 定义，包括下面这些。部署只提供部署方构建并发布过的 Template：
| Template | 内容 |
|---|---|
kibotos-minimal | 用来验证部署的最小系统 |
kibotos-coding | Debian 13，带构建工具、Git、Node.js、Python、Go 与 Rust，用于编码 Agent |
kibotos-desktop | Debian 13，带 XFCE 桌面与 Chromium，用于操作浏览器的 Agent，见桌面 |
Workspace 一直使用创建时的 Template revision。新的默认 revision 只影响新建的 Workspace，见 Workspace 与 Template。
运行时安装
安装需要网络访问，以及有权安装的账号。下面的例子放行公网访问，并在带 apt-get 的 Template 上以 root 安装一个软件包：
kibo workspace network set "$workspace_id" public-internet
kibo workspace exec "$workspace_id" --user root -- sh -c 'apt-get update && apt-get install -y jq'软件装在哪里，决定它能保留多久：
| 位置 | 停止再启动 | 删除 Workspace |
|---|---|---|
根文件系统，例如 /usr | 尽力保留 | 丢失 |
Volume，例如 /data | 保留 | 按保留项目的编码 Agent 的方式绑定时保留 |
/tmp 与 /run | 丢失 | 丢失 |
包管理器通常写入根文件系统。要可靠地保留工具，把它装到 Volume 上，例如 pip install --target /data/tools，或者放进 Template，见保证与边界。
构建 Template
Operator 从容器镜像构建 Template，发布并批准它。镜像不需要为 Kibotos 做运行时的改动，但要验证能用：导入不保证每个镜像都能在两种后端上启动。
- 如果你是 Operator，按构建自己的 Template 操作。
- 否则，把镜像的确切摘要和验证它可用的检查方法交给部署方。
Template 里的软件运行时不需要网络访问，每次启动也没有额外开销。
注意
- 环境变量按进程设置：原生 API 用
environment，kibo用-e，sandbox.commands.run用envs。Sandbox.create的envs返回 501。 - 内核与 guest 程序属于 Platform，不属于 Template，见核心概念。
下一步
- 创建与列表：从 Template 创建 Workspace。
- 网络策略：只放行安装需要的目的地。
- 构建自己的 Template：Operator 的完整步骤。