Skip to content

Design & UX

How to Design for AI Agents: An Agent Experience (AX) Guide

Your website now has two users: people and the AI agents they send. Learn how agents read pages, what stops them and how to fix it in 30 days.

Close-up of a person's hand with a smartwatch reaching toward a laptop trackpad, the screen softly blurred in a dim workspaceHow to Design for AI Agents: An Agent Experience (AX) Guide

Design for AI agents is the practice of building pages that software agents can read and operate as reliably as people can. In practice that is semantic HTML, a clean accessibility tree, predictable controls and machine-readable facts, so an agent asked to compare, book or buy on your site finishes the task instead of giving up.

Key Takeaways

  • Your website now has two kinds of users: people, and AI agents acting for people. Browser agents from OpenAI, Google, Anthropic and Perplexity can already click, type and check out.
  • Agents read pages through screenshots, the DOM and the accessibility tree. The accessibility tree is the most reliable of the three, and it is the same tree screen readers use.
  • Most agent failures are old accessibility bugs: clickable divs, unlabeled fields, icon-only buttons, hover-only menus and stacked pop-ups.
  • Structured data and plain-text policies let agents quote your prices, stock and returns correctly instead of guessing.
  • New standards (MCP, WebMCP, NLWeb and agentic commerce protocols) are worth tracking, but most sites gain more this quarter from fixing markup.
  • Use the 20-point audit and 30-day plan below to move one level up the agent-readiness ladder.

This guide is for marketing leaders, product owners and founders who own a website that sells, books or generates leads. It is written by the Cyberdunes design team, which has done UX consulting and UI design on scalable products for more than eight years. The checklist below comes from that practice, and every check in it can be run by your own team without special tools.

What Is Agent Experience (AX)?

Agent experience (AX) is the quality of the experience an AI agent has when it uses your product or website. The term was introduced by Netlify co-founder Mathias Biilmann in January 2025, who defined it as "the holistic experience AI agents will have as the user of a product or platform."

AX sits next to user experience (UX) and developer experience (DX). UX asks whether a person can reach their goal. AX asks whether an agent, sent by that person, can reach the same goal without a human stepping in. The two overlap heavily. A form that a screen reader user can complete is usually a form an agent can complete.

The business case is simple. When a buyer asks an assistant to "find a 3-night stay in Goa under 15,000 rupees and book the best-rated one," the agent shortlists sites it can actually operate. If your booking flow stalls it, the agent moves to a competitor and the buyer may never see your brand. We covered the wider shift in our piece on the UX shifts product teams cannot ignore.

Which AI Agents Are Using Websites Today?

Every major AI company now ships an agent that can operate a browser. Some run in your visitor's own browser; others run in a separate browser that the agent controls. The table lists what we could verify from vendor documentation and announcements as of October 2026.

AgentMakerHow it sees the pageStatus (verified)
Gemini 2.5 Computer UseGoogleScreenshot, current URL and recent action historyDeveloper model since October 2025; versions also power Project Mariner and some agentic features in AI Mode
Comet browserPerplexityA full browser with a built-in assistant that acts on open pagesReleased free worldwide in October 2025
Claude for ChromeAnthropicSees the active tab, clicks buttons and fills formsAvailable to Pro, Team and Enterprise plans since December 2025
Computer use toolsOpenAI and AnthropicScreenshots plus mouse and keyboard actionsAvailable to developers through the OpenAI and Claude APIs
ChatGPT agentOpenAISigns its HTTP requests with Web Bot AuthListed by Cloudflare as one of the first signed agents in August 2025

Agents differ in how they see a page, but they all fail on the same weak spots. That is good news: one set of fixes serves all of them.

How Do AI Agents Perceive a Web Page?

Agents read a page through up to four layers: the rendered screenshot, the HTML and DOM, the accessibility tree, and any data or tools the site declares on purpose. The more an agent can rely on the last two, the faster and more accurately it works.

Diagram of four layers an AI agent can read on a web page: screenshot pixels, HTML and DOM, the accessibility tree, and declared data and tools such as Schema.org, NLWeb, WebMCP and MCP servers
Agents move from guessing at pixels to reading what the site declares; the accessibility tree is the reliable middle layer.
  • Screenshots. Computer use models look at the screen and return clicks and keystrokes. Google describes the Gemini model's loop as a user request, "screenshot of the environment, and a history of recent actions," followed by an action and a new screenshot (Google, October 2025). Anything that is visually ambiguous, such as two identical icons, slows this loop down.
  • HTML and DOM. Text agents read source and live elements. Content that appears only after hover, scroll or a script the agent never fires is invisible to them.
  • Accessibility tree. The browser's list of roles, names and states, built for screen readers. Microsoft's Playwright MCP server, a common way to give agents a browser, "uses Playwright's accessibility tree, not pixel-based input" and needs no vision model (Microsoft on GitHub).
  • Declared data and tools. Schema.org markup, feeds and explicit actions, covered in the standards section below.

The practical lesson: you cannot design for one agent's perception. Design so that all four layers tell the same story.

Why Is Accessible Design Also Agent Design?

Accessible design is agent design because agents and assistive technology consume the same signals: native elements, accessible names, visible labels and keyboard operability. If a screen reader can announce a control correctly, an agent can usually find and use it.

The W3C's first rule of ARIA says that if a native HTML element already has the semantics and behavior you need, use it instead of repurposing another element and adding ARIA (W3C, Using ARIA). The data shows why. In the WebAIM Million 2026 report, home pages that used ARIA averaged 59.1 detected errors, against 42 on pages without it. More ARIA often means more custom widgets, and more places for names and roles to go wrong.

The same report shows how common the agent-breaking bugs are: 51% of home pages had unlabeled form inputs, 46.3% had links with no text and 30.6% had buttons with no text. Each of those is a control an agent cannot identify by name. Our WCAG 2.2 AA checklist covers how to find and fix them with owners and effort estimates.

Before and After: One Control, Two Agent Views

Here is a common pattern on ecommerce sites. The "before" version works for a sighted mouse user and nobody else.

<!-- Before -->
<div class="btn" onclick="add(42)">
  <svg>...</svg>
</div>

<!-- After -->
<form action="/cart" method="post">
  <button type="submit" name="sku" value="42">
    Add to cart: Linen shirt, size M
  </button>
</form>
Side-by-side comparison of a div-based add to cart control that exposes only a generic node with no name, and a native button that exposes the role button and a descriptive accessible name
A native button gives agents and screen readers a role, a name and keyboard behavior with no extra code.

The "after" version also works without JavaScript, which matters for text-based agents, and its accessible name tells the agent exactly which product and size it is adding. It is a small change that removes a whole class of failed purchases.

What Breaks AI Agents on Websites?

Agents fail on the same patterns that fail keyboard and screen reader users, plus a few that are specific to automation, such as puzzle CAPTCHAs and facts locked in images. Fix the eight below first.

Table of eight website patterns that stop AI agents, including clickable divs, icon-only buttons, hover-only menus, infinite scroll, stacked modals, unlabeled fields, puzzle CAPTCHAs and prices in images, each with the reason and the fix
Every agent fix on this list is also an accessibility fix for people.

Two of these need a business decision, not only a code change:

  • CAPTCHAs and bot walls. Agent makers tell their agents to hand control back to a person at sensitive steps. Anthropic's computer use guidance, for example, asks developers to have a human confirm decisions "such as accepting cookies, completing financial transactions, or agreeing to terms of service" (Anthropic documentation). A puzzle on every step makes that hand-off constant. Cloudflare's signed agents program, which uses cryptographic Web Bot Auth signatures, offers a way to recognize legitimate agents instead of blocking all automation. Decide which bots you allow first; our guide to which AI crawlers to allow, block or charge walks through that choice.
  • Infinite scroll. Keep it if your engagement data supports it, but give every batch a real paginated URL and a "Load more" button, so agents and people can reach item 61.

Security: Make Agents Welcome Without Making Them Dangerous

An agent-friendly site must not become an attack surface. Agents can be tricked by instructions hidden in page content, known as prompt injection. When Anthropic tested Claude for Chrome against deliberate attacks, the attack success rate was 23.6% before mitigations and 11.2% after, in autonomous mode (Anthropic, August 2025). OpenAI's guidance is that page text "cannot grant permission or override the user's instructions," and it asks developers to keep humans in control of purchases and irreversible changes (OpenAI documentation).

For site owners that means three rules. Moderate user-generated content such as reviews and Q&A, because it is where injected instructions hide. Keep explicit confirmation steps for payments, account changes and data sharing. And never rely on the agent to enforce your business rules: validate prices, stock and limits on the server, exactly as you would for a human. Our website security checklist covers the server-side basics.

How Do Structured Data and Machine-Readable Policies Help Agents?

Structured data gives agents facts they can trust without interpreting your layout. Product, Offer, Organization and FAQ markup in Schema.org JSON-LD tells an agent the price, currency, stock status and seller in a fixed format.

Policies matter as much as prices. An agent comparing two stores will check delivery and returns before it recommends one. Google already supports MerchantReturnPolicy markup, which can be set once at the Organization level and overridden per offer, with properties such as returnPolicyCategory, merchantReturnDays and returnFees (Google Search Central). Publish the same policy as plain text on a stable URL, and make sure the two match.

Checklist for machine-readable facts:

  • Prices, sizes, stock and delivery dates appear as text in the HTML, not only in images or after a script runs.
  • Product and Offer markup matches the visible page exactly, including currency.
  • Returns, shipping, cancellation and warranty policies live on their own URLs and are marked up where a schema exists.
  • Contact options, opening hours and locations are consistent across your site and public profiles.
  • An llms.txt file points AI systems to your most useful pages. See how llms.txt, IndexNow and Schema.org work in Apex®.

The same signals help AI search engines quote you correctly, which is the core of generative engine optimization (GEO). Our explainer on how LLMs choose sources to cite shows why consistent facts across pages matter.

Which Emerging Standards Should You Track?

Four standards are worth tracking: MCP for connecting agents to data and tools, WebMCP for exposing page actions to browser agents, NLWeb for natural-language access to site content, and the Agentic Commerce Protocol for checkout. Only some are ready for production, so match your investment to their maturity.

StandardWhat it doesStatus (October 2026)Action now
Model Context Protocol (MCP)Open standard for connecting AI assistants and agents to tools and dataDonated to the Linux Foundation's Agentic AI Foundation in December 2025; more than 10,000 active public servers and adoption by ChatGPT, Cursor, Gemini, Microsoft Copilot and VS Code (Anthropic)Expose content or catalog data through an MCP server if you already have APIs
WebMCPLets a web page offer JavaScript tools, or annotated HTML forms, to browser agentsAvailable for prototyping to early preview program participants in Chrome since February 2026Prototype on one high-value form; do not depend on it yet
NLWebOpen project from Microsoft for natural-language interfaces built on Schema.org, RSS and similar data; every NLWeb instance is also an MCP serverAnnounced May 2025Clean Schema.org and feeds first; they are the input NLWeb uses
Agentic Commerce Protocol (ACP)Checkout flows between buyers, AI agents and businesses; the merchant stays merchant of recordOpen source under Apache 2.0, developed by Stripe and OpenAI (agenticcommerce.dev)Evaluate if you sell through ChatGPT or use Stripe

For retailers, our guide to preparing a store for AI shopping agents covers the commerce protocols in depth, our news brief on Google's agentic checkout tracks Google's side, and MCP for marketing teams explains where MCP fits in a content operation.

The Agent-Readiness Audit: A 20-Point Checklist

An agent-readiness audit tests whether an agent can find, understand and complete your top tasks. Run it on your three most valuable journeys, such as "find a product and add it to cart," "book a demo" and "check the returns policy." Each check below has a test you can run without special tools.

#CheckHow to testOwnerEffort
1Agents are not blocked at the edgeReview robots.txt, CDN bot rules and WAF logs for agent user agentsDevOpsLow
2Core content is in server HTMLView source; key text and prices must be present without JavaScriptDeveloperMedium
3One H1 and a logical heading orderBrowser accessibility panel or a headings bookmarkletContentLow
4Landmarks for header, nav, main and footerAccessibility tree shows banner, navigation, main, contentinfoDeveloperLow
5Every control is a native button or linkSearch templates for onclick on div or spanDeveloperMedium
6Every control has a clear accessible nameAutomated scan for empty buttons and linksDeveloperLow
7Every field has a visible labelClick each label; focus must move to its fieldDesignerLow
8Autocomplete tokens on address and contact fieldsInspect inputs for autocomplete values such as email and postal-codeDeveloperLow
9Error messages are text and tied to fieldsSubmit an empty form; read the messages aloud with a screen readerDesignerMedium
10Menus open on click and keyboard, not hover onlyTab through the header with no mouseDeveloperMedium
11Lists have paginated URLsLoad page 3 directly by URLDeveloperMedium
12One dialog at a time, with a named close buttonTrigger cookie, newsletter and chat prompts on one page viewMarketingLow
13No puzzle CAPTCHA before checkout or enquiryComplete the journey in a fresh browser profileProductMedium
14Prices and stock match markupCompare visible values with the Rich Results Test outputEcommerceLow
15Policies on stable, marked-up URLsOpen returns, shipping and cancellation pages; check schemaLegal and contentLow
16Confirmation step before payment or data sharingWalk the checkout; there must be an explicit review stepProductLow
17Server-side validation of price, stock and limitsTamper with a request in a test environmentDeveloperMedium
18User-generated content is moderatedReview reviews and Q&A for hidden instructions or linksCommunityOngoing
19A browser agent completes each top journeyGive Claude for Chrome, Comet or a computer use demo the task in plain wordsUXMedium
20Agent traffic is visible in analytics and logsSegment known agent user agents and signed requestsAnalyticsMedium

Check 19 teaches the most. Watch where the agent hesitates: every pause is a label, a name or a layout ambiguity you can fix. Then score your site on the ladder below.

Five-step agent-readiness ladder from level 0 Blocked, through Readable, Operable and Structured, to level 4 Declared, where key actions are exposed as tools or protocols
Most sites should reach level 3, Structured, before investing in level 4 protocols.

A 30-Day Plan to Make Your Site Agent-Ready

Thirty days is enough to move most marketing and ecommerce sites from level 1 or 2 to level 3. The plan assumes one developer, one designer and a product or marketing owner.

  1. Days 1 to 3: Pick journeys and baseline. Choose three journeys tied to revenue. Run checks 1 to 20 and record pass or fail. Ask a browser agent to complete each journey and screen-record the attempts.
  2. Days 4 to 10: Fix controls and forms. Replace clickable divs with native elements, name every icon button, label every field and add autocomplete tokens. These fixes usually live in a few shared components, so one change repairs hundreds of pages.
  3. Days 11 to 17: Fix structure. Make menus keyboard and click operable, add paginated URLs behind infinite scroll, limit pop-ups to one at a time and move key facts out of images.
  4. Days 18 to 24: Publish machine-readable facts. Align Product, Offer, Organization and return policy markup with visible content. Publish policies on stable URLs and add llms.txt.
  5. Days 25 to 30: Retest and set guardrails. Rerun the agent tests and the audit. Add automated accessibility checks to your release pipeline so regressions fail the build, and review agent traffic monthly.

Teams that want to build these skills in-house can start with our UX/UI Masterclass, which covers accessible interaction design from first principles.

Get an agent-readiness review from our UX team

How Cyberdunes and Apex® Help You Design for AI Agents

Our UX and UI design services run the audit above on your real journeys, fix the shared components and test with both screen readers and browser agents. We focus on the changes that help human visitors and agents at the same time, so the work pays back even before agent traffic grows.

If your site runs on Apex®, the AI-native digital experience platform (DXP), several level 3 and level 4 building blocks are already there: Schema.org JSON-LD and metadata, XML sitemaps, IndexNow and llms.txt, plus MCP support so assistants can work with your Apex® content through a standard interface (see connecting AI assistants with MCP). Apex® also tracks how ChatGPT, Gemini, Claude, Perplexity and Google AI Overviews describe and cite your brand, which tells you whether AI assistants are getting your facts right. None of this guarantees that an agent will choose you; it removes common reasons it would not.

Sources

FAQs

Questions, Answered

Can’t find what you’re looking for? Our team is happy to help.

What does it mean to design for AI agents?

Designing for AI agents means building websites that software agents can read and operate as reliably as people can. It relies on semantic HTML, a clean accessibility tree, clearly named controls, labeled forms and machine-readable facts such as Schema.org markup, so an agent sent by a buyer can compare, book or buy on your site without a human stepping in.

What is agent experience (AX)?

Agent experience (AX) is the quality of the experience an AI agent has when it uses your product or website. Netlify co-founder Mathias Biilmann introduced the term in January 2025. It extends user experience and developer experience to agents: can an agent acting for a person reach the same goal, with no human help?

How do AI agents read a website?

AI agents read websites through screenshots, the HTML and DOM, the accessibility tree and any data or tools the site declares. Computer use models such as Gemini 2.5 Computer Use work from screenshots, while tools such as Playwright MCP read the accessibility tree directly. Sites that keep all four layers consistent are the easiest for agents to use.

Does web accessibility help AI agents?

Yes. Agents and assistive technology rely on the same signals: native HTML elements, accessible names, visible labels and keyboard operability. A button a screen reader can announce correctly is usually a button an agent can find and press. Fixing unlabeled fields and empty buttons, which WebAIM found on 51% and 30.6% of home pages in 2026, helps both.

What website patterns break AI agents?

The most common agent blockers are clickable divs instead of buttons, icon-only buttons with no name, hover-only menus, infinite scroll without paginated URLs, stacked pop-ups, unlabeled form fields, puzzle CAPTCHAs on every step and prices or policies shown only in images. Each one is also an accessibility problem for people, so one fix helps both audiences.

Should I block AI agents with CAPTCHAs?

Not by default. Puzzle CAPTCHAs on every step stop legitimate agents acting for real customers. A better approach is risk-based protection, explicit confirmation before payments and data sharing, and recognizing verified agents. Cloudflare's signed agents program, launched in August 2025, uses Web Bot Auth signatures so sites can identify legitimate agent traffic instead of blocking all automation.

Which AI browser agents exist in 2026?

Verified examples include Google's Gemini 2.5 Computer Use model, which also powers Project Mariner and agentic features in AI Mode; Perplexity's Comet browser, free worldwide since October 2025; Anthropic's Claude for Chrome, available on Pro, Team and Enterprise plans; OpenAI's ChatGPT agent; and computer use tools in the OpenAI and Claude APIs for developers.

What is WebMCP?

WebMCP is a proposed web API that lets a page offer JavaScript-based tools, or annotated HTML forms, to AI agents in the browser. Chrome opened it to early preview program participants in February 2026, so it is not yet a finished standard. It is worth prototyping on one form, not depending on.

Do I need MCP or NLWeb to be agent-ready?

No. Most sites gain more from fixing markup, forms and structured data first. MCP and NLWeb are useful once your content and data are clean, because they expose that same data to agents through a standard interface. NLWeb, for example, builds on the Schema.org and RSS data a site already publishes, so messy markup limits what it can do.

How do I test if my website is agent-ready?

Pick your three most valuable journeys, then ask a browser agent such as Claude for Chrome or Comet to complete each one in plain words while you record the screen. Combine that with an accessibility scan and a keyboard-only walkthrough. Every point where the agent hesitates usually maps to a missing label, an unnamed control or an ambiguous layout.

How long does it take to make a website agent-ready?

Most marketing and ecommerce sites can reach a solid baseline in about 30 days with one developer, one designer and a business owner. Most fixes live in shared components such as buttons, forms, menus and product cards, so a single change repairs many pages. Adopting newer protocols such as WebMCP or agentic checkout takes longer and depends on your platform.

Is designing for AI agents safe?

It is safe when you keep humans in control of sensitive steps. Agents can be misled by instructions hidden in page content; Anthropic measured a 23.6% attack success rate for Claude for Chrome before mitigations and 11.2% after. Moderate user-generated content, keep explicit confirmation for payments and account changes, and validate prices and limits on the server.

Put It Into Practice

Want Help Putting These Ideas to Work in Your Business?