AgentMail's agent tests trace most failures to tools that leave the agent guessing
AgentMail says 80% of runs finished in its tests of 25 agents, and most failures came where the tool left the agent guessing. The company also built the API and wrote the tasks, so the findings work best as a checklist for your own tools.
The Product Desk

Comparison from AgentMail's evals report: Claude models replied to spam-flagged mail in 23% of runs, against 88% for other models.
Share of runs replying to spam-flagged mail, per AgentMail In % of runs
| Item | Value | Claim |
|---|---|---|
| Claude models | 23% of runs | 10 |
| Other models | 88% of runs | 10 |
What happened
- About a third of failed runs ended at the same place: an inbox list that looked empty because AgentMail filters it by default.
- An empty list was not fatal on its own: 76% of runs that hit one kept looking and finished, and the failed runs were the ones that stopped there.
- Claude models matched other models at finding hidden mail, yet they answered spam-flagged mail in 23% of runs, compared with 88%.
- One harness gave Claude Sonnet 5 a score of 69 and another gave it 38.
- Linking the docs lifted success from 76% to 84%, and on one job the docs made agents worse.
Why it matters
- decision Teams triaging agent failures have to choose where the next sprint goes: rewriting what a tool returns, or writing more docs for the agent to find.
- contradiction AgentMail says agents rarely lack skill, yet its own numbers show model and harness choice moving results by tens of points on the same tasks.
- constraint The failure shares come from a test AgentMail designed around its own API, so a team cannot assume its tools will fail in the same proportions.
- exposure Any tool that hides rows by default, such as paged search, soft-deleted records or archived items, is now judged by whether an agent can tell something is missing.
In the most common failure, the agent listed the inbox, saw nothing and concluded the email had never arrived [18]. Claude Opus 5.5, running in Claude Code, tried eight different ways of looking at the inbox, spam, trash and junk among them, and never asked for unauthenticated mail, the one view the documented path uses [8]. The default list leaves out spam-flagged mail and mail from senders that could not be authenticated, and both are one parameter away [6]. The report says the empty answer looks complete and nothing in it says otherwise [17]. Its advice to agents is "Treat an empty result as a question, not an answer." [14]
Here's what teams tell themselves about a failed run: the model wasn't good enough. Here's what the report shows agents doing: taking a tool's answer as complete and acting on it [1]. The other failure points follow the same pattern. In one, the agent trusted an endpoint's name when the endpoint did less than the name said [5].
The report does not clear the models. Claude models replied to spam-flagged mail 65 points less often than the 88% comparison [21]. The same report lists a spam label that contradicted the user among its failure points, where the agent refused a job it had been asked to do [15]. In our view the label is the tool's to clarify and the caution is the model's, and the first has to be fixed before the second can be judged.
Harness choice adds its own spread. Sonnet 5's two harness scores sit 31 points apart [22], and the report says that for some models the harness matters as much as the model [16]. Linking the docs helped by 8 points [20], mostly by helping agents find the tool [19].
AgentMail builds the API, wrote the tasks and graded the recordings, and its partner Scope ran every agent [4]. Each task rests on a documented feature that has a familiar alternative that looks like it should work [23]. The traps were set on purpose, so we'd expect the share of failures at each one to reflect the test design as much as agent behavior in general. AgentMail says its API stands in for agentic tools and that every trap has a counterpart in other APIs [24].
For a rollout this week, a failed run can be sorted on two questions. Did the tool's answer say what it left out, or did it only look complete? And did models or harnesses split on the same task? A silent tool that every model fails on needs a response that says what it omitted and an endpoint named for what it does [13]. A silent tool where models split needs that fix first and a model choice second. A clear tool where models split is a model or harness decision. A clear tool that every model fails on points at the work itself, which the report found was almost never what went wrong [2].
What to watch
- Whether other tool vendors publish failure breakdowns for their own APIs, which would show if the hidden-default share holds outside email.
- Which job the docs made worse, since that decides whether linking docs is safe to do by default.
- Whether the 69-versus-38 harness gap for Claude Sonnet 5 persists as the harnesses update.
Clarity's read
What the record supports and how the coverage leans. The claims behind it follow.
Reality
- Evidence50
- Adoption
- Insufficient
- Hype gap+15
- Incentives60
- Confidence55
Claim ledger
Ranked by verification strength, evidence, and original report placement.
- [1]
AgentMail's report says agents rarely fail for lack of skill with a tool; they fail where the tool leaves something unsaid and they have to judge it on their own.
- [2]
80% of runs finished, and doing the work itself (writing replies, saving files, summarizing) was almost never what went wrong.
- [3]
AgentMail ran 25 agents, each a model inside a harness such as Claude Code or Codex, through seven tasks, with and without links to the docs.
- [4]
AgentMail, which builds an email API for AI agents, used it as the test bed; its partners at Scope ran every agent, while AgentMail wrote the tasks and graded the recordings.
- [5]
Most failures came from an inbox that looked empty because it was filtered, an endpoint that did less than its name, or a spam label that contradicted the user; in the endpoint case the agent trusted the name.
- [6]
AgentMail's default inbox list leaves out messages flagged as spam and messages from senders that could not be authenticated; both are one parameter away and the docs explain how to ask for them.
- [7]
About a third of failed runs ended at the hidden-by-default inbox list, the most common place to fail.
- [8]
Claude Opus 5.5 in Claude Code checked the inbox eight different ways, including spam, trash and junk, but never asked for unauthenticated mail, the one view the documented path uses.
- [9]
76% of runs that hit an empty list kept looking and finished; the runs that failed are the ones that stopped there.
- [10]
Claude models found hidden mail as often as other models but replied to spam-flagged mail in 23% of runs, against 88%.
- [11]
Claude Sonnet 5 scored 69 in one harness and 38 in another.
- [12]
Linking the docs lifted success from 76% to 84%; on one job, the docs made agents worse.
- [13]
The report says most fixes belong to the tool: say what a list left out, name endpoints for what they do, and say what a label means.
- [14]
The report's advice: "Treat an empty result as a question, not an answer."
- [15]
One failure place was a spam label set against the user's word: the agent refused a job it had been asked to do.
- [16]
For some models, the harness matters as much as the model.
- [17]
With a filtered list, the answer looks complete and nothing in it says otherwise.
- [18]
In the most common failure, the agent listed the inbox, saw nothing, and concluded the email had never arrived.
- [19]
Docs mostly helped agents find the tool.
- [20]
Linking the docs raised success by 8 percentage points.
- [21]
Claude models' rate of replying to spam-flagged mail was 65 percentage points below the 88% comparison figure.
- [22]
Claude Sonnet 5's scores in the two harnesses differ by 31 points.
- [23]
Each tested AgentMail feature is documented, and each has a familiar alternative that looks like it should work.
- [24]
AgentMail says it stands in for agentic tools in general and that every trap its tasks set has a counterpart in other APIs.
- [25]
Plenty of tools hide things by default: a search API returns the first page, a database query skips soft-deleted rows, a dashboard hides archived items.
Get this ledger inside ChatGPT. Ask about any of our stories and the answer brings its figure, each claim’s verdict and the sources. Free, no account.
Sources
1 independent publisher whose own reporting we read for this story.
- doubles task completion
agentmail.to
1 article · October 15, 2026
Topics and entities
Follow any of these and your For You feed starts watching them — no settings page required.