> ## Documentation Index
> Fetch the complete documentation index at: https://agent-compass.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 命令行界面

根据运行、编排、汇总、分析和检查评测等需求选择 AgentCompass 命令。

AgentCompass 提供一个统一的 `agentcompass` 命令。请在已激活的 AgentCompass 环境中直接运行，或通过`uv run` 调用：

```bash theme={"system"}
agentcompass --help
```

```bash theme={"system"}
uv run agentcompass --help
```

## 命令列表

| 命令                       | 适用场景                                              | 详细指南                                                 |
| ------------------------ | ------------------------------------------------- | ---------------------------------------------------- |
| `agentcompass run`       | 使用指定的 Model、Harness 和 Environment 评测所选 Benchmark。 | [运行](/zh/user_guide/using_agentcompass/cli/run)      |
| `agentcompass launch`    | 使用同一个调度器协调多个显式命名的评测请求。                            | [启动](/zh/user_guide/using_agentcompass/cli/launch)   |
| `agentcompass analysis`  | 对已有结果目录运行后置分析器。                                   | [分析](/zh/user_guide/using_agentcompass/cli/analysis) |
| `agentcompass summary`   | 根据已有任务详情重新计算 Benchmark 聚合指标并生成 `summary.md`。      | [摘要](/zh/user_guide/using_agentcompass/cli/summary)  |
| `agentcompass list`      | 查看已注册的 Benchmark、Harness、Environment、分析器和协议支持。    | [列表](/zh/user_guide/using_agentcompass/cli/list)     |
| `agentcompass config`    | 查看配置文件合并后的值，或查询组件接受的配置字段。                         | [配置](/zh/user_guide/using_agentcompass/cli/config)   |
| `agentcompass --version` | 输出已安装的 AgentCompass 版本。                           | —                                                    |

## 选择 `run` 还是 `launch`

[`agentcompass run`](/zh/user_guide/using_agentcompass/cli/run) 使用命令行和配置文件指定的 Benchmark、Harness、Model 和 Environment 执行一次评测。Benchmark、Harness 和 Model 按此顺序通过位置参数选择，Environment 通过 `--env` 选择；组件参数、并发、重试、输出和复用设置则由同一条命令或其加载的配置文件提供。

[`agentcompass launch`](/zh/user_guide/using_agentcompass/cli/launch) 从 YAML 或 JSON 文件读取多个显式命名的评测请求，并交给同一个全局调度器。需要比较多个 Model、运行多个 Benchmark，或混合不同 Harness、Environment 时使用 `launch`。它不会自动生成组件的笛卡尔积，每一种组合都需要在编排文件中明确声明。

两个命令共享并发、超时、重试、输出和调试设置。各项参数的作用范围和使用建议见[运行控制](/zh/user_guide/using_agentcompass/run_controls)。