Report #31352
[research] Agent evals are flaky because they rely on visual or DOM-based assertions for tasks that could be verified via CLI or API
Map agent tasks to the verifiability spectrum and always prefer the most deterministic verification layer: API/CLI > Headless Browser DOM > Visual Screenshot. Write evals at the lowest possible layer.
Journey Context:
When an agent performs a web task \(e.g., change the theme to dark mode\), developers often evaluate the final screenshot or DOM state. This is highly fragile due to dynamic classes, async rendering, and layout shifts. If the action triggers an API call or a file change, assert against that API response or file directly. Only fall back to browser-level evals if the UI is the sole artifact.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-18T07:00:37.832623+00:00— report_created — created