Prerequisites
- A model router deployment. To create one, see Use model router.
- A baseline model deployment that represents your current solution or another model that you want to compare.
- A set of representative prompts from your workload. Remove secrets, personal data, and other sensitive information before you use production prompts.
- For automated quality scoring, a judge model deployment that meets the requirements in the toolkit quickstart.
Define the deployment decision
Before you compare deployments, identify the decision that the results need to support. For example, you might be deciding whether to replace a direct model deployment, which routing mode to use, or which models your routing pool should include. Workload-specific acceptance criteria provide a more useful basis for that decision than a general pass threshold. Consider the following dimensions:
The acceptable tradeoff depends on the application. A high-volume classification workload might tolerate a small quality difference in exchange for lower cost. A workload that produces high-impact recommendations might require equivalent or better quality before cost savings matter.
Design a fair workload comparison
Evaluate the configuration that you expect to use in production. Balanced mode and the fully supported model set are useful starting points unless policy, regional availability, or workload requirements call for a different configuration. The following practices help make the comparison useful:- Use a meaningful baseline. Compare model router with the model that currently serves the workload or the direct deployment that you would otherwise adopt.
- Represent the traffic mix. Include common requests, difficult edge cases, long inputs, and high-impact tasks. Group prompts by workload category so that an aggregate result doesn’t hide a category-specific regression.
- Keep the application configuration consistent. Use the same prompts, system instructions, output limits, and application processing where model capabilities allow. Otherwise, a configuration difference might look like a routing effect.
- Plan for human review. Automated scores are estimates. Qualified reviewers should inspect high-impact, regulated, or domain-specific results and cases where the comparison is inconclusive.
- Treat small or unbalanced samples cautiously. Add representative prompts when important categories contain too few examples or results remain uncertain.
Run a comparison
To configure your deployments and run the comparison, follow the toolkit quickstart. You can explore the report with mock data before you connect your deployments. Use the repository guidance as the source of truth for current commands, input formats, judging behavior, statistical methods, pricing calculations, and report fields. For details about why the toolkit calculates its results as it does, see the evaluation methodology. Record the context for each run, including:- The baseline deployment.
- The model router version, routing mode, and model subset.
- The prompt dataset and relevant application settings.
- The acceptance criteria used to interpret the run.
Read the tradeoffs together
A lower estimated cost doesn’t justify a quality regression in an important category. Similarly, a favorable average latency can conceal slow requests that affect users. Compare quality, cost, and latency against the acceptance criteria for the workload rather than reducing the decision to one aggregate score. Consider both workload-level and category-level results. Model distribution can also help explain why quality, cost, or latency changed by showing which underlying models handled different parts of the workload. For metric and report definitions, see Interpret evaluation results.Choose what to try next
Evaluation is most useful when it informs the next product decision. The following examples are considerations, not universal recommendations:
Change one routing lever at a time and rerun the same representative prompt set. Keeping the baseline and application configuration fixed helps you determine whether a routing mode or model subset caused the change.
Validate under production-like traffic
A controlled comparison is an important signal, but it doesn’t reproduce every production condition. Before broad adoption, consider a limited production test that monitors:- Quality signals for important workload categories.
- Estimated and actual usage costs.
- Median and tail latency under expected concurrency.
- Errors, failover behavior, and selected-model distribution.
- Feedback from qualified reviewers and application users.