Skip to main content
El archivo llms.txt es un estándar del sector que ayuda a los LLM a indexar contenido de forma más eficiente, de manera similar a como un sitemap ayuda a los motores de búsqueda. Las herramientas de IA pueden usar este archivo para entender la estructura de tu documentación y encontrar contenido relevante para las consultas de los usuarios. Mintlify aloja automáticamente un archivo llms.txt en la raíz de tu proyecto que lista todas las páginas disponibles de tu documentación. Este archivo siempre está actualizado y no requiere mantenimiento. Opcionalmente, puedes añadir un llms.txt personalizado en la raíz de tu proyecto.
La autenticación afecta a llms.txt y llms-full.txt de forma distinta según la configuración de tu sitio:
  • Sitios totalmente autenticados: Ambos archivos requieren autenticación. Las herramientas de IA que no puedan autenticarse no podrán acceder a ellos.
  • Sitios parcialmente autenticados: Ambos archivos son de acceso público, pero solo listan las páginas públicas y excluyen las páginas restringidas a grupos de usuarios.
Para obtener más información sobre cómo la autenticación afecta a las funciones de IA, consulta Disponibilidad de funciones.
Consulta tu llms.txt añadiendo /llms.txt a la URL de tu sitio de documentación. Mintlify también aloja el archivo en /.well-known/llms.txt para garantizar la compatibilidad con herramientas que siguen la convención .well-known. Mintlify añade encabezados HTTP a cada respuesta de página para que las herramientas de IA puedan descubrir tus archivos llms.txt y otros recursos para agentes sin conocer previamente su ubicación:
Response headers
Los sitios que usan autenticación también anuncian los metadatos de su recurso protegido por OAuth con rel="oauth-protected-resource". Si sirves tu documentación bajo una ruta base, todas las rutas anunciadas incluyen ese prefijo.

​
Estructura del archivo llms.txt

Un archivo llms.txt es un archivo Markdown sin formato que contiene:
  • Título del sitio como encabezado H1.
  • Descripción del sitio como una cita debajo del título, obtenida del campo description en tu configuración docs.json.
  • Instrucciones personalizadas para agentes como un bloque Agent Instructions después de la descripción, si estableces markdown.instructions en tu docs.json.
  • Secciones de contenido estructuradas con enlaces y una descripción de cada página de tu documentación.
  • Enlaces a especificaciones de API a tus especificaciones OpenAPI y AsyncAPI, si tu documentación las incluye.
  • Enlaces externos en una sección Optional, para cualquier URL absoluta de tu navegación.
El archivo llms.txt lista tus páginas en el orden en que aparecen en la navegación de tu docs.json. Las páginas que no están en tu navegación pero se indexan porque estableciste seo.indexing: "all" aparecen al final, en orden alfabético. Los enlaces de las páginas en el archivo llms.txt incluyen la extensión .md para que las herramientas de IA puedan obtener directamente la versión Markdown de cada página. La descripción de cada página proviene del campo description en su frontmatter. Mintlify usa el primer párrafo de la descripción y lo trunca a 300 caracteres. Las páginas sin el campo description aparecen en el archivo llms.txt sin descripción. Tanto llms.txt como llms-full.txt listan las páginas de tu idioma predeterminado y de tu versión predeterminada. Excluyen las páginas ocultas y las páginas con noindex: true en su frontmatter, a menos que establezcas seo.indexing: "all" en tu docs.json. Este enfoque estructurado permite a los LLM procesar tu documentación de forma eficiente a un alto nivel y localizar contenido relevante para las consultas de los usuarios, mejorando la precisión y la velocidad de las búsquedas de documentación asistidas por IA.
Los archivos de índice llms.txt generados automáticamente no pueden superar los 100.000 caracteres. Para sitios de documentación grandes, Mintlify divide el índice en archivos enlazados bajo /_llms/ para que los agentes puedan descubrir cada página sin cargar un único archivo demasiado grande. Este límite no se aplica a llms-full.txt.
Si utilizas un proxy inverso o mantienes una lista de rutas permitidas, reenvía /_llms/* además de /llms.txt para que los agentes puedan seguir los enlaces del índice generado. Para documentación alojada en una ruta base, reenvía <base-path>/_llms/* en su lugar. Los dominios personalizados gestionados por Mintlify no requieren configuración adicional. Consulta Proxy inverso para obtener orientación sobre el enrutamiento.
Example llms.txt

​
llms-full.txt

El archivo llms-full.txt reúne todo tu sitio de documentación en un único archivo como contexto para herramientas de IA y la indexación de los LLM. Cada página aparece como su título, URL de origen, descripción y contenido Markdown completo. Mintlify aloja automáticamente un archivo llms-full.txt en la raíz de tu proyecto. Visualiza tu llms-full.txt agregando /llms-full.txt a la URL de tu sitio de documentación. Mintlify también aloja el archivo en /.well-known/llms-full.txt para garantizar la compatibilidad con herramientas que siguen la convención .well-known.

​
Archivos personalizados

Para agregar un archivo personalizado llms.txt o llms-full.txt, crea un archivo llms.txt o llms-full.txt en la raíz de tu proyecto. Agregar un archivo personalizado reemplazará el archivo generado automáticamente con el mismo nombre. Si eliminas un archivo personalizado, Mintlify restaura el archivo generado automáticamente. Tu archivo personalizado llms.txt o llms-full.txt debe incluir el título del sitio como encabezado H1. El resto del contenido es opcional. Consulta Format en la especificación de llms.txt para obtener más información sobre secciones opcionales y buenas prácticas.

Temas relacionados

GlosarioReferencia de comandos de la CLI de Mintlifyskill.md