Documentation Index
Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
Use this file to discover all available pages before exploring further.
Agent Session 运行在隔离的沙箱容器中。本文列出容器的操作系统、预装工具、资源限制等参考信息。
操作系统
| 项目 | 值 |
|---|
| 发行版 | Ubuntu 22.04 LTS (Jammy) |
| 架构 | x86_64 (amd64) |
| 内核 | Linux 5.15+ |
预装工具
系统工具
| 工具 | 版本 | 说明 |
|---|
| git | 2.34+ | 版本控制 |
| curl | 7.81+ | HTTP 客户端 |
| wget | 1.21+ | 文件下载 |
| jq | 1.6+ | JSON 处理 |
| vim | 8.2+ | 文本编辑器 |
| unzip / tar | 系统版 | 压缩/解压 |
| ssh | OpenSSH 8.9+ | SSH 客户端 |
| make | 4.3+ | 构建工具 |
语言运行时
| 语言 | 版本 | 包管理器 |
|---|
| Python | 3.11+ | pip 23+ |
| Node.js | 20 LTS | npm 10+ |
| Go | 1.21+ | go mod |
包管理
| 工具 | 说明 |
|---|
| apt | 系统包管理 |
| pip | Python 包 |
| npm | Node.js 包 |
工作目录
Agent 的所有操作默认在此目录下执行。上传的文件挂载到此目录中。
额外软件安装
通过 Environment 配置的 packages 字段安装额外依赖：
{
"config": {
"packages": [
"postgresql-client",
"redis-tools",
"ffmpeg"
]
}
}
apt-get install 安装列表中的包。
也可在 Agent system prompt 中指示 Agent 使用 pip install 或 npm install 安装特定语言包。
网络配置
网络访问能力由 Environment 的 config.networking 字段控制：
| 类型 | 说明 |
|---|
full_access | 容器可访问公网（默认） |
restricted | 仅允许访问白名单域名 |
none | 完全隔离，无网络访问 |
{
"config": {
"networking": {
"type": "restricted",
"allowed_domains": [
"api.github.com",
"registry.npmjs.org"
]
}
}
}
资源限制
| 资源 | 默认限制 | 说明 |
|---|
| CPU | 2 vCPU | 分配的处理器核心数 |
| 内存 | 4 GB | 可用 RAM |
| 磁盘 | 10 GB | 工作区存储空间 |
| 执行时长 | 30 分钟 | 单次 Turn 最大执行时间 |
超出内存或磁盘限制时，进程会被 OOM Kill 或写入失败。请在 system prompt 中提醒 Agent 注意资源用量。
文件持久化
- 同一 Session 内，文件在 Turn 之间保持不变
- Session 结束（archived/deleted）后，容器及其文件销毁
- 需要长期保存的文件，应通过 Files API 上传到平台存储
环境变量
容器中预设的环境变量：
| 变量 | 值 | 说明 |
|---|
| HOME | /home/user | 用户主目录 |
| USER | user | 当前用户名 |
| SHELL | /bin/bash | 默认 Shell |
| LANG | en_US.UTF-8 | 区域设置 |
相关文档
