Skip to main content

How to verify your store is ready for AI agents

After installing the extension, use these steps to confirm that agents can discover your store and use its catalogue. The whole check takes a couple of minutes and needs no external tools.

1. Confirm the discovery surfaces respond​

Open these URLs in a browser (replace the domain with your store's base URL):

  • https://example.com/.well-known/ucp — should return the JSON merchant profile.
  • https://example.com/llms.txt — should return the agent instructions text.
  • https://example.com/agent/products.json — should return a JSON list of products.

If any of them returns 404, check that Enable Agentic Commerce and the matching surface are set to Yes on the Settings page, then clear the cache.

note

The discovery files are served with Cache-Control: public, so a CDN or full-page cache may serve them from the edge. That is expected and is good for performance.

2. Run the built-in agent test​

  • Open Marketing -> Agentic Commerce -> Agent Activity.
  • Click Test with an agent.

The extension runs a real, read-only flow against your live catalogue — search a product, fetch its details, and build a cart — and shows each step's request and response, plus a live continue_url.

  • A green PASS badge with all three steps successful means your agent surfaces are working end to end.
  • Follow the continue_url link to confirm the agent-built cart restores correctly into a browser session.
tip

This test is deterministic and is excluded from the dashboard analytics, so you can run it as often as you like without affecting your real agent metrics.

3. Watch real agent activity arrive​

Once your store is live and agents begin visiting, the Agent Activity dashboard fills in: the funnel, top agent queries, and attributed revenue. Use the range and store-view filters at the top of the page to focus the view.

If the dashboard stays empty for a long time, re-check step 1 — most often a surface is disabled or a robots.txt rule is blocking agent crawlers.