How it works
- Load and prepare. AgentCompass loads the public
testsplit and reads the issue, repository, base commit, gold patch, test metadata, and task image metadata. A built-in provider recipe normally exposes the prebaked repository at/testbed. - Run the coding agent. A harness such as mini-SWE-agent or OpenHands receives the issue, edits the repository, and writes the final unified diff to
/testbed/patch.txtunder the standard recipe layout. - Start a fresh evaluation environment. The modified inference workspace is discarded for scoring. AgentCompass creates a new task environment, restores the repository at
base_commit, and applies the submitted patch. - Execute the upstream test spec.
make_test_spec()supplies repository-specific setup, install, and evaluation commands for the task’s language and build system. - Parse resolution.
get_eval_report()checks fail-to-pass and pass-to-pass tests. The task is resolved only when the issue-specific failures are fixed without regressing the required existing tests.
Parameters
Pass benchmark configuration via--benchmark-params '{...}', or through benchmark.params in a YAML file given to --config; the CLI wins on shared keys.
Parameter reference
| Parameter | Type | Default | Choices / values | Description |
|---|---|---|---|---|
prepare_mode | string | git_clone | git_clone / prebaked | How inference and evaluation repositories are prepared. Built-in provider recipes normally replace this with prebaked. |
workspace_root | string | /testbed | absolute environment path | Root for per-instance workspaces before recipe overrides. |
dataset_zip_url | string | "" | ZIP URL | Optional dataset mirror. Empty loads SWE-bench/SWE-bench_Multilingual from Hugging Face. |
repo_url_template | string | https://github.com/{repo}.git | template containing {repo} | Repository clone URL used in git_clone mode. |
sample_ids | list / string / null | null | valid instance ids | Optional exact task filter. Unknown ids fail fast. |
agentcompass run, not a --benchmark-params field. The dataset is fixed to its test split; there is no benchmark split or language-filter parameter. Use sample_ids to select tasks.
Inference, model, and evaluation controls
eval_timeout controls only fresh multilingual repository evaluation after patch collection. It cannot extend inference. Thinking/reasoning belongs in --model-params; use the protocol/provider form documented for mini-SWE-agent or OpenHands.
Run examples
agentcompass run takes three positional arguments in order: Benchmark, Harness, and Model. The examples use swebench_multilingual; harness choices are described below.
Before running, make sure local Docker is available and set MODEL_NAME, MODEL_BASE_URL, and MODEL_API_KEY to the model under test, API endpoint, and API key.
Recommended harness
mini-SWE-agent is the recommended harness for SWE-bench Multilingual. It selects the SWE-bench-specific configuration and executes language-specific repository commands in the task environment.- Smoke test (single task end-to-end)
- Custom parameters
- AgentCompass recommended config
Run one task to verify inference, patch collection, and fresh multilingual evaluation end to end.
Other optional harnesses
OpenHands is also supported. The following command evaluates the full dataset and exposes its independent model-request, terminal-command, agent-loop, whole-task, and evaluation limits:Evaluation Results
For shared result conventions, see Run Directory, Aggregate Scores, and Task Files and Shared Fields.Scoring Metrics
SWE-bench Multilingual’s primary metric is binarycorrect, matching the evaluator’s resolved decision. Resolution follows the test rules in How It Works; there is no partial credit.
With the default configuration, each task has one attempt and the overall score is the issue resolution rate over tasks with valid scores, ranging from 0 to 1; higher is better.
See Metrics and Aggregation for repeated attempts, category aggregation, and scoring failure rules.
Task Results and Scoring Evidence
final_answer contains the unified diff patch submitted to the evaluator. eval_raw_data under meta.benchmark preserves scoring evidence, with these fields when available:
