llms.txt renvoie 404 mais llms-full.txt fonctionne
Diagnostiquez pourquoi le llms.txt de votre site renvoie une erreur 404 alors que llms-full.txt se charge, souvent dû au paramètre Don't index project.
Mintlify héberge automatiquement un fichier llms.txt à la racine de chaque site de documentation. Si https://yourdocs.com/llms.txt renvoie 404 alors que https://yourdocs.com/llms-full.txt se charge normalement, la cause la plus probable est le paramètre Don’t index project.
Lorsque vous activez Don’t index project sur la page Général de votre tableau de bord, Mintlify renvoie 404 pour llms.txt et /.well-known/llms.txt. Ce paramètre ne bloque pas llms-full.txt, qui reste disponible. Cette différence donne l’impression que l’absence de llms.txt est un bug de déploiement, alors qu’il s’agit d’un comportement configuré.
L’export Markdown de chaque page (l’URL .md) conserve également son pointeur vers /llms.txt après que vous avez activé Don’t index project, même si cette URL renvoie 404.
Pour rétablir llms.txt :
- Ouvrez la page Général de votre tableau de bord.
- Désactivez Don’t index project.
- Attendez la fin du redéploiement. Activer ou désactiver l’indexation redéploie votre site, et le changement prend effet une fois le redéploiement terminé.
Consultez Désactiver l’indexation pour l’ensemble du projet pour découvrir tout ce que ce paramètre contrôle par ailleurs.
Si Don’t index project est désactivé et que llms.txt renvoie toujours 404 :
- Authentification : sur les sites entièrement authentifiés,
llms.txtetllms-full.txtnécessitent tous deux une authentification. Les requêtes non authentifiées échouent pour les deux fichiers, pas seulement pourllms.txt. Consultez llms.txt pour savoir comment l’authentification affecte chaque fichier. - Routage du reverse proxy : si vous servez votre documentation via un reverse proxy avec une liste d’autorisation de chemins, vérifiez que le proxy transfère
/llms.txtet/.well-known/llms.txt. Consultez Reverse proxy.