Agent regression testing
Detect changes that break previously accepted agent behaviour
A model, prompt, memory policy or connector has changed. The decision is how to detect changes that break previously accepted agent behaviour. The work begins with your actual workflow and looks for the evidence that separates intended behaviour from a consequential exception. It is particularly relevant to release managers and evaluation owners. A useful outcome is an explicit account of what was examined, what remains uncertain, and which decision the evidence can support.
The release evidence relationship
- Versioned baselines
Establish the basis for protected constraint.
- Baseline revision
Separate a changed requirement from a failed case.
- Regression suite
Retain the scoped finding and its unresolved dependencies.
Decision
Frame the decision around protected constraint
Questions and the evidence they need
- Protected constraint
- Inspect versioned baselines for the relevant constraint or observation.
- Baseline revision
- Inspect accepted case results for the relevant constraint or observation.
- Action comparison
- Inspect change notes for the relevant constraint or observation.
The decision is how to detect changes that break previously accepted agent behaviour. This is relevant to release managers and evaluation owners when a model, prompt, memory policy or connector has changed. Name the affected workflow, the consequence of a wrong decision, and the owner who can act on the result. The initial discussion should establish which evidence is already available and which uncertainty is material enough to investigate.
The specific failure hypothesis is that an improvement in answer quality introduces a new unauthorised write or removes a necessary escalation. It remains a hypothesis until examined in the deployment. Existing internal tests or operating records may already resolve it; identify the uncovered question before commissioning additional work.
Mechanism
Protect required behaviour across each revision
Relationships within release evidence
- Protected constraint
- Retain approval and correct-target requirements.
- Baseline revision
- Separate a changed requirement from a failed case.
- Action comparison
- Compare tool effects as well as generated responses.
What this specialty examines
A protected behaviour is a requirement that should survive a change, not necessarily an exact response string. Preserve constraints such as requiring approval, selecting the correct account and avoiding duplicate writes. Allow legitimate variation in phrasing or reasoning that does not alter the requirement.
The review should replay protected behaviours against both revisions and inspect changes in tools, state and final responses. Identify the normal route, relevant exceptions and the authoritative record of the outcome. Inspect the relevant business-system record, enforcement event or process evidence alongside any reported status. Keep incomplete cases visible, with an explanation of what their absence prevents the owner from concluding.
The tradeoff to make explicit
For this decision, stable regression cases protect known behaviour but need refresh when workflows legitimately change. Compare the available design or operating choices against the same intended outcome. If one option removes a required control or changes the task boundary, describe that difference before treating its apparent simplicity, speed or lower effort as an improvement. The decision should expose the tradeoff instead of burying it in an aggregate score.
Preparation
Connect the working inputs to the boundary being examined
Evidence packet for protected constraint
Illustrative working format
- Versioned baselines
- Keep workload, quality, human effort, and uncertain inputs visible in comparisons.
- Accepted case results
- Retain the observed conditions and distinguish gaps from contrary evidence.
- Change notes
- Name the custodian and the conditions requiring a refreshed version.
- Release configurations
- Match this description to the deployed or proposed boundary being examined.
Start with versioned baselines, accepted case results, change notes and release configurations. Identify the owner, revision and operating context of each source. Sanitised examples may support initial design, but differences from actual conditions should remain explicit. Where direct access is unsuitable, a customer-controlled evidence or execution route may be considered, with agreed handling and retention.
The scope also needs the release owner, agreed expectations for a representative task case, and the authority to inspect the relevant boundary. Specify what evidence would distinguish the failure in which an improvement in answer quality introduces a new unauthorised write or removes a necessary escalation from acceptable behaviour. If stakeholders disagree about intended behaviour, resolve the interpretation before classifying the observed difference as a defect.
How the work proceeds
Carry protected constraint through to an accountable finding
From the scoped material to a decision record
- Versioned baselines
Separate hard constraints from graded preferences.
- Baseline revision
Apply the scoped check to action comparison.
- Regression suite
Record the evidence, open dependencies, and the owner’s next decision.
Prepare the evaluation cases
Work with release managers and evaluation owners to assemble versioned baselines, accepted case results, change notes and release configurations. Select a normal task, a consequential exception and a case with insufficient information. Identify the relevant requirement and expected result for each, then mark which outcomes need human adjudication. The preparation output is a case packet that separates blocking behaviour from graded quality preferences before any comparison is run.
Run and review the comparisons
When a case changes, record whether the product requirement changed or the old expectation was mistaken. Do not overwrite a failed baseline simply to make the new release green. Keep the rationale and approval for new expectations separate from the observed comparison.
Choose the release or evaluation change
Use the reviewed cases to produce a regression suite and change report separating fixes, losses and unresolved differences. Distinguish a product defect from a missing test, an ambiguous requirement or an unreliable measuring method. For each, name the proposed correction and the case that would check it. The release owner can then decide whether to change the implementation, improve coverage or restrict the intended use while a specific gap remains.
Indicative artefact
Make the regression suite usable by its owner
Regression suite
Illustrative working format
- Regression suite
- Identify the assessed workflow, revision, and decision boundary.
- Fixes
- Link supporting and contrary observations to inspectable evidence.
- Losses
- Name the unresolved condition, next action, and accountable owner.
A useful decision artefact is a regression suite and change report separating fixes, losses and unresolved differences. Supporting material may include selected cases, configuration or process records, evidence references, a disagreement log and prioritised actions. Retain the case selection rationale and material disagreements alongside the result; otherwise the result may be mistaken for complete coverage.
Illustrative scenario
Examine action comparison through a constructed exception
A constructed case and its decision paths
Illustrative scenario
- Protected constraint
A shorter prompt omits confirmation before a subscription change.
- Baseline revision
Inspect whether confirmation vanished from text or actual control flow.
- Action comparison
Retain the regression if required authorisation was removed.
Consider a fictional situation: a shorter prompt reduces verbosity but causes an assistant to skip confirmation before changing a subscription. The scenario is illustrative, with no client engagement, executed test or measured improvement implied.
For the shorter prompt, inspect whether the confirmation step disappeared only from text or from the action sequence itself. If authority checks still hold elsewhere, the consequence differs. The regression report should connect the changed behaviour to the actual control boundary.
Scope and next action
Keep the conclusion within selected task cases
Confirm fit before the next commitment
- Protected constraint
- This review is limited to selected task cases.
- Versioned baselines
- The relevant owner must confirm access and the intended operating conditions.
- Regression suite
- The customer retains the release decision.
A result applies to the recorded configuration and selected cases. It does not establish universal agent competence or authorise release. Any engagement depends on an agreed scope, qualified team, authorised access and confirmed availability. Bring the affected workflow, its current configuration or process, the triggering change and the evidence already available. The immediate scope question is prompted by the situation in which a model, prompt, memory policy or connector has changed; confirm which missing observation would change the owner’s next action.
Ways to engage
Related engagement scopes
AI Agent Evaluation Evidence Diagnostic
Find the gaps between your release decision and the evidence behind it. Start with one agent workflow and a bounded set of questions.
AI Agent Evaluation Foundation
Turn scattered tests into a repeatable release discipline. Connect the behaviours that matter to datasets, evaluation criteria and evidence your team can maintain.
AI Long-Horizon Agent Evaluation
Examine what changes when an agent keeps working. Evaluate accumulated state, recovery and goal adherence across extended tasks.
Continue exploring
Related insights and resources
Engineer the harness, not just the prompt
Define the contracts around an agent's decisions: what state it trusts, which actions can execute, how interrupted work resumes, and what evidence an operator needs to recover safely.
What would justify releasing this agent?
Replace a single pass rate with a reviewable chain of requirements, cases, observations and judgements. Distinguish task quality, control failures and uncertainty before increasing an agent's exposure.
The evidence behind the go-live decision
A working paper for leaders who need to explain why an agent workflow is ready for its next release. Includes a proposed evidence-pack structure, decision table and review agenda.