Expose a machine-readable map of your resources
Expón un mapa legible por máquinas de tus recursos
Provide a structured resource graph or sitemap agents can traverse, with metadata on each resource.
Why
Traversable structure beats blind crawling for reliable agent navigation. The canonical AX framework (agentexperience.ax — Agent Accessibility) requires that agents have machine-navigable structure rather than inferred layouts. Standards including agents.json (WildCard AI, at /.well-known/agents.json) and the A2A Agent Card (/.well-known/agent.json) formalise this. A machine sitemap with typed resources and explicit relations lets agents traverse your product surface without parsing visual UI.
Do
Publish a machine sitemap with types and relations.
Don't
Leave structure implicit in the UI only.
Artifact
Process artifact: publish a machine sitemap that includes resource type and relations (not just URLs), so agents traverse structure instead of crawling blind.
Citations
- [01]agentexperience.ax — Principles of AX ↗
Agent Accessibility: agents must be able to navigate and discover the structure of a service without visual interpretation
- [02]agents.json — WildCard AI ↗
agents.json provides a declarative capability-specification layer at /.well-known/agents.json for structured agent traversal