Skip to main content
选择已注册的 Harness，并配置其完整参数结构。 Harness 定义 agent 如何尝试已准备的任务。它可以直接调用 model、启动编程/终端 CLI，或集成外部 agent 框架。Benchmark 仍负责任务准备和评分。 复现官方结果时，请使用所选 Benchmark 页面推荐的 Harness。仅当其他 Harness 页面确认 model 协议、Environment、工作区和已准备任务契约兼容时，才选择替代方案。

​
查找 Harness

运行以下命令，查看当前安装的 AgentCompass 版本实际提供的 Harness：
侧边栏提供已有独立文档的 Harness 入口，可查看协议、安装、参数、执行方式和故障排查。对于任意注册表条目——包括尚无独立页面的新集成——可通过以下命令检查其当前配置结构：

​
配置 Harness 参数

运行参数参考介绍了 --harness-params <json>。其中 <json> 包含所选 Harness 负责的字段：
与 Benchmark 参数不同，Harness 参数没有跨所有 Harness 共用的面向用户字段；完整结构由所选 Harness 决定。

​
检查完整结构

直接从所选 Harness 实现输出全部允许字段、类型、默认值和描述：
Harness 页面会说明合法取值、支持的协议和 Environment、安装行为，以及无法仅通过类型和默认值表达的交互关系。

​
构建 JSON 对象

例如，mini_swe_agent 在同一个对象中暴露可执行文件、版本、安装、步数、成本、超时、Environment 和产物设置：
这个展开后的对象用于展示结构，并不建议重复所有默认值。只传递需要与实际 Harness 配置不同的字段。 --harness-params 必须是合法 JSON。CLI 值会深度合并并覆盖配置文件 harnesses 下对应 Harness ID 中的同名字段。添加最终 CLI 覆盖前，可先检查内置值和配置文件合并后的结果：

​
明确参数归属

agent 轮次限制和安装设置属于 --harness-params；数据集筛选和验证器行为属于 --benchmark-params；model 推理请求属于 --model-params；sandbox 镜像、资源和网络策略属于 --env-params。 整个 agent 执行的预算通过 execution 下的 run_timeout_seconds 设置。单条工具命令或模型请求的时限由所选 Harness 决定，通过 --harness-params 或 --model-params 传入。设置示例和组件参数入口见单次请求与命令时限。