Saltar al contenido
AX Principios
AX-SYS-09IntermedioBorrador

Expón un mapa legible por máquinas de tus recursos

Expose a machine-readable map of your resources

#all-industries

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. [01]
    agentexperience.ax — Principles of AX

    Agent Accessibility: agents must be able to navigate and discover the structure of a service without visual interpretation

  2. [02]
    agents.json — WildCard AI

    agents.json provides a declarative capability-specification layer at /.well-known/agents.json for structured agent traversal