跳转到主要内容
Daytona 提供 provider-managed remote sandbox。它适合在不占用本地计算资源的情况下，为每个任务创建远程 workspace，尤其适合 SWE-bench 和 Terminal-Bench smoke test。

​
官方设置入口

需求链接
创建账号和管理 sandboxesDaytona Dashboard
创建 API keysDaytona API keys page
Getting started 文档Daytona documentation
API key 文档Daytona API keys

​
首次设置

  1. 从官方 Dashboard 创建 Daytona 账号。
  2. 打开 API keys 页面，创建带 sandbox 权限的 key。
  3. 在运行 AgentCompass 的 shell 中导出 key。
  4. 先跑单个任务，再提高并发。
export DAYTONA_API_KEY="..."
export DAYTONA_API_URL="https://your-daytona-api"  # optional
export DAYTONA_TARGET="your-target"               # optional
大多数用户只需要 DAYTONA_API_KEY。只有当你的 Daytona workspace 需要非默认 API endpoint 或 target 时，才设置 DAYTONA_API_URL 和 DAYTONA_TARGET。 AgentCompass 的 Daytona 鉴权优先级是：
来源适用场景
environments.daytona.api_key明确把凭据放在私有 --config 文件中。
DAYTONA_API_KEY推荐用于 shell session、CI 和共享脚本。
DAYTONA_API_URL / DAYTONA_TARGET可选 endpoint 和 target 覆盖。
不要把 Daytona API key 提交到 config/defaults.yaml。请使用环境变量，或通过 --config 传入私有配置文件。

​
验证凭据

最实用的验证方式是跑一个 AgentCompass smoke test，因为它会同时检查 credentials、sandbox 启动、recipe image 选择、文件操作和 harness 执行。

​
单个 Terminal-Bench 实例

agentcompass run \
  terminal_bench_2 \
  terminus2 \
  your-model \
  --env daytona \
  --benchmark-params '{"sample_ids":["overfull-hbox"]}' \
  --model-base-url "$MODEL_BASE_URL" \
  --model-api-key "$MODEL_API_KEY"
这是推荐的 provider smoke test：只跑一个任务，并让 recipe 推导任务镜像。

​
Provider 参数

常见 Daytona 覆盖项可以放在 environments.daytona 或 --env-params：
Field作用
api_keyDAYTONA_API_KEY 的私有 config 替代方式。
api_url覆盖 Daytona API endpoint。
target覆盖 Daytona target。
image不希望 recipe 选 image 时，手动使用 Docker image。
snapshot使用 Daytona snapshot，加速或复用预构建环境。
delete_on_close调试 sandbox 时可设为 false。
sandbox_start_timeout镜像或 snapshot 启动较慢时增加。
operation_timeout文件或进程操作较长时增加。
env_variables向 sandbox 注入非 secret 环境变量。

​
SWE-bench Verified

agentcompass run \
  swebench_verified \
  mini_swe_agent \
  your-model \
  --env daytona \
  --benchmark-params '{"sample_ids":["astropy__astropy-12907"]}' \
  --model-base-url "$MODEL_BASE_URL" \
  --model-api-key "$MODEL_API_KEY"
支持的 benchmark/provider 组合会由 recipe 设置兼容镜像和 workspace。只有明确要覆盖默认行为时才传 --env-params。

​
相关页面