[SYS.GLOSSARY // VOCABULARY]

Glossary of agent experience

The vocabulary of the product layer — the failure shapes and measurements that show up in agent traffic against an MCP server, Claude Connector or ChatGPT App.

[The category]

Agent experience (AX)

also: AX · agentic experience

How easily an AI agent can complete a real task with your product, determined by the tool contracts it reads and calls rather than by anything a person would see.

An agent never encounters your interface. It gets a list of tool definitions and whatever your server returns, so every affordance a human gets for free — a label, a tooltip, an example, the chance to look at what happened and try again — has to be carried by the contract or it does not exist.

Agent experience optimisation (AXO)

also: AXO · agent experience optimization

The practice of making what you have built work well for AI agents rather than only for people, across two layers: a content layer and a product layer.

The content layer is your site and docs, structured so agents can find, understand and cite you — it overlaps heavily with AEO and GEO. The product layer is your tool contracts, so an agent that has already found you can finish the job. Most published AXO writing so far describes only the first. Vesta works on the second.

Content layer

also: AXO content layer

The half of agent experience optimisation concerned with your site, documentation and structured data — making you findable, understandable and citable by agents and answer engines.

Owned by marketing, measured in citations and share of voice. Overlaps AEO and GEO. Winning it gets you recommended; it does nothing to make the recommendation survive first contact.

Product layer

also: AXO product layer · tool layer

The half of agent experience optimisation concerned with your tool contracts — the names, descriptions, schemas, responses and errors an agent hits when it tries to do a job on your behalf.

Owned by engineering, measured in task completion. This is where a recommendation either converts into finished work or quietly fails. The two layers fail independently, and a company can be excellent at one and hopeless at the other.

[The surface]

MCP server

also: Model Context Protocol server · Claude Connector · ChatGPT App

A server exposing tools to AI agents over the Model Context Protocol. A Claude Connector is one served over streamable HTTP; a ChatGPT App is MCP-backed — three vendor names for one artifact.

There is no accepted collective noun for the three, so it is clearer to name them than to invent an umbrella term. "ChatGPT Plugins" is unrelated: that is the retired 2023 surface, and guides written for it do not describe how any of this works.

Tool contract

also: tool definition · tool schema

Everything a server tells an agent about one tool — its name, description, input schema, response shape and error messages. It is the entire interface; there is nothing else for the agent to read.

The consequence teams underestimate is that a tool description is production API surface, not documentation. It is loaded on every session, it decides routing, and changing its wording changes behaviour as surely as changing the code behind it. It should be versioned like code.

Tool catalogue

also: tool list · tool catalog

The full set of tools a server exposes, loaded into the agent's context before it does any work. Its size and its ambiguity are both routing risks.

Every tool added costs tokens on every request and adds another candidate for the router to confuse. Catalogues grow monotonically because removing a tool feels like a breaking change and nothing in conventional tooling reports that a tool is doing harm.

Context cost

also: context bloat · tool definition overhead

The tokens an agent spends on your tool definitions before it has done anything — paid on every request, whether or not any of your tools get called.

It is the reason "how many tools should we expose" is a real design question rather than a matter of taste. A catalogue that consumes a large share of the context window leaves less room for the instructions, files and reasoning the task actually needs.

[Failure shapes]

Contract failure

also: schema failure · contract error

A tool call that is well-formed and reaches a healthy server, but is wrong in the terms the schema expects — a free-text value where an enum is required, a missing field the description never mentioned, or an error that says what broke without saying how to fix it.

The distinction from an outage matters because contract failures are invisible to uptime monitoring: the server is behaving exactly as written. What you see instead is agents starting tasks and not finishing them.

Silent misroute

also: misrouting · wrong tool selection

An agent calling the wrong tool correctly. There is no error, the server returns 200, and the task fails somewhere downstream for reasons that look unrelated.

This is the failure mode conventional instrumentation is blind to by construction, since a wrong tool called correctly is a successful call. Worse, it reads as adoption: the tool taking the misrouted traffic looks like the popular one. Ambiguity between two similarly-described tools is the usual cause, and diversion is what exposes it.

Diversion

also: diversion after failure · tool switching

An agent failing on one tool and making its next call to a different, adjacent tool — routing around your contract rather than correcting its input.

Diversion is a stronger failure signal than the error that preceded it, because it says the agent judged the tool unusable rather than its own arguments wrong. It is also the clearest evidence that two tools overlap in the model's reading, and it names which two — which is what makes it actionable.

Argument thrash

also: retry loop · argument guessing

Repeated calls to the same tool with mutated arguments — an agent guessing at a contract you did not document.

Thrash burns turns and tokens even when it eventually succeeds, and the successful case is the dangerous one: the task completes, so nothing looks wrong, and the undocumented requirement that caused it stays invisible until you go looking for the pattern.

Abandonment

also: task abandonment · agent gives up

A session that stops immediately after a failure with no recovery attempt — the agent giving up on the task rather than retrying or trying another route.

It is one of the more reliable failure signals in agent traffic, and it is well documented: agents frequently exit their execution loop on a single tool error instead of replanning. Because an abandoned session is short and cheap, it also looks good on any metric built from cost or latency.

Volume without outcomes

also: hollow traffic · false adoption

High call volume on a tool that rarely appears in sessions reaching a terminal action — traffic that never converts into finished work.

It is the counter to reading call counts as engagement. A tool called a great deal may be called repeatedly because it keeps failing, or because it is the nearest plausible target for requests it was never meant to serve. Either way it is a wrong turn lots of agents are taking, not a favourite.

[Measurement]

Task completion

also: task success rate · TSR · completion rate

Of the jobs agents start with your product, the share they finish. The headline number of the product layer, and the one an agent's decision to come back actually depends on.

Your server cannot observe it directly — there is no callback saying the human got what they wanted — which is why much of the tooling substitutes cost and latency as proxies. Those are backwards: an agent that gives up early looks cheap and fast. Completion is inferred instead, from terminal actions reached, abandonment, diversion and argument thrash.

First-try success

also: first try success rate · first-call success

The share of calls to a given tool that succeed without a retry. The best leading indicator of task completion, because it moves before completion does.

Its practical virtue is localisation: it is computed per tool, so it points at the specific contract to fix rather than reporting that the server is generally unwell. A server-level average hides exactly what you are looking for — one badly-typed parameter stalling every task that touches it while eleven healthy tools hold the mean up.

Terminal action

also: completion event · terminal call

The call that only happens when a job is essentially done — the write, the submission, the purchase, the state change.

Sessions reaching one are a floor on task completion rather than the whole picture, since some tasks end legitimately without one. But it is a floor you can trust, computed from traffic you already have, with no cooperation needed from the client.

Tokens per task

also: token cost per task · agent cost

What it costs an agent to get a job done with you, counting the context cost of your tool definitions and the size of your responses as well as the calls themselves.

Read it alongside task completion, never instead of it. On its own it rewards failing quickly, since the cheapest session is the one where the agent gave up immediately.

Session

also: agent session · task session

The ordered set of tool calls an agent made pursuing one job. The unit that makes agent analytics possible, and the thing per-request instrumentation cannot see.

Diversion, argument thrash, abandonment and volume without outcomes are all sequence properties: they exist only in the relationship between calls. A tool that logs every request faithfully and nothing about their order is blind to every one of them.

These are the numbers Vesta moves.

Vesta reads your agent sessions, finds where completion is leaking, names the specific change to make, and measures what it did.