mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
1ad3a0b6e5
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
86 lines
5.8 KiB
Plaintext
86 lines
5.8 KiB
Plaintext
---
|
|
title: "llms.txt"
|
|
description: "Genera automáticamente archivos llms.txt y llms-full.txt para que herramientas de IA como ChatGPT y Claude puedan indexar y comprender tu documentación."
|
|
keywords: ["llms.txt", "indexación de LLM", "AEO", "GEO", "descubrimiento de contenido"]
|
|
boost: 3
|
|
---
|
|
|
|
import { PreviewButton } from "/snippets/previewbutton.jsx"
|
|
|
|
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.
|
|
|
|
<Note>
|
|
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. Se 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).
|
|
</Note>
|
|
|
|
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`.
|
|
|
|
<PreviewButton href="https://mintlify.com/docs/llms.txt">Abrir el llms.txt de este sitio.</PreviewButton>
|
|
|
|
Mintlify añade encabezados HTTP a cada respuesta de página para que las herramientas de IA puedan descubrir tus archivos `llms.txt` sin conocer previamente su ubicación:
|
|
|
|
- `Link: </llms.txt>; rel="llms-txt", </llms-full.txt>; rel="llms-full-txt"`: Sigue el formato estándar del encabezado HTTP `Link` para el descubrimiento de recursos.
|
|
- `X-Llms-Txt: /llms.txt`: Un encabezado de conveniencia para herramientas que verifican la compatibilidad con `llms.txt`.
|
|
|
|
<div id="llmstxt-structure">
|
|
## Estructura de llms.txt
|
|
</div>
|
|
|
|
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`.
|
|
* **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.
|
|
|
|
El archivo `llms.txt` lista tus páginas alfabéticamente en el orden en que aparecen en tu repositorio, comenzando desde el directorio raíz. 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. Las descripciones se truncan a 300 caracteres y al primer salto de línea. Para las páginas de referencia de API, la descripción también incluye la información de la especificación del campo `openapi` o `api` del frontmatter. Las páginas sin el campo `description` aparecen en el archivo `llms.txt` sin descripción.
|
|
|
|
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.
|
|
|
|
```mdx 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)
|
|
```
|
|
|
|
<div id="llms-fulltxt">
|
|
## llms-full.txt
|
|
</div>
|
|
|
|
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.
|
|
|
|
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`.
|
|
|
|
<PreviewButton href="https://mintlify.com/docs/llms-full.txt">Abrir el llms-full.txt de este sitio.</PreviewButton>
|
|
|
|
<div id="custom-files">
|
|
## Archivos personalizados
|
|
</div>
|
|
|
|
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.
|