From 75d0f29a6b6ad027423284989385f126b3e370cf Mon Sep 17 00:00:00 2001 From: "mintlify-development[bot]" <109878554+mintlify-development[bot]@users.noreply.github.com> Date: Sat, 23 May 2026 01:32:26 +0000 Subject: [PATCH] docs: clarify llms.txt and llms-full.txt behavior with authentication --- ai/llmstxt.mdx | 5 ++++- deploy/authentication-setup.mdx | 2 +- es/ai/llmstxt.mdx | 5 ++++- es/deploy/authentication-setup.mdx | 2 +- fr/ai/llmstxt.mdx | 5 ++++- fr/deploy/authentication-setup.mdx | 2 +- zh/ai/llmstxt.mdx | 5 ++++- zh/deploy/authentication-setup.mdx | 2 +- 8 files changed, 20 insertions(+), 8 deletions(-) diff --git a/ai/llmstxt.mdx b/ai/llmstxt.mdx index b17e66db43..1d416d7527 100644 --- a/ai/llmstxt.mdx +++ b/ai/llmstxt.mdx @@ -12,7 +12,10 @@ The [llms.txt file](https://llmstxt.org) is an industry standard that helps LLMs Mintlify automatically hosts an `llms.txt` file at the root of your project that lists all available pages in your documentation. This file is always up to date and requires zero maintenance. You can optionally add a custom `llms.txt` file to the root of your project. - If your site requires authentication, `llms.txt` and `llms-full.txt` also require authentication to view. LLMs and AI tools that cannot authenticate into your site cannot access these files. The files exclude pages that belong to [user groups](/deploy/authentication-setup#control-access-with-groups). + If your site uses [authentication](/deploy/authentication-setup), the behavior of `llms.txt` and `llms-full.txt` depends on whether any of your pages are public: + + - **Fully authenticated sites** (no public pages): `/llms.txt` and `/llms-full.txt` return `404` for unauthenticated requests. Authenticated users can still retrieve a version of `llms.txt` that respects their permissions. + - **Partially authenticated sites** (some pages marked `public: true`): `/llms.txt` and `/llms-full.txt` are served without authentication, but contain only public pages. Pages restricted to [user groups](/deploy/authentication-setup#control-access-with-groups), hidden pages, and OpenAPI or AsyncAPI specification links are excluded. For more information on how authentication affects AI features, see [Feature availability](/deploy/authentication-setup#feature-availability). diff --git a/deploy/authentication-setup.mdx b/deploy/authentication-setup.mdx index fe9b86142a..37e5862591 100644 --- a/deploy/authentication-setup.mdx +++ b/deploy/authentication-setup.mdx @@ -464,7 +464,7 @@ Some features behave differently or are unavailable when you enable authenticati | Feature | Public | Fully authenticated (all pages protected) | Partially authenticated (some public pages) | | :------ | :---------- | :---------------------------------- | :-------------------------------- | -| [llms.txt and llms-full.txt](/ai/llmstxt) | Full support | Available behind authentication, so AI tools may not be able to access the files | Available behind authentication, so AI tools may not be able to access the files | +| [llms.txt and llms-full.txt](/ai/llmstxt) | Full support | `/llms.txt` and `/llms-full.txt` return `404` for unauthenticated requests; an authenticated version of `llms.txt` is available to logged-in users | Served publicly with only public pages, excluding pages in user groups and OpenAPI or AsyncAPI specification links | | [MCP server](/ai/model-context-protocol) | Full support | Requires authentication to connect | Available without authentication for public pages and with authentication for protected pages | | [Markdown export](/ai/markdown-export) | Full support | Full support, respects user groups | Full support, respects user groups | | [PDF export](/optimize/pdf-exports) | Full support | Not supported | Not supported | diff --git a/es/ai/llmstxt.mdx b/es/ai/llmstxt.mdx index 3651bb2c4b..24afa4de50 100644 --- a/es/ai/llmstxt.mdx +++ b/es/ai/llmstxt.mdx @@ -12,7 +12,10 @@ El [archivo llms.txt](https://llmstxt.org) es un estándar del sector que ayuda 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. - Si tu sitio requiere autenticación, `llms.txt` y `llms-full.txt` también requieren autenticación para poder verse. Los LLM y las herramientas de IA que no puedan autenticarse en tu sitio no pueden acceder a estos archivos. Los archivos excluyen las páginas que pertenecen a [grupos de usuarios](/es/deploy/authentication-setup#control-access-with-groups). + Si tu sitio usa [autenticación](/es/deploy/authentication-setup), el comportamiento de `llms.txt` y `llms-full.txt` depende de si tienes páginas públicas: + + - **Sitios totalmente autenticados** (sin páginas públicas): `/llms.txt` y `/llms-full.txt` devuelven `404` para las solicitudes sin autenticar. Los usuarios autenticados pueden obtener una versión de `llms.txt` que respeta sus permisos. + - **Sitios parcialmente autenticados** (algunas páginas con `public: true`): `/llms.txt` y `/llms-full.txt` se sirven sin autenticación, pero solo contienen las páginas públicas. Se excluyen las páginas restringidas a [grupos de usuarios](/es/deploy/authentication-setup#control-access-with-groups), las páginas ocultas y los enlaces a especificaciones OpenAPI o AsyncAPI. Para obtener más información sobre cómo la autenticación afecta las funciones de IA, consulta [Disponibilidad de funciones](/es/deploy/authentication-setup#feature-availability). diff --git a/es/deploy/authentication-setup.mdx b/es/deploy/authentication-setup.mdx index 8a7799fef1..f88aca5956 100644 --- a/es/deploy/authentication-setup.mdx +++ b/es/deploy/authentication-setup.mdx @@ -496,7 +496,7 @@ Algunas funciones se comportan de manera diferente o no están disponibles cuand | Función | Público | Totalmente autenticado (todas las páginas protegidas) | Parcialmente autenticado (algunas páginas públicas) | | :----------------------------------------------------------- | :---------------------- | :--------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------- | -| [llms.txt and llms-full.txt](/es/ai/llmstxt) | Compatibilidad completa | Disponible tras autenticación, por lo que es posible que las herramientas de IA no puedan acceder a los archivos | Disponible tras autenticación, por lo que es posible que las herramientas de IA no puedan acceder a los archivos | +| [llms.txt and llms-full.txt](/es/ai/llmstxt) | Compatibilidad completa | `/llms.txt` y `/llms-full.txt` devuelven `404` a solicitudes sin autenticar; los usuarios autenticados pueden obtener una versión de `llms.txt` | Se sirven públicamente solo con páginas públicas, sin las páginas en grupos de usuarios ni los enlaces a especificaciones OpenAPI o AsyncAPI | | [Servidor MCP](/es/ai/model-context-protocol) | Compatibilidad completa | Requiere autenticación para conectarse | Disponible sin autenticación para páginas públicas y con autenticación para páginas protegidas | | [Exportación a Markdown](/es/ai/markdown-export) | Compatibilidad completa | Compatibilidad completa, respeta los grupos de usuarios | Compatibilidad completa, respeta los grupos de usuarios | | [Exportación a PDF](/es/optimize/pdf-exports) | Compatibilidad completa | No compatible | No compatible | diff --git a/fr/ai/llmstxt.mdx b/fr/ai/llmstxt.mdx index 966b22071a..f7e85aecbd 100644 --- a/fr/ai/llmstxt.mdx +++ b/fr/ai/llmstxt.mdx @@ -12,7 +12,10 @@ Le [fichier llms.txt](https://llmstxt.org) est une norme du secteur qui aide les Mintlify héberge automatiquement, à la racine de votre projet, un fichier `llms.txt` qui répertorie toutes les pages disponibles de votre documentation. Ce fichier est toujours à jour et ne nécessite aucun entretien. Vous pouvez également ajouter un fichier `llms.txt` personnalisé à la racine de votre projet. - Si votre site nécessite une authentification, `llms.txt` et `llms-full.txt` sont également soumis à une authentification pour être consultés. Les LLM et les outils d'IA qui ne peuvent pas s'authentifier sur votre site ne peuvent pas accéder à ces fichiers. Les fichiers excluent les pages qui appartiennent à des [groupes d'utilisateurs](/fr/deploy/authentication-setup#control-access-with-groups). + Si votre site utilise [l'authentification](/fr/deploy/authentication-setup), le comportement de `llms.txt` et `llms-full.txt` dépend de la présence de pages publiques : + + - **Sites entièrement authentifiés** (aucune page publique) : `/llms.txt` et `/llms-full.txt` renvoient un `404` pour les requêtes non authentifiées. Les utilisateurs authentifiés peuvent toujours récupérer une version de `llms.txt` qui respecte leurs autorisations. + - **Sites partiellement authentifiés** (certaines pages marquées `public: true`) : `/llms.txt` et `/llms-full.txt` sont servis sans authentification, mais ne contiennent que les pages publiques. Les pages limitées à des [groupes d'utilisateurs](/fr/deploy/authentication-setup#control-access-with-groups), les pages masquées ainsi que les liens vers les spécifications OpenAPI ou AsyncAPI sont exclus. Pour plus d'informations sur l'impact de l'authentification sur les fonctionnalités d'IA, voir [Disponibilité des fonctionnalités](/fr/deploy/authentication-setup#feature-availability). diff --git a/fr/deploy/authentication-setup.mdx b/fr/deploy/authentication-setup.mdx index ed46445ae2..5bdc620e1d 100644 --- a/fr/deploy/authentication-setup.mdx +++ b/fr/deploy/authentication-setup.mdx @@ -496,7 +496,7 @@ Certaines fonctionnalités se comportent différemment ou ne sont pas disponible | Fonctionnalité | Public | Entièrement authentifié (toutes les pages protégées) | Partiellement authentifié (certaines pages publiques) | | :------------------------------------------------------- | :----------------------- | :--------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------- | -| [llms.txt and llms-full.txt](/fr/ai/llmstxt) | Prise en charge complète | Disponible derrière l’authentification, les outils d’IA peuvent donc ne pas avoir accès aux fichiers | Disponible derrière l’authentification, les outils d’IA peuvent donc ne pas avoir accès aux fichiers | +| [llms.txt and llms-full.txt](/fr/ai/llmstxt) | Prise en charge complète | `/llms.txt` et `/llms-full.txt` renvoient `404` aux requêtes non authentifiées ; les utilisateurs authentifiés peuvent obtenir une version de `llms.txt` | Servis publiquement avec uniquement les pages publiques, sans les pages dans des groupes d'utilisateurs ni les liens vers les spécifications OpenAPI ou AsyncAPI | | [MCP server](/fr/ai/model-context-protocol) | Prise en charge complète | Nécessite une authentification pour se connecter | Disponible sans authentification pour les pages publiques et avec authentification pour les pages protégées | | [Markdown export](/fr/ai/markdown-export) | Prise en charge complète | Prise en charge complète, respecte les groupes d’utilisateurs | Prise en charge complète, respecte les groupes d’utilisateurs | | [Export PDF](/fr/optimize/pdf-exports) | Prise en charge complète | Non pris en charge | Non pris en charge | diff --git a/zh/ai/llmstxt.mdx b/zh/ai/llmstxt.mdx index 0c249058d4..6a5a3350ca 100644 --- a/zh/ai/llmstxt.mdx +++ b/zh/ai/llmstxt.mdx @@ -12,7 +12,10 @@ import { PreviewButton } from "/snippets/previewbutton.jsx" Mintlify 会在项目根目录自动托管一个 `llms.txt` 文件，列出文档中的所有可用页面。该文件始终保持最新且无需维护。你也可以在项目根目录添加自定义的 `llms.txt` 文件。 - 如果你的站点需要认证，查看 `llms.txt` 和 `llms-full.txt` 也同样需要认证。无法通过你站点认证的 LLM 和 AI 工具将无法访问这些文件。这些文件会排除属于[用户分组](/zh/deploy/authentication-setup#control-access-with-groups)的页面。 + 如果你的站点启用了[认证](/zh/deploy/authentication-setup)，`llms.txt` 和 `llms-full.txt` 的行为取决于是否存在公开页面： + + - **完全认证的站点**（没有公开页面）：未认证的请求访问 `/llms.txt` 和 `/llms-full.txt` 时会返回 `404`。已认证的用户仍可以获取与其权限对应的 `llms.txt` 版本。 + - **部分认证的站点**（部分页面设置了 `public: true`）：`/llms.txt` 和 `/llms-full.txt` 无需认证即可访问，但只会包含公开页面。受[用户分组](/zh/deploy/authentication-setup#control-access-with-groups)限制的页面、隐藏页面，以及 OpenAPI 或 AsyncAPI 规范链接都会被排除。 有关认证如何影响 AI 功能的更多信息，请参阅[功能可用性](/zh/deploy/authentication-setup#feature-availability)。 diff --git a/zh/deploy/authentication-setup.mdx b/zh/deploy/authentication-setup.mdx index cc871cfcf7..c868d6e1cc 100644 --- a/zh/deploy/authentication-setup.mdx +++ b/zh/deploy/authentication-setup.mdx @@ -496,7 +496,7 @@ groups: ["admin"] | 功能 | 公开 | 完全认证 (所有页面受保护) | 部分认证 (部分页面公开) | | :------------------------------------------------------- | :--- | :----------------------------- | :----------------------------- | -| [llms.txt 和 llms-full.txt](/zh/ai/llmstxt) | 完全支持 | 需要通过认证后才能访问，因此 AI 工具可能无法访问这些文件 | 需要通过认证后才能访问，因此 AI 工具可能无法访问这些文件 | +| [llms.txt 和 llms-full.txt](/zh/ai/llmstxt) | 完全支持 | 未认证请求访问 `/llms.txt` 和 `/llms-full.txt` 时返回 `404`；已认证用户可以获取相应版本的 `llms.txt` | 公开提供，但仅包含公开页面，不包含位于用户分组中的页面以及 OpenAPI 或 AsyncAPI 规范链接 | | [MCP 服务器](/zh/ai/model-context-protocol) | 完全支持 | 连接时需要认证 | 公开页面无需认证即可使用，受保护页面则需要认证 | | [Markdown 导出](/zh/ai/markdown-export) | 完全支持 | 完全支持，尊重用户分组 | 完全支持，尊重用户分组 | | [PDF 导出](/zh/optimize/pdf-exports) | 完全支持 | 不支持 | 不支持 |