Host Process

host_process 直接在运行 AgentCompass 的 host 上执行任务。它是默认 provider，启动最快，但不提供进程、文件系统、资源或网络隔离，只适合可信且明确支持本地执行的任务。

Linux 和 WSL 2 完整支持该 provider。macOS 仅适合 Benchmark 文档明确支持的轻量任务；原生 Windows 不受支持。

agent 运行的命令拥有当前用户的权限，可以读取、修改或删除该用户可访问的文件。不要用 host_process 执行不可信命令。

​

使用前准备

使用前请确认：

• Benchmark 和 Harness 明确支持 host_process；
• 任务需要的命令、Python 包和本地服务已经安装；
• workspace 指向专用的可丢弃目录，而不是重要代码仓库或数据目录。

host_process 不需要额外凭证，会直接继承启动 AgentCompass 的用户环境。

​

使用 run 验证配置

省略 --env 时也会选择 host_process。下面显式写出 provider，并通过 sample_ids 只运行一个任务，便于先确认任务实际运行在哪里：

agentcompass run <benchmark> <harness> "$MODEL_NAME" \
  --env host_process \
  --benchmark-params '{"sample_ids":["<sample-id>"]}'

请将占位符替换为所选 Benchmark、Harness 和样本 ID。上面是 agentcompass run 的最小验证示例；模型端点等通用参数见 agentcompass run。

host_process 同样支持 agentcompass launch。在编排文件的 defaults.environment 中设置所有请求共享的配置，或在 requests[].environment 中设置单个请求；id: host_process 与 provider 参数写在同一层。详见 launch 的映射规则。

​

参数参考

参数可以通过 --env-params 传入，也可以写在配置文件的 environments.host_process 中。

例如，先创建一个专用工作区，再将以下选项添加到上面的 agentcompass run 命令。请把路径替换为已经存在的绝对路径：

--env-params '{"workspace":"/path/to/disposable-workspace"}'

​

连接与凭证

host_process 不提供连接或凭证参数。任务直接继承启动 AgentCompass 的当前用户身份和 host 环境。

​

镜像与启动

host_process 不创建镜像或 sandbox，因此不提供镜像和启动参数。任务命令直接使用 host 上已经安装的程序和依赖。

​

标识与元数据

host_process 不创建独立的远程资源或容器，因此不提供运行实例名称、标签或其他 provider 元数据参数。

​

工作区与环境变量

字段	默认值	说明
workspace	.	host 上执行命令和解析 provider 相对路径的目录。相对路径按启动 AgentCompass 时的当前工作目录解析；该目录必须在运行前存在，建议使用专用的绝对路径。
default_workspace_root	workspace/	Benchmark 未指定任务工作目录时，提供给 Harness 的默认 workspace。可以使用绝对路径；相对路径按 workspace 解析，但不会改变 workspace 本身设置的命令执行目录。

host_process 不提供单独的环境变量参数；任务进程继承启动 AgentCompass 时的 host 环境变量。

​

资源

host_process 不提供 CPU、内存或磁盘限制参数。任务与其他 host 进程共享资源，实际调度和限制由 host 操作系统处理。

​

网络

host_process 不提供 provider 专属网络参数，并且只支持通用网络策略中的 public。出站访问由 host 的网络配置和权限控制。

​

生命周期与超时

host_process 不创建需要管理生命周期的 sandbox，因此不提供 provider 专属生命周期或超时参数。评测总超时由运行控制设置。

​

参数参考来源

• 运行 agentcompass config docs env host_process，可以查看当前安装版本实际支持的字段、类型和默认值。
• host_process 直接使用 AgentCompass host，不对应独立的上游 provider；命令、路径和权限的实际行为由 host 操作系统与当前用户环境决定。

​

特有行为

• 没有隔离。 任务共享 host 的文件系统、进程权限、已安装工具和环境变量。
• 只支持公共网络。 无法限制出站访问，也无法在准备、agent 运行和验证阶段切换网络策略，详见网络策略。
• 没有 provider 级资源限制。 CPU、内存和磁盘用量由操作系统管理，详见资源限制。
• 不创建需要清理的 sandbox。 --keep-environment 对该 provider 没有实际作用。

​

故障排查

现象	检查内容
找不到命令或 Python 包	确认依赖安装在启动 AgentCompass 的同一环境中，并检查 PATH。
相对路径指向意外位置	为 workspace 设置绝对路径，并确认目录存在。
文件权限不足	检查当前用户、文件归属和父目录权限。
提示网络策略不受支持	host_process 只支持 public；需要隔离时改用 Docker、Daytona 或 Modal。
Benchmark 需要任务镜像	改用该 Benchmark 文档列出的容器或远程 provider。

​

相关页面

• Environment 概览
• 配置 Environment
• 运行控制
• 安装与系统支持