agentcompass summary

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

agentcompass summary [OPTIONS] RUN-DIR

​

重新生成摘要

RUN-DIR 应指向完整的 AgentCompass 结果目录，而不是其中的 details/ 子目录：

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：

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 保持不变。

​

相关页面

• 指标与聚合
• 汇总与分析结果
• agentcompass analysis
• agentcompass config
• CLI 概览