Benchmarks

image
image
image
Version: 2.7.8.5
© 2025 PYE Tech. All rights reserved.

Benchmarks

This page explains Curator Benchmarks for the person who designs the process — analyst, coordinator, business owner. You do not need to know how to program. Whenever a screen name appears, it is explained right there, with an everyday analogy. The animations play on their own: hover to pause and click to watch again.

What a benchmark is

Think of an exam given to several candidates. The exam is the same. The questions are the same. At the end, you compare who got more right, who cost less, and who finished faster.

In Curator, the “exam” is an interpreter — the artificial intelligence recipe that reads an official letter, extracts a field, or classifies a document. Each candidate is an artificial intelligence model (GPT, DeepSeek, Kimi…). Each question is one of your real cases, with the correct answer already known — the reference answer (answer key).

The practical question Benchmark answers is: which artificial intelligence model should I use in this recipe? Instead of choosing by opinion or hype, you measure on your own document base.

The three scores

After the exam, Curator shows three numbers side by side for each model:

Score In plain language
Accuracy What percentage of answers matched the answer key you registered.
Cost How much that model would spend, in dollars, to process that volume. It is an estimate for comparison — it does not replace the provider’s invoice.
Speed How long the model took to process everything.

At the end, Curator builds a ranking. Quality first, savings second: whoever is more accurate goes up; if they tie, the cheaper one goes up; if they still tie, the faster one goes up.

When it is worth it

Use Benchmarks when the model choice has money or quality at stake:

  • Before production. With thirty or fifty cases you find out which model delivers the accuracy you need, before processing thousands of documents.
  • To cut cost without losing quality. Often the cheaper model is nearly as accurate as the expensive one on your task. The number justifies the switch.
  • After changing an instruction. You adjust the text of a step and run the same batch again. If accuracy went up, the change was good.
  • To audit from time to time. Providers update models. Running the same batch each quarter shows whether behavior stays the same.
  • For accountability. The Excel from the run serves as evidence that the choice was measured.

When automatic grading misleads

The benchmark compares the artificial intelligence answer with the answer key you wrote. It measures well tasks with a right and a wrong answer: classifying, extracting a field, choosing among options, answering yes or no.

It measures poorly tasks with many different good answers — free-form summaries, creative text. Automatic grading may mark as wrong a text that is correct, just written differently. In those cases, use manual review: a person judges each answer.

The path in five steps

  1. Build the batch. Register the cases (the questions) and the answer key (the correct answer) for each step.
  2. Choose the models. Two, three, or as many as you want. All of them get the same exam.
  3. Curator runs. Each case, step by step, on each model. You watch live.
  4. Grading. Each obtained answer is compared with the answer key — automatic or by a person, depending on what you chose when creating the batch.
  5. Result. Ranking, charts, and an Excel with case-by-case detail.

Words on the screen

These names appear in menus and reports. Worth knowing before you start:

Name in Curator In plain language
Interpreter The recipe (the exam) to be evaluated, made of chained steps.
Step One stage of the recipe, with its own instruction and its own answer.
Batch The set of exam cases, with the answer key for each one.
Case One real question — a letter, a contract, a specific document.
Reference answer The correct answer expected at that step of that case.
Obtained The answer the artificial intelligence actually returned.
Job One benchmark run: date, models used, and result.
Accuracy The percentage of correct answers.

Building the exam

The batch is the folder with the exam questions. Each case brings two things: the inputs (the letter text, the PDF, what the interpreter needs to read) and the answer key (the correct answer at each step).

The same batch can be reused with different models or on different dates. That is what lets you compare results over time.

How many cases to use

Size What it is good for
Fewer than 10 Only to test whether the recipe works — not to decide on a model.
20 to 50 Usually enough to compare models on classification or extraction with reasonable confidence.
More than 100 More confidence, but also more time and cost — each case runs once per model.
Include the hard cases
A batch made only of easy documents makes every model look great. What separates one model from another are the ambiguous cases, the poorly scanned ones, and the ones outside the standard.

Four decisions when creating the batch

  1. Name. Something that recalls the scenario months later — for example “Letters Q3 2026”.
  2. Who judges. Automatic when the answer is objective (classify, extract). Manual review when free-form text has many valid shapes.
  3. Which instructions. Use today’s (the exam follows the recipe) or freeze a copy (the exam stays fixed even if you change the recipe later).
  4. Where the cases come from. Import a spreadsheet or register them later in the editor.

How to build the spreadsheet

The safest path is the button that generates the Excel template. Curator already creates the right columns for that interpreter: case name, one column per input, and one answer-key column per step (named after the step).

After you choose the file, the mapping screen links each spreadsheet column to the right field. Suggestions come pre-filled; you only adjust what differs. At the end, Curator shows how many cases entered and how many have an answer key.

The answer-key rule

A step without an answer key does not enter the accuracy count.
It does not count as correct and it does not count as wrong: it stays out. If you have 50 cases and 3 steps, but only filled in the key for the first step, accuracy describes only that step — not the whole recipe.
A wrong answer key is a common mistake
When reviewing a bad result, often the answer key was wrong, not the artificial intelligence. Fix it and run again before deciding.

Running the comparison

Before starting, three conditions: the interpreter must have at least one step; the batch must have at least one case; each chosen model must have its access key configured.

Small test before a large batch
Run first with two or three cases and a single model. If the result makes sense, run the full batch. That way you do not spend credit only to discover at the end that a column was linked wrong.

All models get the same exam: same cases, same order, same instructions. One important detail: during the benchmark, the model under test runs the whole recipe, even if in production each step uses a different model. That is how you answer “what if I used only this model”.

While it runs

Models run in parallel — one does not wait for the other. Inside each model, cases run one at a time. Inside each case, steps run in a chain.

The screen shows which case and which step each model is on. You can leave: the run continues in the background. Pause and stop apply to the selected model, not the whole run — useful when one model is too expensive or too slow.

Nothing is lost when you stop
The call already in progress is not cut mid-way. Curator waits for that step to close and saves what was already measured. Partial results remain recorded.

A quick cost check: calls ≈ cases × steps × models. Example: 50 cases × 3 steps × 4 models = 600 calls.

How to read the ranking

Accuracy is: correct steps ÷ steps with an answer key × 100. Steps without a key stay out of the denominator. On screen you see something like “90% (135/150 steps)”.

Automatic grading ignores capitals and extra spaces. What it does not do: judge whether two texts mean the same thing. “TJSP” and “Court of Justice of São Paulo” are different texts — and automatic grading marks them as wrong.

Ranking order: (1) highest accuracy; (2) lowest cost; (3) shortest time. Models that failed go to the bottom. Charts show accuracy, cost, and speed per model — taller bar is better on the accuracy chart; shorter bar is better on cost and time.

The ranking organizes; the decision is yours
If first place is 92% accurate at ten times the cost of second place at 90%, second place may be the right choice. It depends on how much an error costs in your process.

Five questions after the result

  1. Is the base enough? Look at the step count (135/150), not only the percentage.
  2. Did any model truly fail?
  3. Does the accuracy gap matter? Two percentage points can be noise; ten points usually are a signal.
  4. Does the cost difference make up for the accuracy difference?
  5. Where are the errors? In Excel, the details sheet shows case by case — sometimes the problem is the instruction, not the model.

When a person needs to judge

If the batch was created with manual review, the run ends in “Awaiting review”. Accuracy is only defined after you mark each step as right or wrong.

The screen shows the expected answer, the obtained answer, and the case input. You mark it and, if you want, note the reason — useful for diagnosing later. The human mark prevails. Even in manual batches, automatic grading can pre-mark; you confirm or correct.

Report and what to do with the number

The Excel from the run has three sheets:

  • Summary — batch, interpreter, date, best model, costs.
  • Ranking — one row per model with place, accuracy, cost, duration, and state.
  • Details — one row per case, step, and model (expected, obtained, verdict). This is where you diagnose.
Cases nobody got right
If no model got a case right, investigate the answer key first. The registered answer may be wrong.

History keeps recent runs. For long-term audit, export the Excel. The number alone does not decide: use the ranking to organize, the Excel to understand the errors, and the cost of an error in your process to choose the production model.