# llms.txt (/es/ai/llmstxt) Related: [Usa tu propio modelo](/es/ai/bring-your-own-model.md), [Menú contextual](/es/ai/contextual-menu.md), [Exportación de Markdown](/es/ai/markdown-export.md), [Servidor Admin Model Context Protocol (MCP)](/es/ai/mintlify-mcp.md), [Servidor Search Model Context Protocol (MCP)](/es/ai/model-context-protocol.md), [skill.md](/es/ai/skillmd.md) El [archivo llms.txt](https://llmstxt.org) 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](/es/deploy/authentication-setup#feature-availability). 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`. Abrir el llms.txt de este sitio. Mintlify añade encabezados HTTP a cada respuesta, incluidas las [respuestas Markdown](/es/ai/markdown-export) y las páginas 404, para que las herramientas de IA puedan descubrir tus archivos `llms.txt` y otros recursos para agentes sin conocer previamente su ubicación: * `Link`: Sigue el formato estándar del encabezado HTTP `Link` para el descubrimiento de recursos. Anuncia `llms.txt`, `llms-full.txt`, tu catálogo de API, [tarjeta del servidor MCP](/es/ai/model-context-protocol#discovery-endpoint), [tarjeta del agente](/es/ai/skillmd#agent-card) e [índice de skills del agente](/es/ai/skillmd#skills-discovery-endpoints). * `X-Llms-Txt`: Un encabezado de conveniencia para herramientas que verifican la compatibilidad con `llms.txt`. ```http title="Response headers" Link: ; rel="llms-txt", ; rel="llms-full-txt", ; rel="api-catalog", ; rel="mcp-server-card", ; rel="agent-card", ; rel="agent-skills" X-Llms-Txt: /llms.txt ``` 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 [#estructura-del-archivo-llmstxt]
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`](/es/ai/markdown-export#custom-agent-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](/es/organize/hidden-pages) 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.
## Índices divididos bajo `/_llms` [#índices-divididos-bajo-_llms]
Los archivos de índice `llms.txt` generados automáticamente no pueden superar los 100.000 caracteres. Cuando un índice supera este límite, Mintlify mantiene el archivo `llms.txt` principal como un directorio y traslada grupos de enlaces de páginas a archivos Markdown generados bajo `/_llms/`. Todas las páginas siguen siendo descubribles: la división nunca omite páginas del índice. Este límite no se aplica a `llms-full.txt`. Los enlaces a los índices generados aparecen en una sección `Indexes`. Cada enlace incluye la ruta de navegación del grupo, su número de páginas y una descripción: ```mdx > The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages. ## Indexes - [API reference (250 pages)](https://docs.example.com/_llms/api-reference.md): Endpoint documentation for the example API ``` Un índice generado puede enlazar a otros índices. Por ejemplo, `/_llms/api-reference.md` puede enlazar a `/_llms/api-reference/admin.md` cuando un grupo es demasiado grande para un solo archivo. Los agentes deben seguir estos enlaces de índice de forma recursiva hasta llegar a los enlaces de las páginas de documentación. Mintlify puede acortar las descripciones de las páginas en un índice dividido para mantener cada archivo por debajo del límite de caracteres. Los archivos generados forman parte de `llms.txt` y no necesitan existir en tu repositorio. Son independientes de `llms-full.txt`. La ruta `/_llms/` usa la misma ruta base que tu documentación: * Un sitio alojado en la raíz sirve un índice en `https://docs.example.com/_llms/api-reference.md`. * Un sitio alojado en `/docs` lo sirve en `https://example.com/docs/_llms/api-reference.md`. Si utilizas un proxy inverso o una lista de rutas permitidas, reenvía la ruta generada además de `llms.txt`. Una regla amplia `/*` ya incluye `/_llms/*`. Con reglas granulares, añade `/_llms/*` de forma explícita. Consulta [Proxy inverso](/es/deploy/reverse-proxy#routing-configuration) para obtener orientación sobre el enrutamiento. Un directorio como `/docs` en tu repositorio no establece la ruta base pública de tu sitio. Configura la ruta base en tu dashboard de Mintlify y usa el mismo prefijo en tu proxy inverso. De lo contrario, `llms.txt` puede ser accesible en el prefijo público mientras sus enlaces generados bajo `/_llms/` apuntan a otro lugar. ```mdx title="Example llms.txt" # Título del sitio > Una breve descripción del sitio de documentación. ## Documentación - [API](https://example.com/docs/api.md): Lista de endpoints y uso - [Instalar](https://example.com/docs/install.md): Pasos de configuración - [Primeros pasos](https://example.com/docs/start.md): Guía de introducción ## OpenAPI Specs - [openapi](https://example.com/docs/openapi.json) ## AsyncAPI Specs - [asyncapi](https://example.com/docs/asyncapi.yaml) ## Optional - [Community](https://example.com/community) ```
## llms-full.txt [#llms-fulltxt]
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`. Abrir el llms-full.txt de este sitio.
## Archivos personalizados [#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](https://llmstxt.org/#format) en la especificación de `llms.txt` para obtener más información sobre secciones opcionales y buenas prácticas. En los sitios que usan [autenticación](/es/deploy/authentication-setup), los archivos personalizados `llms.txt` y `llms-full.txt` respetan la autenticación. Si un archivo personalizado enlaza a alguna página que no es pública, solo los usuarios autenticados pueden acceder al archivo. Los visitantes anónimos reciben el `llms.txt` o `llms-full.txt` generado automáticamente, que solo incluye enlaces disponibles públicamente.