Ofrece una versión en markdown de tu contenido clave

Dale a los agentes una representación limpia en markdown de las páginas importantes mediante negociación de contenido o una opción "ver como markdown", para que gasten tokens en el significado, no en el armazón de la página.

Por qué

El markdown equivalente usa aproximadamente un 80 por ciento menos de tokens que el HTML (análisis de Cloudflare). El marco canónico de AX (agentexperience.ax, Alineación Contextual) señala específicamente la negociación de contenido para sitios de documentación como una práctica clave de AX. Biilmann documenta una adopción real: Stripe sirve páginas de documentación en markdown puro, y Netlify mide la calidad de sus guías según si un agente puede completar una función en un solo intento usando únicamente la versión en markdown.

Haz

Ofrece endpoints .md o negociación de contenido HTTP (Accept: text/markdown). Añade un <link rel="alternate" type="text/markdown"> en las páginas HTML para que los agentes puedan descubrir el gemelo en markdown. Para herramientas de desarrollo, proporciona también un archivo de contexto AGENTS.md en la raíz del repositorio.

No hagas

Obligar a los agentes a interpretar HTML completo para el contenido principal. No sirvas la misma carga útil a agentes y humanos: el formato óptimo para cada uno es distinto.

Artefacto

Devuelve markdown limpio cuando se reciba Accept: text/markdown:

GET /docs/quickstart HTTP/1.1
Accept: text/markdown

Y/o anuncia una alternativa en la página HTML:

<link rel="alternate" type="text/markdown" href="/docs/quickstart.md">