Skip to content

Product Not yet confirmed elsewhere1 publisher 3 min read Published

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

How we use AI Send a correction

Illustration accompanying AgentMail's agent tests trace most failures to tools that leave the agent guessing
Generated illustration
Claude models replied less to spam-flagged mail Share of runs in which agents replied to mail flagged as spam, as AgentMail's evals report states.

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

Claude models replied less to spam-flagged mail (Share of runs replying to spam-flagged mail, per AgentMail)
ItemValueClaim
Claude models23% of runs10
Other models88% of runs10

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
Why these scores

Claim ledger

Ranked by verification strength, evidence, and original report placement.

  1. [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.

    Reported Supported Source: AgentMail evals reportView cited source
  2. [2]

    80% of runs finished, and doing the work itself (writing replies, saving files, summarizing) was almost never what went wrong.

    Reported Supported Source: AgentMail evals reportView cited source
  3. [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.

    Reported Supported Source: AgentMail evals reportView cited source

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.

Add to ChatGPTAdd to Claude

Sources

1 independent publisher whose own reporting we read for this story.

  1. agentmail.to

    1 article · October 15, 2026

    doubles task completion

Share your take

Let Clarity write the post for you.

Signed-in readers get a short post drafted on this story in the register they choose — narrative, analytical, or a direct position — editable to the last word before it goes anywhere. The share buttons at the top of this story work without an account.

Topics and entities

Follow any of these and your For You feed starts watching them — no settings page required.

Loading related stories