Expón un mapa legible por máquinas de tus recursos
Expose a machine-readable map of your resources
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
- [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