> ## Documentation Index
> Fetch the complete documentation index at: https://opencompass-docs-preview-pr-335-0.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# agentcompass summary

`agentcompass summary` 根据已有运行目录中的任务结果重新计算 Benchmark 聚合指标，并更新指标文件及其溯源记录。它不会重新运行 agent、验证器或分析器。

```bash theme={"system"}
agentcompass summary [OPTIONS] RUN-DIR
```

## 重新生成摘要

`RUN-DIR` 应指向完整的 AgentCompass [结果目录](/zh/user_guide/other_features/results/overview#目录布局)，而不是其中的 `details/` 子目录：

```bash theme={"system"}
agentcompass summary \
  results/my-model_swebench_verified_mini_swe_agent/20260703_120000
```

AgentCompass 会严格验证已保存的任务详情和 `run_info.json` 中的尝试计划，再重建一份 Metric Contract 报告。默认在原目录覆盖 `summary.md` 和 `metrics.json`，不会修改任务结果，同时在 `run_info.json.metric_artifacts` 下记录 `source: "summary"` 和报告计划。

## 预览摘要

在写入文件前，可以使用 `--dry-run` 在终端中预览新的 `summary.md`：

```bash theme={"system"}
agentcompass summary \
  results/my-model_swebench_verified_mini_swe_agent/20260703_120000 \
  --dry-run
```

此模式不会更新运行目录中的任何文件。

## 参数

| 参数 | 是否必需 | 默认值 | 作用 |
| - | - | - | - |
| `RUN-DIR` / `--run-dir` | 必需 | 无 | 指定已有的 AgentCompass 运行目录。 |
| `--config <path>` | 可选 | 无 | 加载用于补充 Benchmark 配置的 YAML 或 JSON 文件；可重复指定。运行目录中已保存的同名参数优先。 |
| `--benchmark-params <json>` | 可选 | 无 | 使用 JSON 对象覆盖从运行目录恢复的 Benchmark 参数。 |
| `--dry-run` | 可选 | 关闭 | 将重新生成的 Markdown 输出到终端，不写入文件。 |

通常无需提供 `--config` 或 `--benchmark-params`。仅在需要补充或调整当前 Benchmark 的 `aggregation_mode`、`category_hierarchy` 等聚合设置时使用；这些参数不能改变已保存的 `execution.attempts` 计划，也不会重新评测任务。非 dry-run 重新汇总时，`metric_artifacts.benchmark_params_override` 会保存脱敏后的 `--benchmark-params` 对象，原始请求和 `params.json` 保持不变。

## 相关页面

* [指标与聚合](/zh/user_guide/other_features/results/metrics_aggregation)
* [汇总与分析结果](/zh/user_guide/other_features/results/summary_analysis)
* [`agentcompass analysis`](/zh/user_guide/using_agentcompass/cli/analysis)
* [`agentcompass config`](/zh/user_guide/using_agentcompass/cli/config)
* [CLI 概览](/zh/user_guide/using_agentcompass/cli/overview)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.