PlaysbyMoat8
Back to the library
The workflow guideProduct & Engineering

Compare model outputs before changing a workflow

Run the same task across candidate models to check whether a model change alters a business-critical evaluation.

5 implementation stepsIntermediate

How this works

Run the same task across candidate models to check whether a model change alters a business-critical evaluation. Use this before replacing the model behind a business workflow. Compare the same inputs and fixed task instructions so a lower price or attractive demonstration does not conceal meaningful changes in output quality.

Freeze a representative test set and rubric, run the current and candidate models under comparable settings, and inspect omissions, unsupported claims, consistency and output-contract failures. Record model identifiers and actual run conditions. Human-reviewed cases determine whether differences matter operationally.

Before you start

Current workflow contract

Define expected outputs and business-critical failures.

Representative cases

Include ordinary, difficult and missing-data inputs with reviewed expectations.

Model access

Use available authorized endpoints and record their identifiers and settings.

Prepare the inputs

test_cases
Required

input, expected behavior and coverage labels

Exclude private data not permitted for the candidate provider.

fixed_prompt
Required

versioned task instructions

Keep it identical unless prompt adaptation is a separate experiment.

models
Required

current and candidate identifiers

Record endpoint, version and relevant generation settings.

evaluation_rubric
Required

quality criteria and hard failures

Agree decision rules before reviewing attractive outputs.

Implementation, step by step

  1. Freeze the comparison

    • Record prompts, cases, settings and expected output schema.
    • Check provider data permissions and endpoint availability.

    Checkpoint: The experiment is reproducible.

  2. Run model candidates

    • Submit the same cases to each available model and capture raw outputs.
    • Record errors, latency and cost metadata where actually available.

    Checkpoint: Comparable run artifacts exist.

  3. Validate contracts

    • Check required fields, formats and deterministic constraints.
    • Separate endpoint failures from content errors.

    Checkpoint: Each output has a structural result.

  4. Review business quality

    • Compare factuality, omissions and task-specific judgments against reviewed evidence.
    • Inspect critical differences manually instead of relying solely on another model's score.

    Checkpoint: The report explains operational regressions.

  5. Prepare a selection recommendation

    • Summarize tradeoffs and unresolved failures within the tested scope.
    • Keep rollout, fallback and monitoring decisions with the workflow owner.

    Checkpoint: The proposed change is reviewable and reversible.

Decisions along the way

Candidate needs a different prompt

Run it as a separately labeled adapted configuration.

Model version is not stable

Record the returned identifier and limit reproducibility claims.

One model refuses or times out

Report it as an operational result rather than silently exclude the case.

What you will produce

model-comparison.json

JSON

Raw and scored comparison evidence.

Include: case_id · model · output · checks · errors · run_metadata

model-change-review.md

Markdown

A bounded decision brief.

Include: quality_differences · critical_failures · tradeoffs · coverage · recommendation

Check the result

  • Confirm identical inputs and prompt versions across models.
  • Inspect hard failures and sampled passing outputs.
  • Verify cost and latency claims come from actual measurements.
  • Check private data was permitted for every tested endpoint.

When something goes wrong

Provider outage disrupts comparison

Separate affected runs and retry only within a bounded plan.

Judge favors wording over correctness

Reapply the task rubric with human review.

Endpoint silently changes behavior

Record the change and rerun critical cases before selection.

A worked example

SYNTHETIC EXAMPLE · NOT A REPORTED BUSINESS RESULT

Request

Synthetic: compare two models on support classification.

Inputs

Both receive 20 fixed conversations. Candidate B produces valid JSON in all cases but assigns two urgent incidents to routine sales; current A does not.

Expected result

Synthetic result: report B's structural success and critical routing regression separately. Do not select B based only on JSON validity or speed.

Run a small pilot

Start small

Compare current and candidate models on one bounded workflow.

Record the baseline

Record baseline errors, latency and review effort.

Agree success criteria

Agree critical-failure and quality criteria before any replacement.

Stop or revise

Stop rollout recommendations if cases, model identity or scoring cannot be reproduced.

Keep the scope clear

  • Passing the comparison does not guarantee future behavior or universal model superiority.
  • Testing does not authorize a production model switch.

Check before using

Use human-reviewed examples and check consistency, omissions, and unsupported conclusions.

Business activities

  • Operate and improve AI workflows

Editorially adapted workflow; not independently tested.

FROM A RECIPE TO YOUR WORKFLOW

Bring the company context together.

This workflow needs reliable inputs before it needs a better prompt. Moat8 Vault brings working information into a readable archive for the AI tools you use.

For this recipe: Representative examples · Fixed prompt · Expected evaluation criteria

Start with one recurring task, agree which sources to use, and review the first result with your team.

Discuss this workflow

What does your team do?

Choose the recurring work you would like to improve.

A field guide, made for work.

Plays is a curated library of anonymized business workflows. Each recipe explains the inputs, steps, tools, and checks you can adapt to your team. These are editorial guides, not independently tested implementations.

When you share a company website, the guide may read a limited number of public pages on that website. Messages and retrieved page text are sent to our AI provider, NVIDIA, to recommend relevant workflows. Share a general description rather than confidential information.

Saved workflows and selected activities stay in this browser. Your chat history and selected company website are kept in this tab and cleared when you reload or start a new chat. The server does not store conversations. Live source monitoring is not enabled.

If you allow analytics, PostHog receives page views and actions such as workflow saves, skill downloads and link clicks. Random browser and session identifiers connect these actions without identifying you by name. Your choice and browser identifier expire after 90 days; sessions restart after 30 minutes of inactivity or 24 hours. We use local storage, not analytics cookies. Messages, company URLs, search text, full referrers and IP addresses are not sent. There are no person profiles or session recordings. You can decline or withdraw in Analytics settings; Do Not Track and Global Privacy Control keep analytics off.

Read the Plays Privacy Notice ↗