Rework eval to support interpretable scores and efficient repetitions (#29197)

### Problem

We want to start continuously tracking our progress on agent evals over
time. As part of this, we'd like the *score* to have a clear,
interpretable meaning. Right now, it's a number from 0 to 5, but it's
not clear what any particular number works. In addition, scores vary
widely from run to run, because the agent's output is deterministic. We
try to stabilize the score using a panel of judges, but the behavior of
the agent itself varies much more widely than the judges' scores for a
given run.

### Solution

* **explicit meanings of scores** - In this PR, we're prescribing the
diff and thread criteria files so that they *must* be unordered lists of
assertions. For both the thread and the diff, rather than providing an
abstract score, the judge's task is simply to count how many of these
assertions are satisfied. A percentage score can be derived from this
number, divided by the total number of assertions.
* **repetitions** - Rather than running each example once, and judging
it N times, we'll **run** the example N times. Right now, I'm just
judging the output once per run, because I believe that with these more
clear scoring criteria, the main source of non-determinism will be the
*agent's* behavior, not the judge's

### Questions

* **accounting for diagnostic errors** - Previously, the judge was asked
to incorporate diagnostics into their abstract scores. Now that the
"score" is determined directly from the criteria, the diagnostic will
not be captured in the score. How should the diagnostics be accounted
for in the eval? One thought is - let's simply count and report the
number of errors remaining after the agent finishes, as a separate field
of the run (along with diff score and thread score). We could consider
normalizing it using the total lines of added code (like errors per 100
lines of code added) in order to give it some semblance of stability
between examples.

* **repetitions** - How many repetitions should we run on CI? Each
repetition takes significant time, but I think running more than one
repetition will make the scores significantly less volatile.

### Todo

* [x] Fix `--concurrency` implementation so that only N tasks are
spawned
* [x] Support `--repetitions` efficiently (re-using the same worktree)
* [x] Restructure judge prompts to count passing criteria, not compute
abstract score
* [x] Report total number of diagnostics in some way
* [x] Format output nicely

Release Notes:

- N/A *or* Added/Fixed/Improved ...

---------

Co-authored-by: Antonio Scandurra <me@as-cii.com>
This commit is contained in:
Max Brunsfeld 2025-04-22 07:00:09 -07:00 committed by GitHub
parent 36da97935a
commit 36d02de784
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
9 changed files with 260 additions and 423 deletions

View file

@ -3,15 +3,16 @@ mod ids;
mod tool_metrics;
pub(crate) use example::*;
use parking_lot::Mutex;
pub(crate) use tool_metrics::*;
use ::fs::RealFs;
use anyhow::{Result, anyhow};
use clap::Parser;
use client::{Client, ProxySettings, UserStore};
use collections::HashSet;
use collections::{HashMap, HashSet};
use extension::ExtensionHostProxy;
use futures::{StreamExt, future};
use futures::future;
use gpui::http_client::{Uri, read_proxy_from_env};
use gpui::{App, AppContext, Application, AsyncApp, Entity, SemanticVersion, UpdateGlobal};
use gpui_tokio::Tokio;
@ -24,6 +25,7 @@ use prompt_store::PromptBuilder;
use release_channel::AppVersion;
use reqwest_client::ReqwestClient;
use settings::{Settings, SettingsStore};
use std::collections::VecDeque;
use std::env;
use std::path::{Path, PathBuf};
use std::sync::Arc;
@ -40,13 +42,9 @@ struct Args {
model: String,
#[arg(long, value_delimiter = ',', default_value = "rs,ts")]
languages: Vec<String>,
/// How many times to run each example. Note that this is currently not very efficient as N
/// worktrees will be created for the examples.
/// How many times to run each example.
#[arg(long, default_value = "1")]
repetitions: u32,
/// How many times to run the judge on each example run.
#[arg(long, default_value = "3")]
judge_repetitions: u32,
repetitions: usize,
/// Maximum number of examples to run concurrently.
#[arg(long, default_value = "10")]
concurrency: usize,
@ -163,7 +161,6 @@ fn main() {
"\x1b[96m", // Bright Cyan
];
let mut max_name_width = 0;
let mut skipped = Vec::new();
for example_path in &example_paths {
@ -184,20 +181,7 @@ fn main() {
continue;
}
// TODO: This creates a worktree per repetition. Ideally these examples should
// either be run sequentially on the same worktree, or reuse worktrees when there
// are more examples to run than the concurrency limit.
for repetition_number in 0..args.repetitions {
let mut example = example.clone();
example.set_repetition_number(repetition_number);
let name_len = example.name.len();
if name_len > max_name_width {
max_name_width = example.name.len();
}
examples.push(example);
}
examples.extend(example.repeat(args.repetitions));
}
println!("Skipped examples: {}\n", skipped.join(", "));
@ -210,6 +194,11 @@ fn main() {
let mut repo_urls = HashSet::default();
let mut clone_tasks = Vec::new();
let max_name_width = examples
.iter()
.map(|e| e.repetition_name().len())
.max()
.unwrap_or(0);
for (i, example) in examples.iter_mut().enumerate() {
let color = COLORS[i % COLORS.len()].to_string();
example.set_log_prefix_style(&color, max_name_width);
@ -217,7 +206,7 @@ fn main() {
println!(
"{}Logging to: {}",
example.log_prefix,
example.example_output_directory().display()
example.run_directory_path().display()
);
let repo_url = example.base.url.clone();
@ -263,49 +252,53 @@ fn main() {
future::join_all(clone_tasks).await;
for example in examples.iter_mut() {
example.setup().await?;
example.fetch().await?;
}
let judge_repetitions = args.judge_repetitions;
let concurrency = args.concurrency;
let examples = Arc::new(Mutex::new(VecDeque::from(examples)));
let results_by_example_name = Arc::new(Mutex::new(HashMap::default()));
let tasks = examples.iter().map(|example| {
future::join_all((0..args.concurrency).map(|_| {
let app_state = app_state.clone();
let model = model.clone();
let example = example.clone();
let zed_commit_sha = zed_commit_sha.clone();
let zed_branch_name = zed_branch_name.clone();
let run_id = run_id.clone();
let examples = examples.clone();
let results = results_by_example_name.clone();
cx.spawn(async move |cx| {
let result = async {
let run_output = cx
.update(|cx| example.run(model.clone(), app_state.clone(), cx))?
.await?;
let judge_tasks = (0..judge_repetitions).map(|round| {
run_judge_repetition(
loop {
let Some(mut example) = examples.lock().pop_front() else {
break;
};
let result = async {
example.setup().await?;
let run_output = cx
.update(|cx| example.run(model.clone(), app_state.clone(), cx))?
.await?;
let judge_output = judge_example(
example.clone(),
model.clone(),
&zed_commit_sha,
&zed_branch_name,
&run_id,
&run_output,
round,
enable_telemetry,
cx,
)
});
let judge_outputs = future::join_all(judge_tasks).await;
anyhow::Ok((run_output, judge_outputs))
.await;
anyhow::Ok((run_output, judge_output))
}
.await;
results
.lock()
.entry(example.name.clone())
.or_insert(Vec::new())
.push((example.clone(), result));
}
.await;
(example, result)
})
});
let results = futures::stream::iter(tasks)
.buffer_unordered(concurrency)
.collect::<Vec<_>>()
.await;
}))
.await;
println!("\n\n");
print_header("EVAL RESULTS");
@ -314,59 +307,64 @@ fn main() {
let mut thread_scores = Vec::new();
let mut error_count = 0;
for (example, result) in results {
print_header(&example.name);
for (example_name, results) in results_by_example_name.lock().iter_mut() {
print_header(&example_name);
match result {
Err(err) => {
println!("💥 {}{:?}", example.log_prefix, err);
error_count += 1;
}
Ok((run_output, judge_results)) => {
cumulative_tool_metrics.merge(&run_output.tool_metrics);
results.sort_unstable_by_key(|(example, _)| example.repetition);
let mut example_cumulative_tool_metrics = ToolMetrics::default();
println!("┌───────┬──────┬────────┐");
println!("│ Judge │ Diff │ Thread │");
println!("├───────┼──────┼────────┤");
println!("┌───────┬──────┬────────┐");
println!("│ Round │ Diff │ Thread │");
println!("├───────┼──────┼────────┤");
for (example, result) in results {
let run_dir_path = example.run_directory_path();
let relative_run_dir_path = run_dir_path.strip_prefix(root_dir).unwrap();
match result {
Err(err) => {
println!(
"|{:^7}│{:^6}│{:^8}│ {:?}{}",
example.repetition,
"N/A",
"N/A",
err,
relative_run_dir_path.display()
);
error_count += 1;
}
Ok((run_output, judge_result)) => {
cumulative_tool_metrics.merge(&run_output.tool_metrics);
example_cumulative_tool_metrics.merge(&run_output.tool_metrics);
for (i, judge_result) in judge_results.iter().enumerate() {
match judge_result {
Ok(judge_output) => {
let diff_score = judge_output.diff.score;
diff_scores.push(diff_score);
let thread_display = if let Some(thread) = &judge_output.thread
{
let thread_score = thread.score;
thread_scores.push(thread_score);
format!("{}", thread_score)
} else {
"N/A".to_string()
};
diff_scores.push(judge_output.diff.score());
thread_scores.push(judge_output.thread.score());
println!(
"|{:^7}│{:^6}│{:^8}│",
i + 1,
diff_score,
thread_display
"|{:^7}│{:^6}│{:^8}│ {}",
example.repetition,
format!("{}%", judge_output.diff.score()),
format!("{}%", judge_output.thread.score()),
relative_run_dir_path.display()
);
}
Err(err) => {
println!("|{:^7}{:^6}{:^8}{:?}", i + 1, "N/A", "N/A", err);
println!(
"|{:^7}│{:^6}│{:^8}│{:?}│ {}",
example.repetition,
"N/A",
"N/A",
err,
relative_run_dir_path.display()
);
}
}
}
println!("└───────┴──────┴────────┘");
println!("{}", run_output.tool_metrics);
}
}
println!(
"{} > {}",
" ".repeat(max_name_width),
example.example_output_directory().display()
);
println!("└───────┴──────┴────────┘");
println!("{}", example_cumulative_tool_metrics);
}
let diff_score_count = diff_scores.len();
@ -380,24 +378,16 @@ fn main() {
println!("\n{error_count} examples failed to run!");
}
if diff_score_count > 0 {
println!("\nAverage code diff score: {average_diff_score}");
}
println!("\nAverage code diff score: {average_diff_score}");
let thread_score_count = thread_scores.len();
let average_thread_score = thread_scores
.into_iter()
.map(|score| score as f32)
.sum::<f32>()
/ (thread_score_count as f32);
// We might have gotten no thread scores if we weren't asked to judge the thread.
if thread_score_count > 0 {
let average_thread_score = thread_scores
.into_iter()
.map(|score| score as f32)
.sum::<f32>()
/ (thread_score_count as f32);
if diff_score_count > 0 {
println!("\nAverage thread score: {average_thread_score}");
}
}
println!("\nAverage thread score: {average_thread_score}");
print_header("CUMULATIVE TOOL METRICS");
println!("{}", cumulative_tool_metrics);
@ -579,27 +569,26 @@ pub fn git_branch_for_path(repo_path: &Path) -> String {
}
}
async fn run_judge_repetition(
async fn judge_example(
example: Example,
model: Arc<dyn LanguageModel>,
zed_commit_sha: &str,
zed_branch_name: &str,
run_id: &str,
run_output: &RunOutput,
round: u32,
enable_telemetry: bool,
cx: &AsyncApp,
) -> Result<JudgeOutput> {
let judge_output = example.judge(model.clone(), &run_output, round, cx).await;
let judge_output = example.judge(model.clone(), &run_output, cx).await;
let diff_evaluation;
let thread_diff_evaluation;
let thread_evaluation;
if let Ok(output) = judge_output.as_ref() {
diff_evaluation = Some(output.diff.clone());
thread_diff_evaluation = output.thread.clone();
thread_evaluation = Some(output.thread.clone());
} else {
diff_evaluation = None;
thread_diff_evaluation = None;
thread_evaluation = None;
}
if enable_telemetry {
@ -609,9 +598,9 @@ async fn run_judge_repetition(
zed_branch_name = zed_branch_name,
run_id = run_id,
example_name = example.name.clone(),
round = round,
example_repetition = example.repetition,
diff_evaluation = diff_evaluation,
thread_evaluation = thread_diff_evaluation,
thread_evaluation = thread_evaluation,
tool_metrics = run_output.tool_metrics,
response_count = run_output.response_count,
token_usage = run_output.token_usage,
@ -619,6 +608,8 @@ async fn run_judge_repetition(
model_provider = model.provider_id().to_string(),
repository_url = example.base.url.clone(),
repository_revision = example.base.revision.clone(),
diagnostic_summary_before = run_output.diagnostic_summary_before,
diagnostic_summary_after = run_output.diagnostic_summary_after,
diagnostics_before = run_output.diagnostics_before,
diagnostics_after = run_output.diagnostics_after,
);