Errores habituales en llms.txt
Publicado:
La mayoría de los problemas de llms.txt se reducen a un puñado de patrones. Estos son los que nuestro validador detecta con más frecuencia, junto con la solución rápida para cada uno.
1. Más de un H1
La especificación exige exactamente un # Title de nivel superior. Los encabezados # adicionales confunden la estructura. Degrada el resto a encabezados de sección ##.
2. Sin resumen en blockquote
Un blockquote de una o dos frases justo debajo del título es el contexto que un modelo lee primero. Omitirlo es el descuido más común con diferencia. Añade uno:
# Acme > Acme turns CSV files into charts. These links cover setup, the API, and pricing.
3. Secciones sin enlaces (o sin secciones)
Las secciones ## vacías no aportan nada. Cada sección debería contener una lista de viñetas en Markdown con enlaces a páginas reales. Si no tienes ninguna sección, agrupa tus páginas clave bajo encabezados como ## Docs y ## Guides.
4. Enlaces rotos
Un archivo puede estar perfectamente formateado y aun así apuntar a páginas inexistentes, lo que desperdicia el presupuesto de rastreo de un crawler y socava la confianza. Cada URL debe resolverse. Esta es la comprobación que la mayoría de las herramientas omiten; nosotros consultamos cada una.
5. Enlaces relativos o con http://
Usa URLs absolutas con https:// en todas partes. Es posible que los modelos no resuelvan rutas relativas como /docs/start, y los enlaces con http:// sin cifrar parecen poco fiables y pueden fallar en un rastreo exclusivamente por HTTPS.
6. El tipo de contenido incorrecto
Sirve el archivo como text/plain; charset=utf-8. Si tu servidor devuelve text/html (una configuración errónea habitual), algunos consumidores no lo tratarán como llms.txt.
7. Un archivo sobrecargado y sin curar
llms.txt es un índice curado, no un volcado de un sitemap. Cientos de enlaces sin descripciones entierran la señal. Conserva las mejores páginas, añade una breve : description después de cada una y mueve los enlaces secundarios a una sección ## Optional.
Detéctalos todos de una vez
Pasa tu archivo por el validador: evalúa la estructura, la accesibilidad de los enlaces y las buenas prácticas, y te indica exactamente cuáles de los puntos anteriores debes corregir. ¿Es la primera vez que usas el formato? Empieza por cómo crear un archivo llms.txt.