Publica un índice de capacidades que los agentes puedan encontrar

Proporciona un índice de capacidades legible por máquinas a nivel raíz, con metadatos en cada recurso.

Por qué

Los agentes descubren funciones mediante índices estructurados, no menús visuales. El marco canónico de AX (agentexperience.ax — Accesibilidad de agentes) establece que los agentes deben tener una ruta clara hacia el descubrimiento de capacidades sin depender de la UX visual. El protocolo A2A de Google formaliza esto con las Agent Cards en /.well-known/agent.json, ya en producción en más de 150 organizaciones. El estándar llms.txt aporta un índice complementario a nivel de contenido.

Haz

Sirve un manifiesto de capacidades en /.well-known.

No hagas

Ocultar capacidades detrás de navegación con JS.

Artefacto

Sírvelo en /.well-known/agent-capabilities.json:

{
  "name": "Acme",
  "description": "Acme helps teams do X.",
  "auth": { "type": "bearer", "scopes_url": "/docs/scopes.md" },
  "actions": [
    { "name": "search_orders", "method": "GET", "path": "/v1/orders",
      "scopes": ["orders:read"], "description": "Find a customer's orders by email or order ID." },
    { "name": "create_refund", "method": "POST", "path": "/v1/refunds",
      "scopes": ["refunds:write"], "consequential": true,
      "description": "Issue a refund. Irreversible. Supports dry_run." }
  ],
  "docs": "/llms.txt"
}