# AX-SYS-09: Expón un mapa legible por máquinas de tus recursos

> Discovery and navigation · intermediate · AX-SYS-09

Proporciona un grafo o mapa de recursos estructurado que los agentes puedan recorrer, con metadatos en cada recurso.

## Por qué

Una estructura recorrible supera al rastreo a ciegas para lograr una navegación fiable de los agentes. El marco canónico de AX (agentexperience.ax — Accesibilidad de agentes) exige que los agentes dispongan de una estructura navegable por máquinas en lugar de diseños inferidos. Estándares como `agents.json` (WildCard AI, en `/.well-known/agents.json`) y la A2A Agent Card (`/.well-known/agent.json`) formalizan esto. Un mapa de sitio para máquinas con recursos tipados y relaciones explícitas permite a los agentes recorrer la superficie de tu producto sin interpretar la UI visual.

## Haz

Publica un mapa de sitio para máquinas con tipos y relaciones.

## No hagas

Dejar la estructura implícita solo en la UI.

## Artefacto

Artefacto de proceso: publica un mapa de sitio para máquinas que incluya el tipo de recurso y las relaciones (no solo URLs), para que los agentes recorran la estructura en lugar de rastrear a ciegas.

## Fuentes

1. [agentexperience.ax — Principles of AX](https://agentexperience.ax/concepts/principles-of-ax/) — Agent Accessibility: agents must be able to navigate and discover the structure of a service without visual interpretation
2. [agents.json — WildCard AI](https://github.com/wild-card-ai/agents-json) — agents.json provides a declarative capability-specification layer at /.well-known/agents.json for structured agent traversal

---
Source: Agent Experience Principles (axprinciples.com)