Saltar al contenido
AX Principios
AX-SYS-08IntermedioBorrador

Indica a los agentes la siguiente acción, no solo un menú

Tell agents the next action, not just a menu

#all-industries

Devuelve sugerencias de siguiente acción y recursos enlazados en las respuestas, no una navegación que solo funcione de forma visual.

Por qué

Los agentes siguen enlaces y sugerencias estructuradas, no píxeles. El marco canónico de AX (agentexperience.ax — Accesibilidad de agentes) establece que los servicios no deben asumir que los agentes navegan como lo hacen los humanos. Los _links al estilo HAL en los cuerpos de respuesta dan a los agentes las siguientes acciones disponibles sin obligarlos a interpretar una barra de navegación visual ni a inferir a partir del diseño de la página.

Haz

Incluye _links con los siguientes pasos.

No hagas

Depender de una barra de navegación visual.

Artefacto

_links al estilo HAL:

{
  "order_id": "ord_123",
  "status": "pending_payment",
  "_links": {
    "self":   { "href": "/v1/orders/ord_123" },
    "pay":    { "href": "/v1/orders/ord_123/pay", "method": "POST" },
    "cancel": { "href": "/v1/orders/ord_123/cancel", "method": "POST" }
  }
}

Fuentes

  1. [01]
    agentexperience.ax — Principles of AX

    Agent Accessibility: agents interact through APIs and structured responses, not visual navigation — services must surface next actions in machine-readable form

  2. [02]
    Speakeasy — Designing Agent Experience

    Toolability: agents need clear, structured signals about what they can do next — not pixel navigation