容器参考

操作系统

预装工具

系统工具

语言运行时

包管理

工作目录

/app

Agent 命令默认 cwd 为 /app。注意 $HOME 指向 /data（不同目录），~/ 展开后不在 cwd 下。上传的文件挂载路径见 Files 文档。

额外软件安装

通过 Environment 配置的 packages 字段安装额外依赖：

{
  "config": {
    "packages": {
      "apt": ["postgresql-client", "redis-tools", "ffmpeg"]
    }
  }
}

容器启动时会根据 apt/pip/npm 键分别安装对应的系统包、Python 包和 Node.js 包。

网络配置

网络访问能力由 Environment 的 config.networking 字段控制（必须为对象格式）：

配置示例：

{
  "config": {
    "networking": {
      "type": "allowed_hosts",
      "allowed_hosts": [
        "api.github.com",
        "registry.npmjs.org"
      ]
    }
  }
}

详细字段说明请参见 云端环境 - 网络策略。

资源限制

文件持久化

• 同一 Session 内，文件在 Turn 之间保持不变

• Session 结束（archived/deleted）后，容器及其文件销毁

• 需要长期保存的文件，应通过 Files API 上传到平台存储

执行用户

容器内所有命令以 root 用户身份执行。whoami 返回 root，但 USER 环境变量未注入（为空字符串）。

因此 Agent 可以直接安装系统包、写入任意系统目录，无需 sudo。如对此有限制需求，请在 Agent 的系统提示词中明确说明。

环境变量

容器中预设的环境变量：

Vault 中的凭证会以环境变量形式注入（需在 Session 创建时关联 Vault）。

相关文档

• 云端环境 — Environment 配置详解

• 文件上传与挂载 — 文件管理

• 用户凭证 — Vault 注入机制