Indica a los agentes la siguiente acción, no solo un menú
Tell agents the next action, not just a menu
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
- [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
- [02]Speakeasy — Designing Agent Experience ↗
Toolability: agents need clear, structured signals about what they can do next — not pixel navigation