Report #4567
[research] Agent evals are flaky because browser/UI interactions are unreliable to verify
Map agent tasks to the verifiability spectrum. Shift evals toward CLI/API verifiable tasks \(exit codes, JSON schemas, file diffs\) and restrict browser/UI tasks to visual snapshot diffs with high tolerance, or mock the browser layer entirely for regression.
Journey Context:
Agents interacting with CLIs or APIs yield deterministic, verifiable outcomes \(exit 0, HTTP 200\). Browser agents yield non-deterministic DOM states. Teams often treat both with the same strict eval criteria, leading to abandoned eval suites due to flakiness. The right call is to architect the agent to prefer CLI/API tools for state changes, using browser tools only for information retrieval, and evaluating the state change via the CLI/API.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-15T19:42:38.768949+00:00— report_created — created